Como agentes de IA e desenvolvedores leem o Instfy Docs (llms.txt, Markdown, sitemap) e acessam o MCP do Carbon e a API pública do Instfy Data.
O Instfy Docs foi feito para pessoas e para máquinas. Esta página reúne os endereços estáveis que assistentes de IA, buscadores e integrações podem usar para ler a documentação e consultar dados públicos dos produtos Instfy.
## Arquivos para LLMs
| Arquivo | Endereço | Conteúdo |
|---|---|---|
| llms.txt | [https://docs.instfy.com/llms.txt](https://docs.instfy.com/llms.txt) | Índice de todas as páginas, com título, link e resumo |
| llms-full.txt | [https://docs.instfy.com/llms-full.txt](https://docs.instfy.com/llms-full.txt) | Texto completo da documentação em português, em um único arquivo |
| Sitemap | [https://docs.instfy.com/sitemap.xml](https://docs.instfy.com/sitemap.xml) | Todas as URLs, com as versões em cada idioma |
## Markdown de cada página
Toda página tem uma versão em Markdown, a forma mais limpa de consumir o conteúdo:
```
https://docs.instfy.com/content//.md
```
Exemplos: `/content/pt/sales-invoice.md`, `/content/en/sales-invoice.md`, `/content/es/sales-invoice.md`. Cada página HTML também aponta para o seu Markdown com ``.
## Idiomas e padrões de URL
| Idioma | Padrão | Exemplo |
|---|---|---|
| Português (padrão) | `//` | `https://docs.instfy.com/sales-invoice/` |
| Inglês | `/en//` | `https://docs.instfy.com/en/sales-invoice/` |
| Espanhol | `/es//` | `https://docs.instfy.com/es/sales-invoice/` |
Os ids são estáveis e iguais nos três idiomas. As páginas trazem dados estruturados (TechArticle, BreadcrumbList e, quando há perguntas frequentes, FAQPage).
## MCP do Carbon by Instfy
O Carbon by Instfy publica um servidor MCP (Model Context Protocol) **somente leitura**:
- **Endpoint:** `https://carbon.instfy.com/mcp` (HTTP com JSON-RPC 2.0, sem autenticação, limite de 120 requisições por minuto por IP).
- **Descoberta:** `https://carbon.instfy.com/.well-known/mcp.json`. Documentação em `https://carbon.instfy.com/ia/`.
- **Idiomas:** as ferramentas aceitam `idioma` igual a `pt` ou `en`.
| Ferramenta | O que faz |
|---|---|
| validar_certificado | Consulta um certificado por código, token, hash ou nome e informa a situação |
| estimar_emissoes_evento | Estima emissões de um evento com as mesmas regras da calculadora do site |
| listar_servicos | Lista as linhas de serviço |
| listar_setores | Lista os setores atendidos |
| detalhar | Detalha um serviço ou setor |
| contato | Retorna os canais de contato |
O servidor não grava dados e não consulta a blockchain. Para conferir uma transação, use o link do explorador público devolvido na validação. Exemplo de conexão no Claude Code:
```
claude mcp add --transport http carbon https://carbon.instfy.com/mcp
```
## API pública do Instfy Data
O Instfy Data descreve a sua API em OpenAPI 3.1, em [https://data.instfy.com/openapi.json](https://data.instfy.com/openapi.json), com três operações:
- **search_company:** busca empresas por nome ou cidade.
- **get_company:** retorna os dados de uma empresa.
- **create_lead:** registra um pedido de contato com a equipe Instfy.
Outros arquivos para agentes: `https://data.instfy.com/llms.txt`, `https://data.instfy.com/llms-full.txt`, `https://data.instfy.com/agents.txt` e `https://data.instfy.com/.well-known/agent.json`.
:::note
Ações autenticadas no Instfy Data, como gerar relatórios, recomendar ações e criar tarefas, propostas ou registros no CRM do ERP, estão **No roteiro**.
:::
O Instfy Agent também publica uma descrição do produto em `https://ai.instfy.com/llms.txt`.
## Orientações para assistentes de IA
- **Cite a página específica**, com o link canônico (`https://docs.instfy.com//`), e não apenas a página inicial.
- **Respeite os rótulos** "Em breve" e "No roteiro": esses recursos ainda não estão disponíveis e não devem ser apresentados como existentes.
- **Use os nomes de menu exatos** do ERP Instfy, que aparecem em inglês por padrão, como *Accounting > Customers*.
- **Informe a data dos números** quando citar volumes, como a base do Instfy Data da carga de julho de 2026.
- **Não invente** preços, prazos ou integrações que não estejam na documentação. Na dúvida, indique o contato relationship@instfy.com.
## Perguntas frequentes
### Onde está o llms.txt do Instfy Docs?
Em https://docs.instfy.com/llms.txt. O texto completo está em https://docs.instfy.com/llms-full.txt.
### Como acesso o Markdown de uma página?
Use o endereço https://docs.instfy.com/content//.md, por exemplo /content/pt/sales-invoice.md.
### O MCP do Carbon permite emitir certificados?
Não. O servidor é somente leitura: valida certificados, estima emissões e lista serviços, setores e contato.
### Preciso de chave para usar o MCP do Carbon ou a busca do Instfy Data?
Não. O MCP do Carbon e as operações públicas de busca e consulta do Instfy Data funcionam sem autenticação.
### Como um assistente deve citar esta documentação?
Com o link canônico da página específica e respeitando os rótulos Em breve e No roteiro.
## Próximos passos
Veja como a documentação está organizada para pessoas.
:::related
docs-guide, carbon-certificate, instfy-data
:::