Servidor MCP — Documentación para IA

El servidor MCP de Axia expone esta documentación — el Manual del Operador, la Guía del Usuario y la Referencia de la API BaaS — a asistentes de IA (Claude, Cursor, Windsurf y similares) a través del Model Context Protocol (MCP).

En la práctica: conectas el servidor a tu herramienta de IA y pasas a preguntar en lenguaje natural sobre la plataforma y la API, con respuestas fundamentadas en la documentación oficial, en portugués, inglés y español.

Endpoint: https://docs-mcp.axiadigitalsolutions.com/mcp · Transporte: Streamable HTTP · Autenticación: OAuth 2.1 · Acceso: solo lectura

---

1. Qué es MCP

El Model Context Protocol es un estándar abierto que permite a los asistentes de IA acceder de forma segura a fuentes de datos y herramientas externas. En lugar de copiar y pegar fragmentos de la documentación, la IA consulta el servidor directamente y busca exactamente lo que necesita para responder.

El servidor de Axia es de solo lectura: únicamente busca y devuelve contenido de la documentación. No ejecuta ninguna operación, no accede a datos de clientes y no modifica nada.

---

2. Herramientas disponibles

El servidor ofrece 6 herramientas que la IA usa automáticamente según la pregunta:

Herramienta	Qué hace
search_docs	Búsqueda full-text en toda la documentación (filtra por idioma y colección).
get_page	Devuelve el contenido completo de una página.
list_sections	Lista el árbol de navegación (colecciones y páginas).
docs_stats	Estadísticas del acervo (páginas por idioma y sección).
list_api_endpoints	Lista los endpoints de la API BaaS (filtra por tag o texto).
get_api_endpoint	Detalla un endpoint: parámetros, cuerpo de la solicitud y respuestas.

No llamas estas herramientas manualmente: basta conversar, y el asistente decide cuándo buscar.

---

3. Cómo obtener acceso (contraseña)

El servidor está protegido con OAuth 2.1 y una contraseña de autorización.

Solicita la contraseña al soporte

La contraseña de acceso la proporciona el equipo de soporte de Axia. Solicítala en [email protected], indicando quién la usará y con qué finalidad.

No registras un usuario ni creas una cuenta: al conectar, tu herramienta de IA abre una página de autorización donde ingresas la contraseña recibida del soporte — una sola vez. A partir de ahí, la sesión se renueva automáticamente.

---

4. Conectar en Claude (web)

1. Abre la configuración → Connectors (Conectores).
2. Haz clic en Add custom connector (Agregar conector personalizado).
3. Pega la URL del servidor:

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

4. Claude abrirá la página de autorización. Ingresa la contraseña proporcionada por el soporte y confirma.
5. Listo — aparecen las 6 herramientas y Claude empieza a consultar la documentación en tus conversaciones.

Los conectores personalizados requieren un plan de pago de Claude (Pro/Max/Team/Enterprise). En cuentas Team/Enterprise, el administrador de la organización debe habilitar los conectores personalizados.

---

5. Conectar en Claude Code / Desktop

Vía la CLI de Claude Code:

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

El cliente ejecutará el flujo de autorización y abrirá el navegador para que ingreses la contraseña. Para confirmar:

claude mcp list        # debe mostrar "axia-docs: ✓ connected"

O, mediante un archivo de configuración (.mcp.json del proyecto, o la config del Desktop):

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

Otros clientes compatibles con MCP sobre HTTP (Cursor, Windsurf, VS Code) usan el mismo formato de url.

---

6. Ejemplos de uso

Una vez conectado, solo pregunta con naturalidad. El asistente combina las herramientas por sí mismo (buscar → leer → responder).

Integración con la API BaaS

¿Cómo creo un cobro PIX en la API? Muestra el endpoint y el cuerpo de la solicitud.
Detalla POST /v1/bank-accounts/create — ¿qué campos son obligatorios?
Genera un ejemplo en Node.js para crear una cuenta digital y consultar el saldo.
¿Cómo funcionan los webhooks de crypto? ¿Qué payload recibo?

Manual del Operador (BackOffice)

¿Cómo aprueba el operador un pago manual? Paso a paso.
¿Qué hace el módulo antifraude y qué permisos necesito?

Guía del Usuario / multi-idioma

Tráeme la documentación de PIX en español.
Resume el manual de crédito en inglés.

Pide la fuente

Termina con "...y cita la página de la documentación que usaste". Los resultados incluyen la ruta/URL, así que el asistente puede enlazar el origen.

---

7. Seguridad y límites

• Solo lectura — el servidor únicamente busca contenido; no ejecuta operaciones ni accede a datos de clientes.
• OAuth 2.1 + PKCE — el acceso se autoriza por token; la contraseña solo desbloquea la autorización inicial.
• Contenido de la documentación — las respuestas reflejan la documentación publicada; para el contrato exacto de la API, la fuente de verdad es la Referencia interactiva.
• Actualizaciones — la base indexada se actualiza junto con la documentación. Las consultas siempre devuelven el contenido publicado más reciente.

---

8. Soporte

• Contraseña de acceso y habilitación: [email protected]
• Dudas sobre la API: consulta Manejo de Errores y la Referencia interactiva