Para agentes de IA e desenvolvedores
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 | Índice de todas as páginas, com título, link e resumo |
| 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 | 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/<idioma>/<id>.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 <link rel="alternate" type="text/markdown">.
Idiomas e padrões de URL
| Idioma | Padrão | Exemplo |
|---|---|---|
| Português (padrão) | /<id>/ |
https://docs.instfy.com/sales-invoice/ |
| Inglês | /en/<id>/ |
https://docs.instfy.com/en/sales-invoice/ |
| Espanhol | /es/<id>/ |
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 emhttps://carbon.instfy.com/ia/. - Idiomas: as ferramentas aceitam
idiomaigual aptouen.
| 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, 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.
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/<id>/), 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/
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.