Cómo los agentes de IA y los desarrolladores leen Instfy Docs (llms.txt, Markdown, sitemap) y acceden al MCP de Carbon y a la API pública de Instfy Data.
Instfy Docs se creó para personas y para máquinas. Esta página reúne las direcciones estables que los asistentes de IA, los buscadores y las integraciones pueden usar para leer la documentación y consultar datos públicos de los productos Instfy.
## Archivos para LLMs
| Archivo | Dirección | Contenido |
|---|---|---|
| llms.txt | [https://docs.instfy.com/llms.txt](https://docs.instfy.com/llms.txt) | Índice de todas las páginas, con título, enlace y resumen |
| llms-full.txt | [https://docs.instfy.com/llms-full.txt](https://docs.instfy.com/llms-full.txt) | Texto completo de la documentación en portugués, en un único archivo |
| Sitemap | [https://docs.instfy.com/sitemap.xml](https://docs.instfy.com/sitemap.xml) | Todas las URL, con las versiones en cada idioma |
## Markdown de cada página
Cada página tiene una versión en Markdown, la forma más limpia de consumir el contenido:
```
https://docs.instfy.com/content//.md
```
Ejemplos: `/content/pt/sales-invoice.md`, `/content/en/sales-invoice.md`, `/content/es/sales-invoice.md`. Cada página HTML también apunta a su Markdown con ``.
## Idiomas y patrones de URL
| Idioma | Patrón | Ejemplo |
|---|---|---|
| Portugués (predeterminado) | `//` | `https://docs.instfy.com/sales-invoice/` |
| Inglés | `/en//` | `https://docs.instfy.com/en/sales-invoice/` |
| Español | `/es//` | `https://docs.instfy.com/es/sales-invoice/` |
Los ids son estables e iguales en los tres idiomas. Las páginas incluyen datos estructurados (TechArticle, BreadcrumbList y, cuando hay preguntas frecuentes, FAQPage).
## MCP de Carbon by Instfy
Carbon by Instfy publica un servidor MCP (Model Context Protocol) **de solo lectura**:
- **Endpoint:** `https://carbon.instfy.com/mcp` (HTTP con JSON-RPC 2.0, sin autenticación, límite de 120 solicitudes por minuto por IP).
- **Descubrimiento:** `https://carbon.instfy.com/.well-known/mcp.json`. Documentación en `https://carbon.instfy.com/ia/`.
- **Idiomas:** las herramientas aceptan `idioma` igual a `pt` o `en`.
| Herramienta | Qué hace |
|---|---|
| validar_certificado | Consulta un certificado por código, token, hash o nombre e informa su situación |
| estimar_emissoes_evento | Estima las emisiones de un evento con las mismas reglas de la calculadora del sitio |
| listar_servicos | Lista las líneas de servicio |
| listar_setores | Lista los sectores atendidos |
| detalhar | Detalla un servicio o sector |
| contato | Devuelve los canales de contacto |
El servidor no guarda datos y no consulta la blockchain. Para verificar una transacción, usa el enlace del explorador público que devuelve la validación. Ejemplo de conexión en Claude Code:
```
claude mcp add --transport http carbon https://carbon.instfy.com/mcp
```
## API pública de Instfy Data
Instfy Data describe su API en OpenAPI 3.1, en [https://data.instfy.com/openapi.json](https://data.instfy.com/openapi.json), con tres operaciones:
- **search_company:** busca empresas por nombre o ciudad.
- **get_company:** devuelve los datos de una empresa.
- **create_lead:** registra una solicitud de contacto con el equipo de Instfy.
Otros archivos para agentes: `https://data.instfy.com/llms.txt`, `https://data.instfy.com/llms-full.txt`, `https://data.instfy.com/agents.txt` y `https://data.instfy.com/.well-known/agent.json`.
:::note
Las acciones autenticadas en Instfy Data, como generar informes, recomendar acciones y crear tareas, propuestas o registros en el CRM del ERP, están **En la hoja de ruta**.
:::
Instfy Agent también publica una descripción del producto en `https://ai.instfy.com/llms.txt`.
## Orientaciones para asistentes de IA
- **Cita la página específica**, con el enlace canónico (`https://docs.instfy.com//`), y no solo la página de inicio.
- **Respeta las etiquetas** "Próximamente" y "En la hoja de ruta": esas funciones todavía no están disponibles y no deben presentarse como existentes.
- **Usa los nombres de menú exactos** de ERP Instfy, que aparecen en inglés de forma predeterminada, como *Accounting > Customers*.
- **Indica la fecha de los números** cuando cites volúmenes, como la base de Instfy Data de la carga de julio de 2026.
- **No inventes** precios, plazos ni integraciones que no estén en la documentación. Ante la duda, indica el contacto relationship@instfy.com.
## Preguntas frecuentes
### ¿Dónde está el llms.txt de Instfy Docs?
En https://docs.instfy.com/llms.txt. El texto completo está en https://docs.instfy.com/llms-full.txt.
### ¿Cómo accedo al Markdown de una página?
Usa la dirección https://docs.instfy.com/content//.md, por ejemplo /content/pt/sales-invoice.md.
### ¿El MCP de Carbon permite emitir certificados?
No. El servidor es de solo lectura: valida certificados, estima emisiones y lista servicios, sectores y contacto.
### ¿Necesito una clave para usar el MCP de Carbon o la búsqueda de Instfy Data?
No. El MCP de Carbon y las operaciones públicas de búsqueda y consulta de Instfy Data funcionan sin autenticación.
### ¿Cómo debe citar un asistente esta documentación?
Con el enlace canónico de la página específica y respetando las etiquetas Próximamente y En la hoja de ruta.
## Próximos pasos
Mira cómo está organizada la documentación para personas.
:::related
docs-guide, carbon-certificate, instfy-data
:::