MCP da documentação
Conecte o Claude, o Cursor ou o VS Code à documentação da Kodano.
O MCP da documentação dá ao seu assistente de código acesso a esta documentação e à referência da API. Ele busca nos guias e nos endpoints, lê páginas inteiras e devolve o link da página de origem para você conferir.
- Endereço:
https://docs-mcp.kodano.app/mcp(transporte HTTP). - Só leitura e sem login: ele não acessa sua conta, suas credenciais nem seus dados.
- O conteúdo é o mesmo deste site e é atualizado a cada publicação.
Conectar
claude mcp add --transport http kodano-docs https://docs-mcp.kodano.app/mcpPara usar em todos os projetos da máquina, acrescente --scope user ao comando.
Confira com /mcp dentro do Claude Code: kodano-docs aparece como conectado, com 3 ferramentas.
Conferir se está funcionando
Peça ao assistente: "Use o kodano-docs para me explicar como estornar um pagamento PIX."
A resposta deve citar páginas desta documentação, com o link de cada uma (por exemplo, o guia "Estornar e cancelar"). Se ele responder sem citar nada, provavelmente não usou o MCP: confira se o servidor está ativo no cliente e peça de novo, citando kodano-docs.
O que o assistente pode fazer
| Ferramenta | Para quê |
|---|---|
search_docs | Buscar nos guias e na referência da API. Aceita perguntas em português ou termos exatos, como IDEMPOTENCY.CONFLICT ou POST /v1/payments/pix. |
get_document | Ler uma página inteira, por exemplo a referência de um endpoint. |
list_docs | Listar as páginas disponíveis. |
Exemplos de pergunta:
- "Como crio uma cobrança PIX e acompanho até o pagamento?"
- "Quais erros o
POST /v1/payments/{id}/refundspode devolver?" - "Como verifico a assinatura de um webhook em Node.js?"
Problemas comuns
| Sintoma | O que fazer |
|---|---|
Erro 404 ao conectar | Confira o endereço: ele termina em /mcp. |
Erro 429 | Limite de uso por IP (60 chamadas por minuto). Espere alguns segundos e tente de novo. |
| Conecta, mas o assistente não usa as ferramentas | O assistente decide quando consultar. Peça explicitamente: "use o kodano-docs para…". |
| Uma página nova não aparece | O MCP é atualizado a cada publicação deste site; logo depois de uma publicação, pode levar alguns minutos. |
A documentação é referência, não instrução
O assistente recebe o conteúdo como dado para citar. Confira sempre o link da página de origem antes de levar um exemplo para produção.