Pedir acesso à API
MCP

A documentação ADITUS, dentro do seu assistente de programação.

Um servidor MCP público, apenas de leitura, sobre a referência da API e o guia Micro Frontend. Sem conta nem chave: ative-o a partir de um diretório sem qualquer configuração, ou adicione um URL, e o Claude, Cursor, Copilot ou ChatGPT consultam o contrato real em vez de adivinhar.

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

Disponível em …

O servidor está publicado nestes diretórios. Ative-o aí com um clique, sem ficheiro de configuração.

  • Claude

    Ative-o diretamente como conector no Claude: um clique, sem excertos.

    Abrir no Claude

  • Official MCP Registry

    A entrada oficial do servidor (com.aditus.developers/developer-portal) que os clientes compatíveis com o registo importam.

    Abrir a ficha

  • Glama

    Página do conector com visão geral das ferramentas e inspetor no navegador.

    Abrir a ficha

  • Smithery

    Ficha com comandos de instalação para muitos clientes e um playground alojado.

    Abrir a ficha

Configuração manual

Só é necessário se o seu cliente não suportar diretórios. Streamable HTTP, sem autenticação nem estado de sessão. Escolha o seu cliente:

Claude Code: execute este comando uma vez no seu terminal; depois o servidor fica disponível em todas as sessões.

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

Cursor: guarde isto em .cursor/mcp.json na pasta do projeto (ou em ~/.cursor/mcp.json para todos os projetos).

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

VS Code com Copilot: guarde isto em .vscode/mcp.json na pasta do projeto ou adicione-o às definições de utilizador com “MCP: Add Server”.

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

Claude Desktop: abra Definições → Programador → Editar configuração, cole isto em claude_desktop_config.json e reinicie a aplicação.

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

ChatGPT: em Definições → Conectores, adicione um conector personalizado com o URL do endpoint acima; sem excertos. Para experimentar o servidor sem cliente, execute isto num 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"}}}'

Os clientes que leem server cards encontram o mesmo servidor em /.well-known/mcp/server-card.json.

Ferramentas

Cinco ferramentas apenas de leitura. O conteúdo vem do mesmo snapshot depurado da coleção que a referência da API e os espelhos Markdown em /ai, por isso os três coincidem sempre.

ToolArgumentosDevolve
search_docsquery, limit?Pesquisa de texto integral ordenada por relevância em módulos, endpoints e guias.
list_modules–Todos os módulos da API com direção, número de endpoints e ligações, mais os guias.
list_endpointsmoduleTodos os endpoints de um módulo com método, caminho e resumo.
get_endpointendpointContrato completo: parâmetros, cabeçalhos, corpo do pedido e respostas de exemplo.
get_guideguide, section?Markdown dos guias Micro Frontend (guia para agentes, documentação completa, visão geral), das Guidelines ou dos Webhooks, completo ou por secção.

Exemplos de pedidos

Três perguntas típicas e o que acontece depois de as fazer.

  1. “Como crio um carrinho e adiciono um bilhete através da API Shop da ADITUS?”

    O assistente chama search_docs("create cart add item"), depois get_endpoint para os dois endpoints encontrados, e responde com a ordem dos pedidos, cabeçalhos e campos obrigatórios e uma resposta de exemplo.

  2. “Como verifico a assinatura de um webhook da ADITUS?”

    O assistente chama get_guide("webhooks", "signature") e devolve o nome exato do cabeçalho, o algoritmo de assinatura e um excerto de verificação na sua linguagem, citando a secção do guia.

  3. “Que APIs da ADITUS existem para o controlo de acessos e que endpoint lê o histórico de leituras de um bilhete?”

    O assistente chama list_modules, escolhe o módulo de acessos, chama list_endpoints para ele e depois get_endpoint para o endpoint do histórico de leituras, e responde com a visão geral do módulo e os parâmetros e campos de resposta do endpoint.

Dados e privacidade

Sem conta nem chave, e a sua conversa nunca chega ao servidor: o seu assistente envia apenas o nome da ferramenta e os seus argumentos (termo de pesquisa, módulo, endpoint ou id do guia). Para a operação, cada pedido é registado com o método JSON-RPC, o nome da ferramenta, esses argumentos (cortados a 200 caracteres cada), o estado HTTP, o motivo de erro ou rejeição, o número de resultados, a duração, o nome, a versão e a versão de protocolo do cliente do initialize, o user-agent do cliente e um hash curto com chave (HMAC) do endereço IP; o endereço em si nunca é guardado. As linhas de registo são apagadas após 90 dias (limpeza no arranque e a cada seis horas), permanecem na ADITUS e não são partilhadas com terceiros. As respostas provêm exclusivamente da documentação pública. Perguntas: Contacto · Política de privacidade