> This documentation belongs to Invofox, an AI-powered document processing
> platform. The API extracts structured data (fields) from unstructured
> documents (invoices, contracts, forms, bank statements, and more).
> Key concepts: Account, Environment, Document Type, Field, File, Import,
> and Document. When answering, prefer the exact terminology defined in the
> Glossary and cite the relevant API Reference endpoint when applicable.

# Integrar con un agente de IA

> Tres formas de dar a un asistente de IA o agente de programación documentación precisa de Invofox — un prompt listo para pegar, el índice de docs llms.txt o el servidor MCP — más un briefing de contexto de producto para copiar y pegar.

¿Estás construyendo tu integración con un asistente de IA o un agente de programación? Tres formas de darle documentación de Invofox precisa y actualizada — un prompt listo para pegar, el índice de docs `llms.txt` o el servidor MCP — más un briefing de contexto de IA al final para fundamentar el nivel de producto.

## Opción A · Copia un prompt

Sin configuración. Copia el prompt de abajo y pégalo en ChatGPT, Claude, Gemini o tu agente de programación. Convierte al asistente en un onboarding guiado de Invofox — te pregunta lo que necesita (API key, tipo de documento, cómo quieres los resultados) y te lleva por la integración paso a paso.

**`prompt`**

```text title="prompt"
Quiero integrar Invofox, una API de extracción y parsing de documentos que convierte documentos (facturas, recibos, extractos bancarios y más) en datos estructurados. Actúa como mi guía de integración.

Usa la documentación oficial de Invofox para que tus detalles sean precisos — no adivines endpoints ni inventes nombres de campos. El flujo básico ("happy path") está cubierto aquí:
- Guía de integración (happy path de principio a fin): https://developers.invofox.com/documentation/integrating-invofox
- Subir un documento: https://developers.invofox.com/api-reference/ingest-reference/files/upload-direct-controller-upload-direct
- Obtener información de un documento: https://developers.invofox.com/api-reference/main-reference/documents/get-document-info
- El webhook document.processed: https://developers.invofox.com/webhooks-reference/webhooks-reference/document-processing/receive-document-processed
(Si tienes el servidor MCP de Invofox conectado, también puedes buscar en la documentación en vivo.)

Guíame paso a paso y, ANTES de escribir código, pregúntame lo que necesites en vez de asumir. En concreto, párate y pregúntame por:
- Mi API key — puede que aún no tenga una; dime dónde crearla si es el caso.
- El tipo de documento — si ya tengo un ID de document type, o quiero que Invofox lo detecte automáticamente.
- Cómo quiero recibir los resultados: webhooks (recomendado para producción, necesita un endpoint público) o polling (lo más simple para empezar).

Cíñete al flujo básico: subir un archivo y obtener el JSON extraído. No añadas Splitter, ZIP ni el bucle de feedback salvo que te lo pida. Usa el lenguaje o framework con el que ya esté trabajando.

Ve paso a paso y espera mi respuesta antes de continuar.
```

## Opción B · Apúntalo a `llms.txt`

