Antes de conectar necesitas dos cosas: que la organización tenga el MCP activo en Ajustes → Agentes de IA y la dirección del servidor, que puedes copiar de esa misma pantalla:
https://app.leaxio.com/api/mcp
No se usan claves ni cabeceras especiales. El cliente descubre cómo autenticarse y abre el navegador para que inicies sesión en Leaxio y apruebes el acceso.
Claude
Verificado el 30 de octubre de 2026 con Claude.
- Abre Ajustes → Conectores.
- Añade un conector personalizado.
- Pega la dirección
https://app.leaxio.com/api/mcp. - Pulsa Conectar. Se abre Leaxio: inicia sesión si hace falta y aprueba el acceso.
- Vuelve a Claude y haz una pregunta de prueba.
Si Claude muestra «La autorización con Leaxio falló» o se queda en «inició sesión pero no conecta», cierra la conversación, elimina el conector y vuelve a añadirlo. Si sigue igual, escribe a soporte con la hora exacta del intento.
ChatGPT
- Abre los ajustes de Conectores.
- Activa el modo desarrollador si tu cuenta lo requiere.
- Añade un conector personalizado con la dirección del servidor.
- Inicia sesión en Leaxio y aprueba el acceso.
ChatGPT cambia esta pantalla con frecuencia. Si tu plan o tu cuenta no permiten conectores personalizados, la opción no aparecerá: no es un problema de Leaxio.
Gemini
Esto aplica a Gemini CLI. Abre ~/.gemini/settings.json y agrega el servidor (Gemini usa httpUrl para MCP por HTTP):
{
"mcpServers": {
"leaxio": {
"httpUrl": "https://app.leaxio.com/api/mcp"
}
}
}
Guarda el archivo y abre Gemini CLI. Te llevará a Leaxio para que inicies sesión y apruebes. Si no se abre el navegador, escribe /mcp auth leaxio dentro de Gemini CLI.
Otros clientes
Sirve cualquier app compatible con MCP, como Cursor, VS Code o MCP Inspector. Añade un servidor remoto con transporte HTTP y la dirección del servidor. Si tu app usa un archivo de configuración, suele aceptar este formato:
{
"mcpServers": {
"leaxio": {
"url": "https://app.leaxio.com/api/mcp"
}
}
}
Si tu gestor de servidores pide un formulario con transporte, elige HTTP (no stdio) y deja vacíos comando, argumentos y variables de entorno. Al guardar, el cliente abrirá Leaxio para que inicies sesión y apruebes.
MCP Inspector (para probar)
Útil si quieres comprobar la conexión sin depender de la interfaz de un cliente:
npx @modelcontextprotocol/inspector
Elige transporte Streamable HTTP, pega la dirección y completa el inicio de sesión. Su redirección a localhost se muestra como «app en tu equipo»; es normal.
Si no conecta
| Lo que ves | Qué significa | Qué hacer |
|---|---|---|
mcp_not_enabled o «pendiente de activar» | La organización no ha activado la función. | Pídelo a un propietario o administrador. |
| «Tu plan no incluye esta función» | La organización está en Básico. | Cambia a Negocio o Pro desde Facturación. |
| «Suscripción inactiva» | El pago está vencido o cancelado. | Reactiva la suscripción. |
| «Sin permiso» en una respuesta | Tu rol no incluye esa sección. | Pide el permiso a quien administra la organización. |
| «Demasiadas consultas» | Se superó el límite por usuario. | Espera un minuto y vuelve a intentar. |
| La app abre Leaxio y no vuelve | El consentimiento no se completó. | Repite la conexión desde la app. |
| Dejó de funcionar de un día para otro | El acceso se revocó o expiró el consentimiento. | Vuelve a conectar. |
Varias organizaciones
Si perteneces a más de una, el agente te pedirá indicar en cuál trabajar. Cada consulta se valida contra la organización elegida: no puede mezclar datos de dos negocios.
Cambiar de agente
Puedes tener varios conectados a la vez. Cada uno aparece en Ajustes → Agentes de IA → Apps conectadas a tu cuenta, con su fecha y su botón Revocar. Revocar uno no afecta a los demás.