Conectar con clave de API

Manual de Agentes de IA · capítulo 3 de 7

Use este camino para agentes desarrollados por su equipo, automatizaciones y herramientas de línea de comandos.

1. En Sistema › Claves API, haga clic en Nueva clave.
2. Dele un nombre que identifique al agente, por ejemplo “Agente de guardia”.
3. En Alcances, marque mcp y read. Marque también write solo si el agente va a abrir tickets o registrar seguimientos.
4. Defina el Límite/hora y, si lo desea, la Vencimiento.
5. Haga clic en Crear clave y copie la clave: se muestra una sola vez.

Regla del sistema

El alcance mcp debe marcarse a propósito. Una clave sin él no habla con agentes, aunque sea de administrador — así, una clave creada para otra integración nunca se convierte en puerta de entrada para un agente.

La clave actúa como el usuario que la creó. Para un agente de consulta, lo ideal es crear la clave con un usuario que tenga solo los permisos de lectura necesarios.

Informar la clave en el agente

El agente envía la clave en el encabezado Authorization, como Bearer seguido de la clave. En Claude Code, por ejemplo:

claude mcp add --transport http h2o https://DIRECCION-DEL-SERVIDOR/api/v1/mcp --header "Authorization: Bearer SU_CLAVE"

En herramientas que piden el tipo de autenticación, elija clave de API en encabezado, con el encabezado Authorization y el valor Bearer seguido de la clave. Una llamada directa al servidor tiene esta forma:

POST /api/v1/mcp
Authorization: Bearer SU_CLAVE
Accept: application/json, text/event-stream
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}

Atención

La clave solo se acepta en el encabezado. El servidor rechaza la clave en la URL, la sesión de usuario del web y las solicitudes que vienen de páginas abiertas en el navegador.