Guía de configuración: Clara MCP 🤖

Conecta tus asistentes de IA favoritos (Claude, ChatGPT, Gemini) directamente con tu cuenta de Clara para gestionar tus finanzas corporativas en tiempo real.

Consulta: Clara MCP: Conecta tu asistente de IA a Clara — OAuth — Qué es y cómo obtener acceso.

Lo que necesitarás

Tu cuenta de Clara está activa, con rol de Administrador o Contador.

Cuentas además con una herramienta de IA compatible:

• Claude Desktop / Claude Web: recomendado.
• Claude Code: para uso técnico en terminal (CLI).
• ChatGPT: mediante conectores personalizados (requiere activar el Modo de desarrollador).
• Otras herramientas: Gemini u otra herramienta compatible con conectores remotos y autenticación OAuth.

URL del servidor MCP

Para cuentas en México, utiliza la siguiente URL de conexión:

https://api.clara.team/mcp

Conecta tu herramienta a Clara MCP

Claude Web / Claude Desktop

El proceso de configuración es igual en Claude Web y Claude Desktop.

1

Ve a Configuración y luego a Conectores

Inicia sesión en tu cuenta y dirígete a Configuración. En el menú lateral, selecciona Conectores.

2

Agrega un conector personalizado

En la esquina superior derecha, selecciona Agregar y luego Agregar conector personalizado.

3

Ingresa los datos del conector

Completa el formulario con la siguiente información:

Nombre: Clara MX. Este campo es únicamente informativo.
URL: https://api.clara.team/mcp
Autenticación: OAuth

4

Agrega y conecta

Selecciona Agregar y, después, Conectar. Te redirigiremos a la pantalla de inicio de sesión de Clara.

5

Completa el inicio de sesión

Inicia sesión con tu usuario y contraseña, o con Google, Microsoft o passkey.

Autoriza el acceso de Clara MCP. Al finalizar, volverás automáticamente a tu herramienta de IA.

Listo: Clara MCP quedará conectado y podrás consultar la información de tu cuenta directamente desde tu asistente de IA.

Claude Desktop

Para Claude Desktop, sigue el mismo proceso que en Claude Web:

1. Abre la configuración de Claude Desktop.
2. Ve a la sección de Conectores.
3. Selecciona Agregar nuevo conector personalizado.
4. Ingresa la URL del servidor MCP y completa el flujo de OAuth.

Si ya tenías Clara MCP configurado

Si utilizabas Clara MCP con el sistema anterior, necesitas actualizar tu configuración.

Claude Desktop:

En lugar de usar supergateway, utiliza mcp-remote para admitir el flujo de OAuth:

"clara-mx": {
  "command": "npx",
  "args": [
    "-y",
    "mcp-remote",
    "https://api.clara.team/mcp"
  ]
}

Al reiniciar Claude Desktop, se abrirá automáticamente la página de inicio de sesión de Clara.

Claude Web:

Elimina la configuración anterior y sigue los pasos indicados en "Para nuevos usuarios".

Claude Code

Para nuevos usuarios:

1

Ejecuta el comando en la terminal

Abre una terminal fuera de Claude Code y ejecuta:

claude mcp add --transport http clara-mx https://api.clara.team/mcp

2

Abre Claude Code y ejecuta /mcp

Escribe /mcp en el editor de comandos y presiona Enter para seleccionar el servidor Clara MCP.

3

Selecciona "Authenticate"

Te redirigiremos al flujo de OAuth de Clara para iniciar sesión y autorizar la conexión.

Si ya utilizabas Clara MCP:

Necesitas iniciar sesión nuevamente, ya que el token de acceso anterior ya no es compatible con el nuevo servidor. Sigue los pasos indicados en "Para nuevos usuarios" para completar la migración.

ChatGPT

Primero, activa el Modo de desarrollador y luego agrega Clara MCP como conector personalizado:

1

Habilita el Modo de desarrollador

Ve a Perfil, luego a Configuración, y después a Seguridad e inicio de sesión. Activa el Modo de desarrollador.

2

Agrega Clara MCP

Ve a Complementos y selecciona el botón + en la esquina superior derecha.

3

Ingresa los datos del conector

Completa el formulario con la siguiente información:

Nombre: Clara MX. Este campo es únicamente informativo.
Conexión: https://api.clara.team/mcp
Autenticación: OAuth

4

Crea la conexión e inicia sesión

Selecciona Crear. En el mensaje "Agregar Clara MX a ChatGPT", presiona "Iniciar sesión con Clara MX" para completar el flujo de OAuth.

Listo: Clara MCP quedará conectado a ChatGPT y podrás consultar la información disponible de tu cuenta.

Otras herramientas

Para otras herramientas de IA compatibles, como Gemini, sigue un proceso similar:

• Busca la sección de Conectores o Integraciones en tu herramienta.
• Agrega un nuevo conector personalizado.
• Ingresa la URL del servidor MCP.
• Completa el flujo de OAuth.

Si tienes problemas con una herramienta específica, contacta a nuestro equipo de soporte.

Configuración adicional

Si administras más de una empresa

Al conectarte, Clara MCP inicia sesión en la última empresa que usaste en la plataforma. Para cambiar de empresa dentro de la misma conversación, indícaselo directamente a tu asistente:

• "¿A qué empresas tengo acceso?"
• "Cambia a la empresa [nombre]"

Verifica tu conexión

Una vez conectado, realiza una consulta de prueba para confirmar que todo funciona correctamente:

• "Enlista mis tarjetas de Clara"
• "Muéstrame mis últimas 10 transacciones"

Gestión y seguridad del acceso

Tu acceso mediante IA está vinculado a tu sesión de Clara. No existe un token independiente que puedas perder o compartir por error.

Si necesitas revocar el acceso, contacta a nuestro equipo de Customer Happiness desde el chat de la plataforma o escribe a contacto@clara.com.

Preguntas frecuentes

Soporte