Conectar

Hay dos formas de conectar, según el cliente. Claude.ai (web) usa OAuth 2.1: te logueás con tu cuenta de Overtaker en una pantalla de consentimiento, sin manejar claves. Claude Desktop y los clientes programáticos usan una API key MCP (sk_live_*). Ambas resuelven tu tenant a partir de la credencial.

Endpoint

Todos los clientes apuntan a la misma URL:

https://api.overtaker.online/mcp

Sin barra final

Poné exactamente https://api.overtaker.online/mcp — sin / al final y sin rutas extra. El resto (metadata OAuth, authorize, token) lo descubre el cliente solo a partir de ese endpoint.

Claude.ai (web) — OAuth 2.1

No necesitás ninguna clave: te autenticás con tu cuenta del panel de Overtaker.

1. En Claude.ai, andá a Configuración → Conectores.

2. Elegí Agregar conector personalizado (Add custom connector).

3. En URL pegá el endpoint:

   https://api.overtaker.online/mcp

   Dejá Client ID y Client Secret vacíos — el cliente se registra solo (Dynamic Client Registration).

4. Guardá. Claude abre la pantalla de consentimiento de Overtaker. Iniciá sesión con tu email y contraseña del panel y elegí el nivel de acceso:

   • Solo lectura — consultar el negocio.
   • Completo — consultar y configurar (Prompt Builder, KB, reglas…).

5. Hacé clic en Aprobar. Volvés a Claude, ya conectado. Las herramientas quedan disponibles en la conversación.

Cuentas con 2FA

Si tu cuenta de Overtaker tiene verificación en dos pasos, la pantalla de consent la rechaza a propósito (no debilitamos tu 2FA con un login de solo contraseña). En ese caso conectá con una API key MCP desde Claude Desktop (abajo).

Conectar sin OAuth — API key (Claude Desktop, automatización)

Si no querés o no podés usar OAuth —Claude Desktop, un cliente MCP headless, una automatización, o una cuenta con 2FA (que el consent rechaza)— conectás con una API key MCP (sk_live_*, kind=mcp) como Bearer token. No hay pantalla de login ni consent: la key ya resuelve tu tenant y su nivel de acceso.

1. Generá la API key MCP (rol OWNER o MANAGER). Elegís el nivel de acceso al crearla: read (solo lectura) o full (lectura y escritura). La raw key (sk_live_…) se muestra una sola vez — copiala y guardala.

   Desde el panel

   En el panel del tenant → sección API Keys: creá una key de tipo MCP y elegí el nivel de acceso. Copiá la sk_live_… que aparece una sola vez.

   Vía API

   Con tu sesión del panel (Bearer JWT), llamá al endpoint de API Keys:

   curl -s -X POST https://api.overtaker.online/api/v1/api-keys \
     -H "Authorization: Bearer <TU_JWT_DEL_PANEL>" \
     -H "Content-Type: application/json" \
     -d '{"name":"Claude Desktop","kind":"mcp","access":"full"}'
   # → la raw key (sk_live_…) viene UNA sola vez en la respuesta

   kind debe ser "mcp"; access es "full" (configurar) o "read" (solo consultar).

2. Configurá el servidor MCP en tu cliente apuntando al endpoint con el header Authorization: Bearer sk_live_....

   Claude Desktop (config)

   {
     "mcpServers": {
       "overtaker": {
         "type": "http",
         "url": "https://api.overtaker.online/mcp",
         "headers": {
           "Authorization": "Bearer sk_live_xxxxxxxxxxxxxxxx"
         }
       }
     }
   }

   curl (probar a mano)

   curl -s https://api.overtaker.online/mcp \
     -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json, text/event-stream" \
     -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

3. Reiniciá el cliente. Debería listar las herramientas de tu tenant.

La API key MCP es distinta de la del Canal API

Cada tenant tiene cupos independientes: hasta 3 keys channel + 3 keys mcp. Una key mcp no sirve para el Canal API y viceversa — es separación de poderes: la del Canal API mueve mensajes; la MCP configura el tenant.

Probar la conexión

Una vez conectado, pedile a Claude que use la herramienta estado_conexion (o resumen_negocio). Debería devolver el nombre de tu negocio y un resumen — señal de que la credencial resolvió tu tenant correctamente.

“Usá estado_conexion y mostrame el resumen del negocio de los últimos 7 días.”

Si algo falla, revisá Autenticación — el 99% de los problemas son la URL con barra final, la key del kind equivocado, o el nivel de acceso.