Ir al contenido

Conectar

Hay dos formas de conectar, según el cliente. Claude.ai (web) usa OAuth 2.1: te registras 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.

Todos los clientes apuntan a la misma URL:

https://api.overtaker.online/mcp

No necesitas ninguna clave: te autenticas con tu cuenta del panel de Overtaker.

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

  2. Elige Agregar conector personalizado (Add custom connector).

  3. En URL pega el endpoint:

    https://api.overtaker.online/mcp

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

  4. Guarda. Claude abre la pantalla de consentimiento de Overtaker. Inicia sesión con tu email y contraseña del panel y elige el nivel de acceso:

    • Solo lectura — consultar el negocio.
    • Completo — consultar y configurar (Prompt Builder, KB, reglas…).
  5. Haz clic en Aprobar. Vuelves a Claude, ya conectado. Las herramientas quedan disponibles en la conversación.

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

Sección titulada «Conectar sin OAuth — API key (Claude Desktop, automatización)»

Si no quieres o no puedes usar OAuth —Claude Desktop, un cliente MCP headless, una automatización, o una cuenta con 2FA (que el consent rechaza)— conectas 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. Genera la API key MCP (rol OWNER o MANAGER). Eliges el nivel de acceso al crearla: read (solo lectura) o full (lectura y escritura). La raw key (sk_live_…) se muestra una sola vez — cópiala y guárdala.

    En el panel del tenant → sección API Keys: crea una key de tipo MCP y elige el nivel de acceso. Copia la sk_live_… que aparece una sola vez.

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

    {
    "mcpServers": {
    "overtaker": {
    "type": "http",
    "url": "https://api.overtaker.online/mcp",
    "headers": {
    "Authorization": "Bearer sk_live_xxxxxxxxxxxxxxxx"
    }
    }
    }
    }
  3. Reinicia el cliente. Debería listar las herramientas de tu tenant.

Una vez conectado, pídele 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.

“Usa estado_conexion y muéstrame el resumen del negocio de los últimos 7 días.”

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