Conectar el Servidor MCP ISO 20022

Está a cinco minutos de tener un asistente de IA que conoce toda la especificación ISO 20022 de memoria.

El Servidor MCP utiliza el Model Context Protocol — un estándar abierto compatible con todas las principales herramientas de desarrollo de IA. Lo configura una vez, en un pequeño archivo JSON, y cada conversación en esa herramienta obtiene acceso instantáneo a la especificación completa.

Lo que necesitará

• Un cliente de IA compatible con MCP — Claude Code, Claude Desktop, Cursor, VS Code con GitHub Copilot, o cualquier otra herramienta habilitada para MCP
• mcp-remote — solo necesario para Claude Desktop (ver más abajo)
• Una cuenta de Google — la autenticación usa Google OAuth; no se requiere contraseña ni clave de API separada

El acceso anónimo está disponible sin iniciar sesión, otorgándole las consultas básicas — suficiente para explorar nombres de mensajes y áreas de negocio. Inicie sesión con Google para desbloquear el conjunto completo de funciones de su nivel.

La creación de cuentas está próximamente disponible. Mientras tanto, conéctese para acceso anónimo o contáctenos para solicitar acceso anticipado.

Acerca de mcp-remote

mcp-remote es una pequeña utilidad puente que traduce entre el protocolo stdio que Claude Desktop usa internamente y el protocolo HTTP/SSE que usan los servidores MCP remotos. Es solo necesaria para Claude Desktop.

Claude Code (ya sea en VS Code, en una terminal o en cualquier otro entorno), Cursor y la mayoría de los otros clientes MCP modernos se conectan a servidores remotos de forma nativa — sin puente necesario.

Si su cliente no es Claude Desktop, vaya directamente a la configuración de su herramienta a continuación.

Configure su cliente de IA

Claude Code (CLI o VS Code)

Claude Code se conecta a servidores MCP remotos de forma nativa. Añada el servidor desde la línea de comandos:

claude mcp add iso20022 --transport sse https://mcp.beneficialstrategies.com/sse

Con una clave de API:

claude mcp add iso20022 --transport sse https://mcp.beneficialstrategies.com/sse \
  --header "Authorization: Bearer SU_CLAVE_API"

O añádalo manualmente a .claude/settings.json en su proyecto (o ~/.claude/settings.json globalmente):

{
  "mcpServers": {
    "iso20022": {
      "type": "sse",
      "url": "https://mcp.beneficialstrategies.com/sse",
      "headers": {
        "Authorization": "Bearer SU_CLAVE_API"
      }
    }
  }
}

Claude Desktop (requiere mcp-remote)

1. Instale mcp-remote:

npm install -g mcp-remote

2. Edite el archivo de configuración:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Acceso anónimo (sin cuenta requerida):

{
  "mcpServers": {
    "iso20022": {
      "command": "mcp-remote",
      "args": ["https://mcp.beneficialstrategies.com/sse"]
    }
  }
}

Cuenta gratuita o de pago:

{
  "mcpServers": {
    "iso20022": {
      "command": "mcp-remote",
      "args": [
        "https://mcp.beneficialstrategies.com/sse",
        "--header",
        "Authorization: Bearer SU_CLAVE_API"
      ]
    }
  }
}

Reinicie Claude Desktop después de guardar. El servidor iso20022 aparecerá en el panel de herramientas.

Cursor

Cursor se conecta a servidores remotos de forma nativa. Edite ~/.cursor/mcp.json (global) o .cursor/mcp.json en la raíz de su proyecto:

{
  "mcpServers": {
    "iso20022": {
      "type": "sse",
      "url": "https://mcp.beneficialstrategies.com/sse",
      "headers": {
        "Authorization": "Bearer SU_CLAVE_API"
      }
    }
  }
}

Recargue la ventana (Cmd+Shift+P → Reload Window) para activar.

VS Code con GitHub Copilot

Añada a .vscode/mcp.json en su workspace, o a su settings.json de usuario:

{
  "mcp": {
    "servers": {
      "iso20022": {
        "type": "sse",
        "url": "https://mcp.beneficialstrategies.com/sse",
        "headers": {
          "Authorization": "Bearer SU_CLAVE_API"
        }
      }
    }
  }
}

Otros clientes compatibles con MCP

Cualquier cliente que admita el Model Context Protocol puede conectarse directamente. Use estos valores:

Si su cliente solo admite servidores basados en stdio, instale mcp-remote y use el patrón de configuración de Claude Desktop indicado arriba.

Autenticación

El servidor MCP usa Google OAuth para la autenticación. No ingresa una contraseña ni una clave de API manualmente — su navegador gestiona el inicio de sesión.

Qué esperar en la primera conexión:

1. Su cliente de IA se conecta al servidor por primera vez
2. Se abre automáticamente una ventana del navegador con un aviso de inicio de sesión de Google
3. Inicie sesión con su cuenta de Google (Gmail)
4. El navegador confirma la conexión y puede cerrar la pestaña
5. Su cliente está autenticado y las herramientas están disponibles

Este flujo es activado por mcp-remote (para Claude Desktop) o por el cliente MCP mismo (para Claude Code y otros clientes nativos). Solo ocurre una vez — las conexiones posteriores reutilizan las credenciales almacenadas hasta que expiren.

Si no se abre ninguna ventana del navegador y la conexión expira, intente ejecutar mcp-remote manualmente en una terminal para activar el flujo OAuth de forma interactiva:

mcp-remote https://mcp.beneficialstrategies.com/sse

Verifique la conexión

Pregúntele a su asistente de IA:

"¿Qué áreas de negocio de ISO 20022 están disponibles?"

Si el servidor está conectado, consultará la especificación en vivo y devolverá una lista estructurada de todas las áreas de negocio. Si adivina desde los datos de entrenamiento en su lugar, verifique su archivo de configuración y reinicie el cliente.

Para una verificación más completa:

“Usa el servidor MCP de ISO 20022 para buscar los campos del mensaje acmt.001.001.08”

Un asistente conectado llamará directamente a la herramienta del servidor y devolverá definiciones de campo precisas. Uno no conectado alucinará.

Próximos pasos