Integraciones API y agentes de IA

Una clave de API permite que tu propio software (un sistema de RR. HH., un script de informes o un agente de IA) trabaje con los datos de tu organización sin que una persona inicie sesión. La clave pertenece a la organización, no a ti, así que sigue funcionando si cambias de trabajo, y puedes revocarla con un clic.

¿Quién puede hacerlo?

Disponible para los administradores de la organización. Abre Configuración de la organización → Integraciones. Los desarrolladores crean sus claves en Aplicaciones → Integraciones.

Ver tus claves

La tarjeta Claves de API muestra todas las claves de la organización con su Alcance, sus Roles, la fecha de caducidad, su Último uso y su Estado (Activa, Revocada o Caducada). Bajo el nombre solo ves el principio de la clave, nunca el valor completo.

Tarjeta Claves de API con claves activas y revocadas

Crear una clave

1Abre Configuración de la organización → Integraciones.
2Haz clic en Crear clave.
3En Nombre, ponle el nombre de la herramienta que la va a usar: es el nombre que verás en el registro de solicitudes.
4En Roles, elige qué recibe la clave: Administrador, Analista o Administrador de dispositivos. Una clave nunca puede más que tú, así que solo ves los roles que tienes tú.
5En Alcance, elige Solo lectura o Lectura y escritura.
6En Validez, elige 30, 90 o 365 días.
7Haz clic en Crear clave.

Ventana Crear clave de API con el nombre, los roles, el alcance y la validez

Mostramos la clave una sola vez, justo después de crearla. Cópiala en tu gestor de contraseñas o en tu almacén de secretos antes de cerrar la ventana. Si la pierdes, rota la clave y usa la nueva.

Trata la clave como una contraseña

Quien la tenga puede leer los datos de tu organización dentro de los roles que concediste. No la pegues nunca en un chat, en una incidencia ni en un repositorio público.

Cómo es la clave

Todas las claves empiezan por sk_live_, por ejemplo sk_live_7Hq2mZk1_…. El panel solo guarda su hash y el prefijo visible; por eso no podemos volver a mostrarte la clave completa.

Envíala en la cabecera Authorization:

Authorization: Bearer sk_live_7Hq2mZk1_…

Roles y alcance

Los Roles deciden qué datos ve la clave: exactamente las mismas reglas que para una persona con ese rol.
El Alcance decide qué puede hacer: una clave de solo lectura recibe 403 en cada escritura.
La clave solo funciona dentro de la organización en la que se creó. No puede acceder en absoluto al panel (api/web).

Caducidad y rotación

Una clave deja de funcionar en el momento en que caduca. Las dos acciones siguientes están en el menú al final de la fila de una clave activa.

Rotar te da un nuevo valor de clave mientras la antigua sigue funcionando 24 horas más: tiempo suficiente para volver a desplegar tu herramienta sin interrupciones.
Revocar anula la clave de inmediato; cualquier llamada con ella se rechaza en menos de un minuto. No se puede deshacer.

Menú de la fila de una clave de API con Rotar y Revocar

Límites

10 claves activas por organización y por contexto.
120 solicitudes por minuto por clave. Por encima, la API responde 429 con una cabecera Retry-After.

El registro de solicitudes

La tarjeta Registro de solicitudes de la misma página muestra cada llamada hecha con una clave de esta organización: la clave, el método y la ruta, el estado de la respuesta, cuánto tardó y si llegó por REST o por MCP. Fíltrala por Clave o por Estado cuando depures una integración: un 429 significa que la clave alcanzó el límite de solicitudes. Las entradas se conservan 90 días.

Registro de solicitudes con los filtros de clave y estado

La referencia de la API

La lista completa de endpoints y el formato de las solicitudes y respuestas están en la referencia de la API: api.skillsive.com/core/docs/v1. El botón Documentación de la API de la página Integraciones abre la misma página.

Conectar un agente de IA (MCP)

La misma clave te autentica en el servidor MCP de Skillsive, en https://api.skillsive.com/core/mcp, que expone la API como herramientas que un agente puede llamar directamente.

Claude Code: un solo comando en tu terminal:

claude mcp add --transport http skillsive https://api.skillsive.com/core/mcp --header "Authorization: Bearer sk_live_…"

Cursor: añade el servidor a ~/.cursor/mcp.json (o a .cursor/mcp.json en el proyecto):

{
	"mcpServers": {
		"skillsive": {
			"type": "http",
			"url": "https://api.skillsive.com/core/mcp",
			"headers": { "Authorization": "Bearer sk_live_…" }
		}
	}
}

Conectores de Claude.ai y ChatGPT

Los conectores de las aplicaciones web de Claude y ChatGPT requieren inicio de sesión con OAuth, que Skillsive todavía no admite. Los agentes que se autentican con una cabecera (Claude Code, Cursor y tus propios agentes) ya funcionan.

FAQ

Cerré la ventana antes de copiar la clave. ¿Puedo volver a verla?

No, solo guardamos su hash. Abre el menú de la clave, haz clic en Rotar y copia el nuevo valor.

¿Qué rol debe tener una herramienta de RR. HH. o de informes?

Administrador. Para leer participantes, finalizaciones de cursos y certificados hace falta una clave de administrador: una clave de Analista solo puede leer los datos de la propia organización. Para que la clave sea inofensiva, dale el alcance Solo lectura: puede leer, pero nunca modificar datos.

¿Deja de funcionar una clave cuando se va la persona que la creó?

No. La clave pertenece a la organización. Revócala tú cuando la herramienta ya no se use.