Saltar al contenido principal
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) 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.
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

Configura tu herramienta de IA

En Claude en la web o en la app de escritorio de Claude:
  1. Abre Settings → Connectors (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.
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 antes de usarlo en producción.

Agent Skills

Para ir más allá de las consultas, instala las Agent Skills de VelaFi. 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.
  • 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 lista todas las páginas con una descripción breve, y /llms-full.txt contiene el texto completo de la documentación en un solo archivo.