Solicitar acceso a la API
MCP

La documentación de ADITUS, dentro de tu asistente de programación.

Un servidor MCP público de solo lectura sobre la referencia de la API y la guía del Micro Frontend. Sin cuenta ni clave: actívalo desde un directorio sin configurar nada, o añade una URL, y Claude, Cursor, Copilot o ChatGPT consultan el contrato real en lugar de adivinar.

https://developers.aditus.com/api/mcp

Disponible en …

El servidor está publicado en estos directorios. Actívalo allí con un clic, sin archivo de configuración.

  • Claude

    Actívalo directamente como conector en Claude: un clic, sin fragmentos.

    Abrir en Claude

  • Official MCP Registry

    La entrada oficial del servidor (com.aditus.developers/developer-portal) que importan los clientes compatibles con el registro.

    Abrir la ficha

  • Glama

    Página del conector con resumen de herramientas e inspector en el navegador.

    Abrir la ficha

  • Smithery

    Ficha con comandos de instalación para muchos clientes y un playground alojado.

    Abrir la ficha

Configuración manual

Solo es necesario si tu cliente no admite directorios. Streamable HTTP, sin autenticación ni estado de sesión. Elige tu cliente:

Claude Code: ejecuta este comando una vez en tu terminal; después el servidor está disponible en todas las sesiones.

Claude Code
claude mcp add --transport http aditus-docs https://developers.aditus.com/api/mcp

Cursor: guarda esto en .cursor/mcp.json en la carpeta del proyecto (o en ~/.cursor/mcp.json para todos los proyectos).

Cursor · .cursor/mcp.json
{
  "mcpServers": {
    "aditus-docs": {
      "url": "https://developers.aditus.com/api/mcp"
    }
  }
}

VS Code con Copilot: guarda esto en .vscode/mcp.json en la carpeta del proyecto o añádelo a la configuración de usuario con “MCP: Add Server”.

VS Code / Copilot · .vscode/mcp.json
{
  "servers": {
    "aditus-docs": {
      "type": "http",
      "url": "https://developers.aditus.com/api/mcp"
    }
  }
}

Claude Desktop: abre Ajustes → Desarrollador → Editar configuración, pega esto en claude_desktop_config.json y reinicia la app.

Claude Desktop · claude_desktop_config.json
{
  "mcpServers": {
    "aditus-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://developers.aditus.com/api/mcp"]
    }
  }
}

ChatGPT: en Ajustes → Conectores, añade un conector personalizado con la URL del endpoint de arriba; sin fragmentos. Para probar el servidor sin cliente, ejecuta esto en un terminal:

curl
curl -s https://developers.aditus.com/api/mcp \
  -H 'Accept: application/json, text/event-stream' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"search_docs","arguments":{"query":"create cart"}}}'

Los clientes que leen server cards encuentran el mismo servidor en /.well-known/mcp/server-card.json.

Herramientas

Cinco herramientas de solo lectura. El contenido procede de la misma instantánea depurada de la colección que la referencia de la API y los espejos Markdown en /ai, así que los tres coinciden siempre.

ToolArgumentosDevuelve
search_docsquery, limit?Búsqueda de texto completo ordenada por relevancia en módulos, endpoints y guías.
list_modules–Todos los módulos de la API con dirección, número de endpoints y enlaces, más las guías.
list_endpointsmoduleTodos los endpoints de un módulo con método, ruta y resumen breve.
get_endpointendpointContrato completo: parámetros, cabeceras, cuerpo de la petición y respuestas de ejemplo.
get_guideguide, section?Markdown de las guías del Micro Frontend (guía para agentes, documentación completa, visión general), las Guidelines o los Webhooks, completa o por sección.

Ejemplos de peticiones

Tres preguntas típicas y qué ocurre después de formularlas.

  1. “¿Cómo creo un carrito y añado una entrada con la API Shop de ADITUS?”

    El asistente llama a search_docs("create cart add item"), luego a get_endpoint para los dos endpoints coincidentes, y responde con el orden de las peticiones, cabeceras y campos obligatorios y una respuesta de ejemplo.

  2. “¿Cómo verifico la firma de un webhook de ADITUS?”

    El asistente llama a get_guide("webhooks", "signature") y devuelve el nombre exacto de la cabecera, el algoritmo de firma y un fragmento de verificación en tu lenguaje, citando la sección de la guía.

  3. “¿Qué APIs de ADITUS existen para el control de acceso y qué endpoint lee el historial de escaneos de una entrada?”

    El asistente llama a list_modules, elige el módulo de acceso, llama a list_endpoints para él y luego a get_endpoint para el endpoint del historial de escaneos, y responde con la visión general del módulo y los parámetros y campos de respuesta del endpoint.

Datos y privacidad

Sin cuenta ni clave, y tu conversación nunca llega al servidor: tu asistente solo envía el nombre de la herramienta y sus argumentos (término de búsqueda, módulo, endpoint o id de guía). Para la operación, cada petición se registra con el método JSON-RPC, el nombre de la herramienta, esos argumentos (recortados a 200 caracteres cada uno), el estado HTTP, el motivo de error o rechazo, el número de resultados, la duración, el nombre, la versión y la versión de protocolo del cliente del initialize, el user-agent del cliente y un hash corto con clave (HMAC) de la dirección IP; la dirección en sí nunca se guarda. Las filas del registro se borran a los 90 días (limpieza al arrancar y cada seis horas), permanecen en ADITUS y no se comparten con terceros. Las respuestas proceden exclusivamente de la documentación pública. Preguntas: Contacto · Política de privacidad