Guía de configuración: Clara MCP para IA 🤖

Conecta tu asistente de IA (Claude, ChatGPT o Gemini) con tu cuenta de Clara para gestionar tus finanzas corporativas en tiempo real mediante lenguaje natural.

Antes de comenzar: Necesitas un token de Clara MCP. Si eres Administrador o Contador, puedes generarlo en la plataforma en Configuración → Integraciones. También puedes solicitarlo con el NIT de tu empresa a integration.support.co@clara.team.

📋 Lo que necesitarás

1. Un token de Clara MCP (proporcionado por el equipo de Clara o autogestionado).  Ver cómo solicitar token.

2. Una herramienta de IA compatible: Claude Desktop, Claude Code (CLI) o cualquier otra compatible con el estándar MCP.

🛠️ Paso 1: Instalar Node.js

Node.js es el "puente" que permite que tu asistente se comunique con Clara de forma segura.

Si usas Mac:

1. Abre una terminal y escribe: npx.

2. Si ves una respuesta que comienza con "Entering npm script environment", ya estás listo. Salta al Paso 2.

3. Si no lo tienes, instálalo con: brew install node o descarga el instalador en nodejs.org.

Si usas Windows:

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

2. Si ves un número de versión (ej. v20.x.x), salta al Paso 2.

3. Si no, descarga el instalador .msi en nodejs.org, ejecútalo con las opciones por defecto y verifica nuevamente con el comando del punto 1.

⚙️ Paso 2: Configura tu herramienta favorita

Opción A — Claude Desktop (Recomendado)

Abre el archivo de configuración en tu computadora:

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

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

Agrega el siguiente bloque dentro del objeto mcpServers. Usa la URL específica para Colombia:

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

Opción B — Claude Code (CLI)

Si utilizas la terminal, agrega el servidor ejecutando este comando:

claude mcp add clara-mcp \
--transport http \
--url https://api-gw-co-prod.clara.com/mcp \
--header "clara-mcp-token: TU_TOKEN_AQUÍ"

Opción C — Otras herramientas (ChatGPT, Gemini, etc.)

Si tu herramienta permite configurar servidores MCP personalizados, usa estos valores:

✅ Paso 3: Reinicia y Prueba

Cierra completamente tu herramienta de IA (Salir/Quit) y ábrela de nuevo. Prueba preguntando:

• "Enlista mis tarjetas de Clara"

• "Muéstrame mis últimas 10 transacciones"

Solución de problemas comunes

• Error "No autorizado" (401): Verifica que tu token no haya expirado y que el nombre del encabezado esté en minúsculas: clara-mcp-token.

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

• Respuesta "Ok" al bloquear tarjeta: Es un comportamiento normal de la fase Beta; la acción se ejecuta correctamente aunque la respuesta sea corta.

• Contador de transacciones en 0: Es un problema visual conocido de la Beta; los movimientos reales aparecerán correctamente en el listado detallado.

🛡️ ¿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.