Documentação

Português

English
Español

Português

English
Español

Appearance

Servidor MCP — Documentação para IA ​

O servidor MCP da Axia expõe esta documentação — o Manual do Operador, o Guia do Usuário e a Referência da API BaaS — para assistentes de IA (Claude, Cursor, Windsurf e afins) através do Model Context Protocol (MCP).

Na prática: você conecta o servidor à sua ferramenta de IA e passa a perguntar em linguagem natural sobre a plataforma e a API, com respostas fundamentadas na documentação oficial, em português, inglês e espanhol.

Endpoint: https://docs-mcp.axiadigitalsolutions.com/mcp · Transporte: Streamable HTTP · Autenticação: OAuth 2.1 · Acesso: somente leitura

1. O que é MCP ​

O Model Context Protocol é um padrão aberto que permite a assistentes de IA acessarem fontes de dados e ferramentas externas de forma segura. Em vez de copiar e colar trechos da documentação, a IA consulta o servidor diretamente e busca exatamente o que precisa para responder.

O servidor da Axia é somente leitura: ele apenas busca e retorna conteúdo da documentação. Não executa nenhuma operação, não acessa dados de clientes e não altera nada.

2. Ferramentas disponíveis ​

O servidor oferece 6 ferramentas que a IA usa automaticamente conforme a pergunta:

FerramentaO que faz
search_docsBusca full-text em toda a documentação (filtra por idioma e acervo).
get_pageRetorna o conteúdo completo de uma página.
list_sectionsLista a árvore de navegação (acervos e páginas).
docs_statsEstatísticas do acervo (páginas por idioma e seção).
list_api_endpointsLista os endpoints da API BaaS (filtra por tag ou texto).
get_api_endpointDetalha um endpoint: parâmetros, corpo da requisição e respostas.

Você não chama essas ferramentas manualmente — basta conversar, e o assistente decide quando buscar.

3. Como obter acesso (senha) ​

O servidor é protegido por OAuth 2.1 com uma senha de autorização.

Solicite a senha ao suporte

A senha de acesso é fornecida pela equipe de suporte da Axia. Solicite por [email protected] informando quem irá utilizar e com qual finalidade.

Você não cadastra usuário nem cria conta: ao conectar, sua ferramenta de IA abre uma página de autorização onde você digita a senha recebida do suporte — uma única vez. A partir daí, a sessão é renovada automaticamente.

4. Conectar na Claude (web) ​

  1. Abra as configurações → Connectors (Conectores).
  2. Clique em Add custom connector (Adicionar conector personalizado).
  3. Cole a URL do servidor:
    https://docs-mcp.axiadigitalsolutions.com/mcp
  4. A Claude abrirá a página de autorização. Digite a senha fornecida pelo suporte e confirme.
  5. Pronto — as 6 ferramentas aparecem e a Claude passa a consultar a documentação nas conversas.

Conectores personalizados exigem um plano pago da Claude (Pro/Max/Team/Enterprise). Em contas Team/Enterprise, o administrador da organização precisa habilitar conectores personalizados.

5. Conectar no Claude Code / Desktop ​

Via CLI do Claude Code:

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

O cliente fará o fluxo de autorização e abrirá o navegador para você digitar a senha. Para confirmar:

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

Ou, via arquivo de configuração (.mcp.json do projeto, ou config do Desktop):

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

Outros clientes compatíveis com MCP over HTTP (Cursor, Windsurf, VS Code) usam o mesmo formato de url.

6. Exemplos de uso ​

Depois de conectado, é só perguntar naturalmente. O assistente combina as ferramentas sozinho (buscar → ler → responder).

Integração com a API BaaS

Como faço uma cobrança PIX na API? Mostra o endpoint e o corpo da requisição.
Detalha o POST /v1/bank-accounts/create — quais campos são obrigatórios?
Gera um exemplo em Node.js pra criar uma conta digital e consultar o saldo.
Como funcionam os webhooks de crypto? Qual o payload que eu recebo?

Manual do Operador (BackOffice)

Como o operador aprova um pagamento manual? Passo a passo.
O que o módulo de antifraude faz e quais permissões preciso?

Guia do Usuário / multi-idioma

Me traz a documentação de PIX em espanhol.
Resume o manual de crédito em inglês.

Peça a fonte

Termine com "...e cite a página da documentação que você usou". Os resultados trazem o caminho/URL, então o assistente consegue linkar a origem.

7. Segurança e limites ​

  • Somente leitura — o servidor apenas busca conteúdo; não executa operações nem acessa dados de clientes.
  • OAuth 2.1 + PKCE — o acesso é autorizado por token; a senha só libera a autorização inicial.
  • Conteúdo da documentação — as respostas refletem a documentação publicada; para o contrato exato da API, a fonte da verdade é a Referência interativa.
  • Atualizações — a base indexada é atualizada junto com a documentação. Consultas sempre retornam o conteúdo publicado mais recente.

8. Suporte ​