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

# Desarrolla con IA

> Conecta Claude, ChatGPT, Cursor, VS Code y otras herramientas de IA a la documentación de VelaFi mediante el servidor MCP de VelaFi, para que sus respuestas se basen en la documentación vigente.

Un asistente de IA es tan bueno como la información que tiene. Si le preguntas a un asistente de uso general por la API de VelaFi, puede inventar rutas de endpoints, nombres de campos o códigos de estado. El servidor MCP de VelaFi le da a tu asistente acceso directo y de solo lectura a esta documentación, para que consulte las páginas vigentes antes de responder o escribir código.

## Qué hace el servidor MCP

[Model Context Protocol (MCP)](https://modelcontextprotocol.io) es un estándar abierto que permite a las herramientas de IA conectarse a fuentes externas. El servidor MCP de la documentación de VelaFi permite que un asistente:

* **Busque en la documentación** guías, páginas de referencia de la API, webhooks y códigos de error.
* **Lea páginas completas**, incluidos los campos de solicitud y respuesta y los ejemplos.

Beneficios:

* **Respuestas basadas en la documentación vigente.** El asistente cita la página que consultó en lugar de depender de lo que aprendió durante su entrenamiento.
* **Menos endpoints y campos incorrectos.** El código generado usa las rutas, parámetros y valores de enum reales.
* **Funciona donde programas.** Haz preguntas o genera código de integración en Claude, ChatGPT, Cursor, VS Code o tu terminal.
* **Todos los idiomas de este sitio.** El asistente puede buscar en la documentación en inglés, chino y español.

> [!NOTE]
>
> El servidor MCP solo lee la documentación pública de este sitio. No puede acceder a tu cuenta de VelaFi, llamar a la API de VelaFi ni mover fondos, y no necesita clave de API ni inicio de sesión. Nunca pegues tu secreto de API ni tus tokens en un chat de IA.

## URL del servidor

```text theme={null}
https://docs.velafi.com/mcp
```

## Configura tu herramienta de IA

> [tab] Claude
>
> En Claude en la web o en la app de escritorio de Claude:
>
> 1. Abre **Settings → Connectors** ([claude.ai/settings/connectors](https://claude.ai/settings/connectors)).
> 2. Selecciona **Add custom connector**.
> 3. Escribe un nombre, por ejemplo `VelaFi Docs`, y la URL `https://docs.velafi.com/mcp`.
> 4. Selecciona **Add**.
> 5. En un chat, abre el menú de herramientas (**+**) y activa el conector VelaFi Docs.
>
> Es posible que los conectores personalizados no estén disponibles en todos los planes de Claude, y los administradores de tu organización pueden restringirlos.

> [tab] Claude Code
>
> Ejecuta:
>
> ```bash theme={null}
> claude mcp add --transport http velafi-docs https://docs.velafi.com/mcp
> ```
>
> Ejecuta `/mcp` dentro de Claude Code para comprobar que el servidor está conectado.

> [tab] ChatGPT
>
> ChatGPT admite conectores MCP personalizados mediante el modo de desarrollador, en los planes donde está disponible:
>
> 1. Abre **Settings → Apps & Connectors → Advanced settings** y activa **Developer mode**.
> 2. Crea un conector con el nombre `VelaFi Docs` y la URL `https://docs.velafi.com/mcp`. No requiere autenticación.
> 3. En un chat, activa el conector desde el menú de herramientas.
>
> Los nombres de los menús pueden cambiar cuando ChatGPT actualiza su interfaz. Si no encuentras estas opciones, busca "developer mode" y "MCP connectors" en el centro de ayuda de OpenAI.

> [tab] Cursor
>
> Abre la paleta de comandos, ejecuta **Open MCP settings**, selecciona **Add custom MCP** y agrega:
>
> ```json ~/.cursor/mcp.json theme={null}
> {
>   "mcpServers": {
>     "velafi-docs": {
>       "url": "https://docs.velafi.com/mcp"
>     }
>   }
> }
> ```

> [tab] VS Code
>
> Agrega el servidor a `.vscode/mcp.json` en tu proyecto:
>
> ```json .vscode/mcp.json theme={null}
> {
>   "servers": {
>     "velafi-docs": {
>       "type": "http",
>       "url": "https://docs.velafi.com/mcp"
>     }
>   }
> }
> ```
>
> Después úsalo desde GitHub Copilot Chat en modo agente.

> [tab] Windsurf
>
> Agrega el servidor a tu configuración MCP de Windsurf:
>
> ```json ~/.codeium/windsurf/mcp_config.json theme={null}
> {
>   "mcpServers": {
>     "velafi-docs": {
>       "serverUrl": "https://docs.velafi.com/mcp"
>     }
>   }
> }
> ```

> [tab] Codex
>
> Ejecuta:
>
> ```bash theme={null}
> codex mcp add velafi-docs --url https://docs.velafi.com/mcp
> ```

Otras herramientas que admiten servidores MCP remotos por HTTP pueden conectarse con la misma URL.

## Pruébalo

Una vez conectado, hazle a tu asistente preguntas como:

* "Según la documentación de VelaFi, ¿cómo genero un token de negocio? Muéstrame un ejemplo en Python."
* "¿Qué campos necesito para crear una orden de off-ramp a México por SPEI?"
* "¿Qué significa el estado de orden 70 y qué webhook me lo notifica?"
* "Escribe un handler que verifique la firma de un webhook de VelaFi."

Revisa siempre el código generado y pruébalo en el [sandbox](https://docs.velafi.com/es/docs/sandbox.md) antes de usarlo en producción.

## Agent Skills

Para ir más allá de las consultas, instala las [Agent Skills de VelaFi](https://docs.velafi.com/es/docs/developer-tools/agent-skills.md). Le dan a tu asistente instrucciones paso a paso, reglas y scripts de autoverificación para cada caso de uso principal.

## Otras formas de dar la documentación a una IA

* **Páginas en Markdown.** Agrega `.md` a la URL de cualquier página para obtener una versión en Markdown, por ejemplo [`https://docs.velafi.com/es/docs/quickstart.md`](https://docs.velafi.com/es/docs/quickstart.md).
* **Menú de la página.** Usa el menú en la parte superior de cualquier página para copiarla como Markdown, abrirla en ChatGPT o Claude, copiar la URL del servidor MCP o conectar el servidor MCP a Cursor o VS Code con un clic.
* **llms.txt.** [`/llms.txt`](https://docs.velafi.com/llms.txt) lista todas las páginas con una descripción breve, y [`/llms-full.txt`](https://docs.velafi.com/llms-full.txt) contiene el texto completo de la documentación en un solo archivo.


## Related topics

- [Agent Skills](https://docs.velafi.com/es/docs/developer-tools/agent-skills.md)
- [Evento de pago con stablecoin](https://docs.velafi.com/es/api-reference/webhooks/stablecoin-payment-order-message-push.md)
- [Cobrar pagos locales con cuentas virtuales](https://docs.velafi.com/es/docs/use-cases/collect-with-virtual-accounts.md)
- [Dispersar moneda local fondeada con stablecoins](https://docs.velafi.com/es/docs/use-cases/payouts-funded-by-stablecoins.md)
- [Convertir moneda local a stablecoins](https://docs.velafi.com/es/docs/use-cases/convert-to-stablecoins.md)


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