MCP beta
Use DocAI directamente desde su agente de codificación
DocAI MCP conecta los agentes de codificación con la inteligencia documental de DocAI mediante el Model Context Protocol. Probado con Codex, Claude Code y Gemini CLI, y compatible con otros clientes MCP stdio.
npx -y @synairo/docai-mcp@next install
npx -y @synairo/docai-mcp@next doctor
¿Está creando código de aplicación en su lugar? Use la API REST
Inicio rápido
-
Paso 1
Instalar
npx -y @synairo/docai-mcp@next install
El instalador configura los hosts MCP compatibles utilizando su propio mecanismo de configuración habitual. Las entradas existentes para otros servidores nunca se modifican.
-
Paso 2
Verificar
npx -y @synairo/docai-mcp@next doctor
doctor comprueba la configuración y la conectividad con la API de DocAI. Nunca muestra su clave de API.
-
Paso 3
Pregunte a su agente
Ejemplo de petición a un agente de codificación:
Integra la extracción de documentos de DocAI en este proyecto. Usa la arquitectura y las convenciones existentes del proyecto. Mantén las credenciales de DocAI en el servidor. Gestiona los errores de API y de procesamiento. Usa resultados de extracción estructurados. Añade las pruebas adecuadas. Valida la integración con un documento de ejemplo anonimizado.
Aquí no hay magia. El agente lee las capacidades de DocAI y la guía de integración a través de MCP, inspecciona su proyecto y escribe la integración por sí mismo. Usted revisa el diff como siempre.
Qué hace realmente el agente
- Descubre DocAI MCP
- Lee las capacidades
- Lee la guía de integración
- Inspecciona el proyecto
- Implementa la integración
- Realiza pruebas con datos depurados
MCP ayuda al agente de codificación a comprender y usar DocAI. No traslada la inteligencia documental al agente de codificación.
Herramientas
docai_get_capabilities
Descubra los formatos admitidos, los límites y el versionado de la API antes de que el agente escriba código de integración.
docai_get_integration_guide
Recupera la guía de integración mantenida que el agente debe seguir para este proyecto.
docai_extract_file
Envía un documento desde el espacio de trabajo actual y devuelve resultados de extracción compactos y estructurados. Solo se puede acceder a los archivos dentro del espacio de trabajo.
docai_get_result
Recupera el resultado de un trabajo que aún se estaba procesando cuando docai_extract_file devolvió su respuesta.
Arquitectura
El paquete MCP no implementa un flujo de procesamiento de documentos independiente. Utiliza la misma API de DocAI y el mismo núcleo de procesamiento que las integraciones directas con la API.
API para desarrolladores. MCP para agentes de codificación.
Use MCP cuando
- trabaja desde un agente de codificación compatible con MCP
- quiere que el agente descubra la guía de integración de DocAI
- quiere una integración del proyecto asistida por el agente
- quiere probar documentos del espacio de trabajo local a través de la interfaz MCP
Use la API REST cuando
- está creando una integración de producción directa
- está llamando a DocAI desde código de aplicación
- está implementando su propio cliente
- está integrando desde infraestructura sin MCP
Ambas vías utilizan el mismo backend de DocAI.
Límites de seguridad
- Acceso a archivos restringido al espacio de trabajo
- El procesamiento de archivos locales está restringido al espacio de trabajo configurado. Se rechazan los intentos de recorrido de rutas y de escape mediante enlaces simbólicos fuera del espacio de trabajo.
- Sin shell genérica
- DocAI MCP no expone la ejecución de comandos de shell arbitrarios.
- Sin navegador de sistema de archivos arbitrario
- No existe una interfaz genérica de exploración del sistema de archivos, solo la herramienta de extracción restringida al espacio de trabajo.
- Sin URL de documentos arbitrarias
- La interfaz MCP no expone la ingesta genérica de documentos mediante URL arbitrarias.
- Límite frente a la inyección de instrucciones
- El texto encontrado dentro de los documentos se trata como datos del documento, no como instrucciones para el agente de codificación.
- Credenciales
- La clave de API se proporciona mediante mecanismos de configuración y de entorno. Nunca debe incluirse en instrucciones ni confirmarse en el control de versiones.
- Salida estructurada
- Los resultados de extracción estructurados son la interfaz predeterminada.
- OCR sin procesar
- El OCR sin procesar está desactivado de forma predeterminada.
Clientes probados
| Cliente | Estado | Notas |
|---|---|---|
| Codex CLI 0.147.0 | Probado | MCP stdio |
| Claude Code 2.1.231 | Probado | MCP stdio |
| Gemini CLI 0.53.0 | Probado | MCP stdio |
| Otros clientes MCP stdio | Compatible con el protocolo | No certificado individualmente |
Las versiones anteriores son las versiones de cliente con las que se verificó la integración. Otros clientes MCP stdio deberían funcionar porque el protocolo es el mismo, pero no los certificamos individualmente. DocAI no está afiliado a los proveedores de estos clientes, ni cuenta con su respaldo ni es socio suyo.
DocAI MCP beta
Qué incluye la primera beta pública:
- Un servidor MCP stdio local, distribuido en npm.
- Un instalador que configura los hosts MCP compatibles y un comando doctor que comprueba el resultado.
- Verificado con Codex, Claude Code y Gemini CLI.
- Acceso a archivos locales restringido al espacio de trabajo.
- Resultados de extracción estructurados y compactos.
- Envío de trabajos idempotente, de modo que un reintento no procesa un documento dos veces.
- Los límites de seguridad descritos anteriormente.
Beta significa que el conjunto de herramientas todavía puede cambiar entre versiones. Fije una versión en la configuración de larga duración.
Paquete
| Paquete | @synairo/docai-mcp |
|---|---|
| Editor | Synairo, la organización de npm gestionada por SYNAIRO sp. z o.o., que publica DocAI. |
| Beta actual | 0.1.0-beta.1 |
| Canal de incorporación | next |
| Requiere | Node.js 18.17 o posterior |
| npm | https://www.npmjs.com/package/@synairo/docai-mcp |
La configuración de host de larga duración generada por el instalador fija la versión exacta, por ejemplo npx -y @synairo/docai-mcp@0.1.0-beta.1 serve, nunca la etiqueta de canal next.
Los documentos procesados a través de MCP consumen el mismo saldo de páginas que la API REST, porque pasan por el mismo backend de DocAI.