Integraciones de 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 nadie inicie sesión. La clave pertenece a la organización, no a ti: sigue funcionando si cambias de puesto y se revoca con un clic.

Crear una clave

1. 1Abre Organización → Ajustes → Integraciones. Los desarrolladores crean sus claves en Aplicaciones → Integraciones.
2. 2Pulsa Crear clave.
3. 3Nómbrala según la herramienta que la usará: ese nombre aparecerá en el registro de solicitudes.
4. 4Elige los roles: Administrador, Analista o Administrador de dispositivos. Una clave nunca puede más que tú, así que solo ves tus propios roles.
5. 5Elige el alcance: Solo lectura o Lectura y escritura.
6. 6Elige la validez: 30, 90 o 365 días.

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

Cómo es la clave

Toda clave empieza por sk_live_, por ejemplo sk_live_7Hq2mZk1_…. El panel guarda solo 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, con 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 funciona únicamente en la organización donde se creó. Al panel (api/web) no accede en absoluto.

Validez y rotación

La clave deja de funcionar al caducar. Rotar entrega un valor nuevo mientras el anterior sigue válido 24 horas: tiempo suficiente para actualizar tu herramienta sin cortes. Revocar termina con la clave de inmediato: cualquier llamada se rechaza en menos de un minuto.

Límites

• 10 claves activas por organización y contexto.
• 120 solicitudes por minuto por clave. Por encima, la API responde 429 con la 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 y la duración. Fíltralo por clave o por estado cuando depures una integración. Las entradas se conservan 90 días.

La referencia de la API

La lista completa de endpoints y el formato de peticiones y respuestas están en el documento OpenAPI público: api.skillsive.com/core/swagger. Selecciona el documento public en la parte superior.

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 el agente llama directamente.

Claude Code — un comando en la 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 .cursor/mcp.json en el proyecto):

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