> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Servidor MCP

Conecta tu flujo de trabajo con IA a la especificación de API y la documentación en vivo de Localpayment mediante el Model Context Protocol (MCP). Instrucciones de configuración para Cursor, VS Code, Claude, Windsurf, ChatGPT, Gemini CLI, JetBrains y más.

El servidor MCP de Localpayment ofrece a cualquier herramienta de IA compatible con MCP acceso directo a la especificación de API y a la documentación en vivo. Una vez configurado, tu asistente de IA puede descubrir endpoints, leer esquemas de parámetros, buscar en las guías y generar código de integración preciso, basado en la especificación vigente y no en datos de entrenamiento potencialmente desactualizados.

> [!NOTE]
>
> **Inicio rápido**: El servidor MCP de Localpayment está disponible en `https://docs.localpayment.com/mcp`. Es público y no requiere autenticación.

***

## ¿Qué es MCP?

Model Context Protocol (MCP) es un estándar abierto que funciona como un puerto USB para la IA: ofrece a los asistentes de IA una forma estandarizada de conectarse con fuentes de datos y herramientas externas. En lugar de depender de una instantánea de entrenamiento estática y potencialmente desactualizada de la API, tu herramienta de IA consulta la documentación de Localpayment en tiempo real.

***

## Conectarse al servidor MCP

Selecciona tu herramienta de IA para obtener la configuración:

> [tab] Cursor
>
> [Instalar en Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=localpayment\&config=eyJ1cmwiOiJodHRwczovL2RvY3MubG9jYWxwYXltZW50LmNvbS9tY3AifQ==)
>
> O agregar manualmente a `~/.cursor/mcp.json`:
>
> ```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
> {
>   "mcpServers": {
>     "localpayment": {
>       "url": "https://docs.localpayment.com/mcp"
>     }
>   }
> }
> ```
>
> Reinicia Cursor y abre el chat de IA. Las herramientas de Localpayment estarán disponibles automáticamente.

> [tab] VS Code (Copilot)
>
> [Instalar en VS Code](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%7B%22type%22%3A%22http%22%2C%22name%22%3A%22localpayment%22%2C%22url%22%3A%22https%3A%2F%2Fdocs.localpayment.com%2Fmcp%22%7D)
>
> O agrega manualmente a tu `settings.json` de VS Code o a `.vscode/mcp.json`:
>
> ```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
> {
>   "mcp": {
>     "servers": {
>       "localpayment": {
>         "type": "http",
>         "url": "https://docs.localpayment.com/mcp"
>       }
>     }
>   }
> }
> ```
>
> Requiere GitHub Copilot Chat con la compatibilidad con MCP habilitada.

> [tab] Claude Desktop
>
> Agrega lo siguiente a tu `claude_desktop_config.json`:
>
> **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
> **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
>
> ```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
> {
>   "mcpServers": {
>     "localpayment": {
>       "url": "https://docs.localpayment.com/mcp"
>     }
>   }
> }
> ```
>
> Reinicia Claude Desktop para aplicar la configuración.

> [tab] Claude Code
>
> Ejecuta el siguiente comando en tu terminal:
>
> ```bash theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
> claude mcp add localpayment --url https://docs.localpayment.com/mcp
> ```
>
> > [!NOTE]
> >
> > Esta es la opción de configuración más rápida: un solo comando agrega el servidor MCP de Localpayment a tu proyecto de Claude Code de forma permanente.
>
> El servidor MCP estará disponible en todas las futuras sesiones de Claude Code en este proyecto.

> [tab] Windsurf
>
> Agrega lo siguiente a `~/.codeium/windsurf/mcp_config.json`:
>
> ```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
> {
>   "mcpServers": {
>     "localpayment": {
>       "url": "https://docs.localpayment.com/mcp"
>     }
>   }
> }
> ```
>
> Reinicia Windsurf para aplicar la configuración.

