Documentação para agentes e LLMs

Além do MCP, este portal oferece uma representação textual da documentação, fácil de consumir por ChatGPT, Claude, Codex, Cursor e Copilot.

Os três arquivos

Arquivo	O que traz	Tamanho
/llms.txt	o índice: o que é o produto, onde está cada coisa, e as armadilhas	~1.500 tokens
/llms-api.txt	o contrato: endpoints, parâmetros, campos, tipos, obrigatoriedade, exemplos	~15 mil tokens
/llms-full.txt	a documentação editorial inteira	~30 mil tokens

Os três cabem juntos em qualquer janela de contexto moderna. Não há versão por área da API — com esse tamanho, dividir só acrescentaria a dúvida de qual arquivo carregar.

Qual usar

Sua tarefa	Carregue
Gerar código de integração	llms.txt + llms-api.txt
Entender o fluxo fiscal	llms.txt + llms-full.txt
Só situar o assistente	llms.txt

Os dois grandes são gerados, não escritos

llms-api.txt sai do OpenAPI — que sai do código do gateway. llms-full.txt sai das páginas deste portal. Nenhum dos dois é mantido à mão.

É a mesma regra que vale para o portal inteiro: uma lista de campos escrita à mão envelheceria em silêncio, e um agente que lê campo desatualizado erra com confiança.

Três recursos, três papéis

Recurso	O que entrega
llms.txt	contexto documental — como o produto funciona
OpenAPI	contrato estruturado — quais campos existem
MCP	ferramentas e acesso aos dados reais da conta

MCP não substitui llms.txt

São coisas diferentes. O llms.txt explica o produto para o modelo; o MCP dá a ele ferramentas autenticadas para consultar dados de verdade. Um assistente com os dois responde melhor do que com qualquer um isolado.

Usando com um assistente de código

Para gerar código de integração, o par mais útil é llms.txt (conceitos e armadilhas) + o openapi.json (campos exatos). O modelo tende a errar menos nos pontos que este portal insiste: resposta assíncrona, completed não é autorizada, e não reenviar depois de timeout.