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.

Antes de comenzar: Necesitas un token de Clara MCP. Si eres Administrador o Contador, puedes generarlo en la plataforma en Configuración → Integraciones → Clara MCP. También puedes solicitarlo a nuestro equipo de Solution Engineering: integration.support.mx@clara.team.

 Consulta Clara MCP — Qué es y cómo obtener acceso →.

📋 Lo que necesitarás

• Un token de Clara MCP (Personal e intransferible).

• Una herramienta de IA compatible:

  • Claude Desktop: Recomendado para macOS/Windows.

  • Claude Code: Para uso técnico en terminal (CLI).

  • Otras: ChatGPT Desktop o Gemini (vía Google AI Studio).

🛠️ Paso 1: Instalar Node.js

Node.js es el motor necesario para que el protocolo MCP funcione en tu computadora.

En macOS:

1. Abre una terminal y escribe: npx.

2. Si ves el mensaje "Entering npm script environment", ya está instalado. Salta al Paso 2.

3. Si no, instálalo vía Homebrew: brew install node o descarga el instalador en nodejs.org.

En Windows:

1. Abre PowerShell y escribe: node --version.

2. Si aparece una versión (ej. v20.x.x), salta al Paso 2.

3. Si no, descarga e instala el archivo .msi desde nodejs.org. Al finalizar, reinicia tu terminal y verifica con el comando anterior.

⚙️ Paso 2: Configuración por herramienta

Opción A — Claude Desktop (Recomendado)

Es la forma más sencilla de integración. Sigue estos pasos:

1. Abre el archivo de configuración en tu computadora según tu sistema:

   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Agrega el siguiente bloque dentro del objeto "mcpServers". Si el archivo es nuevo, copia la estructura completa:

{
  "mcpServers": {
    "clara-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--streamableHttp",
        "https://api.clara.team/mcp",
        "--header",
        "clara-mcp-token: TU_TOKEN_AQUÍ"
      ]
    }
  }
}

3. Reinicia la aplicación: Cierra completamente Claude Desktop (Salir/Quit) y vuelve a abrirlo.

Opción B — Claude Code (CLI)

Para desarrolladores o usuarios técnicos, ejecuta el siguiente comando en la terminal:

claude mcp add clara-mcp \
--transport http \
--url https://api.clara.team/mcp \
--header "clara-mcp-token: TU_TOKEN_AQUÍ"

Opción C — Configuración genérica (ChatGPT, Gemini, etc.)

Si tu herramienta permite servidores MCP personalizados, utiliza estos parámetros:

✅ Paso 3: Verifica tu conexión

Una vez configurado, realiza una pregunta de prueba para confirmar el acceso en tiempo real:

• “Enlista mis tarjetas de Clara”

• “Muéstrame mis últimas 10 transacciones”

• “Bloquea la tarjeta con terminación 3540”

🛡️ Gestión y Seguridad del Token

• Privacidad: Tu token es una contraseña. No lo compartas ni lo subas a repositorios de código públicos.

• Revocación: Si crees que tu token ha sido comprometido, puedes revocarlo desde la plataforma (Configuración > Integraciones) o contactar a contacto@clara.com. El acceso se detendrá inmediatamente.

❓ Solución de problemas comunes

• Error 401 (No autorizado): Verifica que el token sea correcto y que el encabezado en la configuración esté escrito exactamente como clara-mcp-token (en minúsculas).

• No aparece la herramienta: Asegúrate de haber cerrado la aplicación por completo (Quit), no solo la ventana, después de editar el archivo JSON.

• Respuesta "Ok" al bloquear tarjeta: Es una limitación conocida de la fase Beta. La operación se ejecuta correctamente aunque la respuesta sea simple.

• Contador en 0: En algunos casos, el resumen de transacciones muestra 0, pero el desglose de movimientos aparecerá correctamente abajo.

🛡️ ¿Es seguro?

Sí, totalmente.

• La IA no guarda tus datos, solo los consulta cuando tú se lo pides.

• Tú puedes cancelar el acceso en cualquier momento si pierdes tu token.

• Clara utiliza encriptación de nivel bancario para que la comunicación sea privada.