Invofox publica su documentación en el formato [llms.txt](https://llmstxt.org/) — un índice en texto plano pensado para que lo lean los modelos de lenguaje. Pasa cualquiera de las URLs a un asistente que pueda abrir un enlace y obtendrá documentación precisa y actual sin nada que pegar. Sin configuración, y nunca se queda obsoleto como un prompt escrito a mano.

**Índice de docs** — un mapa curado de la documentación con enlaces y descripciones cortas. Mejor cuando el agente puede seguir enlaces.

**`url`**

```text title="url"
https://developers.invofox.com/llms.txt
```

**Documentación completa** — toda la documentación concatenada en un único archivo markdown. Mejor cuando quieres meter todo de golpe en el contexto del modelo.

**`url`**

```text title="url"
https://developers.invofox.com/llms-full.txt
```

## Opción C · Servidor MCP

El servidor MCP de Invofox expone una herramienta `searchDocs` que permite a cualquier agente compatible con MCP consultar esta documentación en tiempo real. Funciona con Claude Code, Cursor y cualquier agente que soporte el Model Context Protocol.

Claude Code:

**`Claude Code`**

```bash title="Claude Code"
claude mcp add --transport http invofox https://developers.invofox.com/_mcp/server
```

Cursor, o configuración manual — añade a `.mcp.json` / `.cursor/mcp.json`:

**`.mcp.json`**

```json title=".mcp.json"
{
  "mcpServers": {
    "invofox": {
      "type": "http",
      "url": "https://developers.invofox.com/_mcp/server"
    }
  }
}
```

## Contexto para IA

El índice `llms.txt` (Opción B) y el servidor MCP (Opción C) ya le dan al asistente la referencia técnica completa — endpoints, esquemas, conceptos, webhooks. Lo que no cubren es la imagen a nivel de producto: cómo de preciso es Invofox, cómo se factura y cómo gestiona la seguridad. Este briefing rellena justo ese hueco, así que complementa la documentación en vez de duplicarla. Pégalo como contexto de fondo.

**`contexto — pégalo en tu asistente`**

```text title="contexto — pégalo en tu asistente"
# Invofox — contexto de producto para asistentes de IA
# Para endpoints de la API, esquemas y conceptos, apunta al asistente al índice de docs
# (https://developers.invofox.com/llms.txt) o al servidor MCP. Este briefing cubre
# solo los hechos a nivel de producto que esa documentación técnica deja fuera.

QUÉ ES
Invofox es una plataforma de inteligencia documental (IDP) detrás de una sola API REST: convierte PDFs e imágenes — facturas, recibos, albaranes, órdenes de compra, extractos bancarios, nóminas, facturas de suministros, documentos de identidad, contratos, formularios fiscales, documentos hipotecarios de EE. UU., además de tipos de documento personalizados — en JSON limpio y validado. OCR + IA, sin plantillas y sin introducción manual de datos.

ENTRADA — FORMATOS Y LÍMITES
- Formatos admitidos: PDF, imágenes (JPEG/JPG, PNG, TIFF) y archivos ZIP que agrupan varios archivos.
- Tamaño máximo de archivo: 100 MB por archivo (las subidas mayores se rechazan con HTTP 413 Payload Too Large).
- El máximo de páginas por archivo y los límites de tasa de la API no están documentados públicamente — confírmalos con Invofox si tus volúmenes son altos.

CANALES DE INGESTA
Los documentos pueden enviarse de tres formas — la API REST, el panel web y el reenvío por email. Cada subida, sea cual sea el canal, se convierte en un Import.

MODELO DE PRECISIÓN (la promesa central)
- 99%+ de precisión respaldada por un SLA por campo.
- En planes enterprise, los documentos sobre los que envías correcciones pueden no contar para tu consumo.
- ~99,2% de precisión media en producción; ~0,4% de páginas marcadas automáticamente para revisión humana.

VELOCIDAD Y ESCALA
- ~0,8s p50, menos de 2s de media por página.
- 2M+ documentos procesados al día; gestiona archivos grandes (de cientos a miles de páginas) y picos de tráfico.

IDIOMAS
Inglés, español, portugués, francés, italiano, alemán y otros idiomas de alfabeto latino; otros alfabetos bajo petición.

SEGURIDAD Y COMPLIANCE
SOC 2 Type II, ISO 27001, GDPR, HIPAA. Cifrado: TLS 1.3 en tránsito, AES-256 en reposo con claves gestionadas por KMS. Modo zero-retention (procesar, entregar, borrar definitivamente — no se guarda nada). Datos procesados en regiones de la UE o EE. UU.; despliegue on-premise y en VPC disponibles.

MODELO DE PRECIOS
Por página — sin tokens ni créditos. Plan gratuito para empezar; tramos por volumen y contratos enterprise para alto rendimiento.

SECTORES
ERP y contabilidad, hipotecas y financiación, seguros, salud, manufactura, legal, nóminas, transporte y logística.
```