> [tab] ChatGPT
>
> 1. Abre **ChatGPT** y ve a **Configuración → Conectores**.
> 2. Selecciona **Agregar conector personalizado**.
> 3. Introduce la URL del servidor MCP: `https://docs.localpayment.com/mcp`
> 4. Guarda y comienza una nueva conversación.
>
> Las herramientas de Localpayment estarán disponibles en tu sesión de chat.

> [tab] Gemini CLI
>
> Agrega lo siguiente al archivo de configuración de MCP de tu Gemini CLI:
>
> ```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
> {
>   "mcpServers": {
>     "localpayment": {
>       "url": "https://docs.localpayment.com/mcp"
>     }
>   }
> }
> ```

> [tab] JetBrains
>
> 1. Abre **Configuración → Herramientas → Asistente de IA → Servidores MCP**.
> 2. Haz clic en **Agregar** e ingresa:
>    * **Nombre**: Localpayment
>    * **URL**: `https://docs.localpayment.com/mcp`
> 3. Aplica los cambios y reinicia el IDE.

> [tab] OpenHands
>
> [OpenHands](https://github.com/All-Hands-AI/OpenHands) es una plataforma de desarrollo de software con IA de código abierto, con compatibilidad nativa con MCP.
>
> **A través de la interfaz de OpenHands:**
>
> 1. Abre OpenHands y ve a **Configuración → MCP**.
> 2. Agrega un nuevo servidor con:
>    * **Transporte**: Streamable HTTP
>    * **URL**: `https://docs.localpayment.com/mcp`
> 3. Guarda los cambios. Las herramientas de Localpayment estarán disponibles para el agente automáticamente.
>
> **A través de `config.toml`:**
>
> ```toml theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
> [mcp]
> [[mcp.servers]]
> name = "localpayment"
> transport = "streamable_http"
> url = "https://docs.localpayment.com/mcp"
> ```

> [tab] OpenCode
>
> [OpenCode](https://opencode.ai) es un agente de programación con IA de código abierto para la terminal, con compatibilidad nativa con MCP.
>
> Agrega lo siguiente a tu archivo de configuración `opencode.jsonc` (en la raíz del proyecto o en `~/.config/opencode/opencode.jsonc`):
>
> ```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
> {
>   "$schema": "https://opencode.ai/config.json",
>   "mcp": {
>     "localpayment": {
>       "type": "remote",
>       "url": "https://docs.localpayment.com/mcp",
>       "enabled": true
>     }
>   }
> }
> ```
>
> Una vez agregadas, las herramientas MCP de Localpayment quedan disponibles automáticamente para el LLM junto con las herramientas integradas. Haz referencia a ellas en tus indicaciones: `use the localpayment tool to...`
>
> > [!NOTE]
> >
> > OpenCode es de código abierto (MIT) y es compatible con modelos de Claude, OpenAI, Google y modelos locales. Consulta la [documentación de MCP de OpenCode](https://opencode.ai/docs/mcp-servers/) para ver opciones de configuración adicionales, incluida la gestión de herramientas por agente.

> [tab] Otros
>
> Cualquier herramienta compatible con MCP que admita transporte HTTP puede conectarse usando:
>
> ```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
> {
>   "mcpServers": {
>     "localpayment": {
>       "url": "https://docs.localpayment.com/mcp"
>     }
>   }
> }
> ```
>
> Consulta la documentación de tu herramienta para conocer el formato de configuración exacto.

***

## Herramientas disponibles

Una vez conectado, tu asistente de IA tiene acceso a las siguientes herramientas:

| Herramienta | Descripción | Ejemplo de uso |
| :- | :- | :- |
| `list-endpoints` | Enumera todas las rutas de la API y sus métodos HTTP con resúmenes, organizadas por ruta | "¿Qué endpoints hay disponibles para cuentas virtuales?" |
| `get-endpoint` | Devuelve todos los detalles de un endpoint específico: parámetros, cuerpo de la solicitud, esquemas de respuesta y seguridad | "Muéstrame la especificación completa del endpoint Crear cuenta virtual" |
| `search-endpoints` | Búsqueda profunda por palabra clave en rutas, operaciones y esquemas de componentes — úsala para descubrir endpoints por capacidad o modelo de datos | "Busca todas las operaciones relacionadas con los alias" |
| `search` | Busca páginas de guías por consulta y devuelve una lista de resultados con ID, título y URL | "Busca la guía sobre los alias de CVU en Argentina" |
| `fetch` | Recupera el contenido completo de una página de guía por ID — usa `search` primero para obtener el ID | "Obtén el contenido completo de la Descripción general de las cuentas virtuales" |

> [!NOTE]
>
> La herramienta `execute-request` no está habilitada en el servidor MCP de Localpayment. El servidor es **de solo lectura**: proporciona acceso a la documentación y a la información de la especificación, pero no ejecuta llamadas a la API en tu nombre. Para ejecutar solicitudes en vivo durante el desarrollo, utiliza [Postman Collection](https://docs.localpayment.com/es/reference/postman-collection.md) o tu propio cliente HTTP con credenciales de Stage.

***

## Verificar tu configuración

Una vez configurado, abre la interfaz de chat o de agente de tu herramienta de IA y utiliza la siguiente indicación para confirmar que el servidor MCP está conectado y obtener una descripción general completa de la API de Localpayment:

```
Using the Localpayment MCP tools, explore the full API and give me a 
complete overview of everything available: list all endpoints organized 
by product area (PayIns, PayOuts, Virtual Accounts, Treasury/FX, etc.), 
explain what each major feature does, identify which countries are 
supported, and explain the key integration patterns. I want a full map 
of the API as my starting point before building my integration.
```

Tu asistente de IA invocará las herramientas MCP (`list-endpoints`, `search`, `fetch`) y devolverá un resumen estructurado de la documentación de Localpayment en tiempo real.

> [!NOTE]
>
> La herramienta `fetch` requiere un **ID** de guía, no una URL. Usa `search` primero para encontrar la guía y obtener su ID, y luego pasa ese ID a `fetch` para recuperar el contenido completo. Ejemplo: busca "descripción general de las cuentas virtuales" → obtén el ID `localpayment/virtual-accounts-overview` → ejecuta `fetch` con ese ID.

***

## Solución de problemas

> [accordion] El servidor MCP no se conecta
>
> * Verifica que la URL sea exactamente `https://docs.localpayment.com/mcp`, sin variaciones de barra final.
> * Asegúrate de que tu editor o herramienta admita **transporte HTTP** para MCP (en lugar de solo stdio). Todas las configuraciones de esta página usan HTTP.
> * Reinicia tu editor después de guardar el archivo de configuración.
> * Revisa tu conexión de red y confirma que puedes acceder a `https://docs.localpayment.com` en un navegador.

> [accordion] El asistente de IA no utiliza las herramientas MCP
>
> * Algunos editores requieren que habilites explícitamente las herramientas MCP en la configuración del chat o en el modo agente.
> * En Cursor, asegúrate de estar usando el modo **Agent** (no el modo **Ask**) para que las llamadas a herramientas estén disponibles.
> * En VS Code con Copilot, verifica que la extensión de MCP esté instalada y que el servidor aparezca como conectado en la configuración.

> [accordion] Las herramientas devuelven información desactualizada o inesperada
>
> * El servidor MCP refleja la versión publicada actual de la documentación de Localpayment. Si crees que existe una discrepancia, comunícate con [support@localpayment.com](mailto:support@localpayment.com).

***

## Próximos pasos

> [card] [Biblioteca de indicaciones](https://docs.localpayment.com/es/docs/prompt-library.md)
>
> Indicaciones listas para usar para crear integraciones, depurar errores y generar pruebas, organizadas por país y caso de uso.

> [card] [Agentes de IA](https://docs.localpayment.com/es/docs/ai-agents.md)
>
> Implementa el Localpayment Integrator Agent en el framework de IA de tu preferencia.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.