MONEI para agentes de IA

Cómo trabaja un agente de IA con MONEI: a través del servidor MCP de MONEI, o leyendo directamente esta documentación.

Servidor MCP de MONEI

Empieza aquí. El servidor MCP de MONEI conecta un agente de IA a una cuenta de MONEI y a esta documentación:

https://mcp.monei.com

• El usuario inicia sesión en MONEI (OAuth) y elige una cuenta y acceso de Lectura o Escritura.
• El agente consulta y gestiona esa cuenta: pagos, reembolsos, clientes, suscripciones y más.
• El agente también busca en esta documentación, así que no necesita otro servidor.
• https://mcp.monei.com/test conecta con la cuenta de prueba: pagos simulados, no se mueve dinero.

Configuración para Claude, ChatGPT, Gemini, Claude Code, Codex, Cursor y VS Code: Conecta un asistente de IA.

Servidor MCP de la documentación

Para buscar en la documentación sin una cuenta de MONEI, usa el servidor MCP público de la documentación. No necesita inicio de sesión ni clave:

https://docs-mcp.monei.com/mcp

claude mcp add --transport http monei-docs https://docs-mcp.monei.com/mcp

Otros clientes usan la entrada habitual de HTTP en streaming:

{"mcpServers": {"monei-docs": {"type": "http", "url": "https://docs-mcp.monei.com/mcp"}}}

Es de solo lectura y no llega a datos de ninguna cuenta. Sus resultados son los mismos registros que la API de búsqueda.

Qué está disponible

Recurso	URL
Servidor MCP de MONEI	https://mcp.monei.com
MCP de la documentación	https://docs-mcp.monei.com/mcp
Índice de páginas	https://docs.monei.com/es/llms.txt
Cualquier página en Markdown	https://docs.monei.com/es/<ruta>.md
API de búsqueda	https://docs-search.monei.com
Sitemap	https://docs.monei.com/es/sitemap.xml
Especificación de la API REST	https://js.monei.com/api/v1/openapi.json
Esquema GraphQL	https://graphql.monei.com/
Colección de Postman	https://postman.monei.com/

Las páginas en inglés no llevan el prefijo /es/ y tienen su propio /llms.txt y /sitemap.xml. robots.txt permite todos los rastreadores, y una página que no existe devuelve HTTP 404.

Lee páginas en Markdown

Quita la barra final de la URL de una página y añade .md, o envía Accept: text/markdown a la URL de la página:

curl https://docs.monei.com/es/payments/refunds.md
curl -H "Accept: text/markdown" https://docs.monei.com/es/payments/refunds/

llms.txt lista todas las páginas con su título, descripción y URL en Markdown.

Busca en la documentación

La API de búsqueda no necesita clave. Es compatible con Algolia, índice monei:

curl -G "https://docs-search.monei.com/1/indexes/monei" \
  --data-urlencode "query=reembolso pago" \
  --data-urlencode "filters=lang:es AND record_type:docs" \
  --data-urlencode "hitsPerPage=5" \
  --data-urlencode "attributesToRetrieve=url,hierarchy,content"

La búsqueda compara palabras clave, no significado: envía bizum recurrente, no una pregunta completa.

Filtros

Atributo	Valores
lang	en, es
record_type	docs, api, changelog
type	content, lvl1–lvl6

Estructura de la respuesta

Cada resultado es una sección de una página:

• url: la URL de la página con el ancla de la sección. Para el Markdown, quita el #ancla, después la barra final, y añade .md.
• hierarchy.lvl0–lvl6: la ruta de títulos.
• content: el texto de la sección, o null para un título.

Usa llms.txt y las URL .md para leer muchas páginas. No uses la búsqueda para copiar el corpus.

Agentes en el navegador

En cada página, un agente del navegador compatible con WebMCP recibe dos herramientas de solo lectura: search_monei_docs y read_monei_docs_page. No hay nada que instalar.

Especificaciones de las API

La API REST se describe con la especificación OpenAPI, y la API GraphQL admite introspección. Las dos necesitan una clave de API del panel. Usa una clave de prueba mientras desarrollas: consulta Pruebas.

Preguntas frecuentes

¿Qué servidor MCP debo usar?

El servidor MCP de MONEI, cuando el usuario tiene una cuenta de MONEI. También busca en la documentación. Usa el servidor MCP de la documentación solo cuando no hay cuenta.

¿Qué URL debe citar un agente?

La URL de la página con el ancla de la sección, no la URL .md.