Skip to main content
O CaktoMCP lê esta documentação diretamente, em tempo de execução. Não existe uma segunda versão dos textos guardada dentro do servidor: quando a IA responde uma dúvida de conceito, ela está lendo a mesma página que você lê aqui, na versão que está publicada agora.
Isso mudou. Até setembro de 2026 o servidor servia dez guias curtos, mantidos separadamente desta documentação. Eram uma segunda cópia, e cópias divergem — houve pelo menos um caso em que o guia afirmava o oposto do que esta documentação (corretamente) dizia sobre idempotência. A cópia foi removida. Esta página é a fonte; o MCP é um leitor.

​
As duas ferramentas

​
cakto_search_docs

O catálogo. Busca no título, na descrição e no texto de todas as páginas publicadas — conceitos, guias de início, SDK do checkout, referência de API e as próprias páginas do CaktoMCP. Retorna, para cada página, o slug, o título e a descrição. O slug é o que se passa para cakto_get_guide. Exemplo:

​
cakto_get_guide

Lê uma página inteira, pelo slug. Retorna o texto da página, precedido de um cabeçalho curto com a URL de origem e o instante da leitura — para a IA poder citar a fonte e você poder conferir. Exemplo:
Não é preciso acertar o slug de primeira. Um slug que não existe volta com as páginas mais parecidas como sugestão, e os dez tópicos do formato antigo (idempotencia, webhooks, autenticacao, checkout-builder, primeiros-passos, erros, paginacao, ambientes, fluxo-de-pagamento) continuam sendo aceitos como apelido do slug correspondente.
Os artigos da central de ajuda, que explicam o uso do painel para produtor e comprador, são lidos do mesmo jeito, mas por ferramentas próprias: cakto_search_help e cakto_get_help_article. Esta documentação e a central nunca saem misturadas na mesma busca. Detalhes em Ferramentas de Descoberta.

​
O que isso significa na prática

  • A resposta da IA acompanha a documentação. Uma correção publicada aqui chega ao MCP em poucos minutos, sem nova versão do servidor.
  • Não há divergência possível entre “o que a doc diz” e “o que a IA diz”. É o mesmo texto.
  • Página nova aparece sozinha. O catálogo é lido a cada consulta; não há lista fixa de assuntos.
Para o contrato de um endpoint — parâmetros, corpo, respostas —, prefira cakto_get_endpoint. Ele lê o contrato da API de forma estruturada, é mais preciso e muito mais econômico que a página de referência correspondente. Use cakto_get_guide para conceito, não para assinatura de endpoint.

​
Próximos passos

Ferramentas de Descoberta

Buscar endpoints e ler contratos completos

Ferramentas de Execução

Como a execução real funciona