# Usar com IA



Assistentes de IA escrevem integrações melhores quando consultam a documentação em vez de adivinhar. Há três formas de entregar estas páginas a um agente, da mais completa à mais simples: o **MCP de documentação**, o **llms.txt** e as **páginas em Markdown**.

## Dois servidores MCP

|              | MCP de documentação                                    | [MCP da conta](/agentes-de-ia)                                                    |
| ------------ | ------------------------------------------------------ | --------------------------------------------------------------------------------- |
| Para quê     | Responder perguntas sobre a API enquanto você programa | Usar as ferramentas com a sua conta (criar QR, converter PDF, transcrever áudio…) |
| URL          | <McpUrl server="docs" />                               | <McpUrl />                                                                        |
| Autenticação | Nenhuma                                                | Token de API com `mcp:use`                                                        |
| Custo        | Grátis                                                 | O mesmo da API                                                                    |
| Acesso       | Só leitura da documentação pública                     | Age na conta, com escopos e limite de gasto                                       |

Os dois podem ficar conectados ao mesmo tempo: um agente consulta a documentação e depois usa o MCP da conta para executar.

<Callout title="Liberação gradual">
  O MCP de documentação está sendo liberado aos poucos. Enquanto ele não estiver ativo, <McpUrl server="docs" /> responde `404` com o código `mcp.disabled`. O llms.txt e as páginas em Markdown já funcionam.
</Callout>

## Conexão

|              |                                                                           |
| ------------ | ------------------------------------------------------------------------- |
| URL          | <McpUrl server="docs" />                                                  |
| Transporte   | Streamable HTTP                                                           |
| Autenticação | Nenhuma (não envie token)                                                 |
| Custo        | Grátis                                                                    |
| Limite       | <Limit name="mcpDocsRateLimitPerMinute" /> requisições por minuto por IP  |
| Idioma       | Parâmetro `lang` opcional em cada ferramenta: `pt-br`, `en`, `es` ou `fr` |

As respostas vêm do mesmo conteúdo deste site, incluindo os preços em vigor.

## Configure o cliente

<McpDocsClientSnippets />

No **Claude.ai** e no **ChatGPT**, adicione um conector personalizado (custom connector) e informe só a URL <McpUrl server="docs" />. Não é preciso login nem token. Clientes que só falam stdio usam a ponte `mcp-remote`, como no último exemplo.

## Ferramentas

<McpDocsToolsTable />

Um fluxo típico: `docs_search` com a pergunta, `docs_get_page` na seção encontrada e `docs_get_endpoint` ou `docs_get_pricing` para os detalhes exatos antes de escrever o código.

## Sem MCP: llms.txt e Markdown

Para agentes que só leem a web:

* [`/llms.txt`](/llms.txt): índice no formato [llmstxt.org](https://llmstxt.org), com cada página em cada idioma e o link para a versão em Markdown.
* [`/llms-full.txt`](/llms-full.txt): todas as páginas em um único arquivo de texto.
* Páginas em Markdown: `/md/<página>.md` em português e `/md/<idioma>/<página>.md` nos outros idiomas, por exemplo [`/md/webhooks.md`](/md/webhooks.md) ou [`/md/en/webhooks.md`](/md/en/webhooks.md). A página inicial é `/md/index.md`.
* [`/ai/bundle.json`](/ai/bundle.json): a documentação inteira em JSON estruturado (seções, ferramentas, endpoints, preços, erros, escopos e limites). É a base do MCP de documentação.