Docspeed

Extrae campos estructurados y haz preguntas citadas sobre PDFs e imágenes a través de un servidor MCP alojado.

Servidor MCP alojado

npx add-mcp 'https://api.docspeed.ai/mcp/'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Tu agente. Herramientas documentales de Docspeed.

Lee y estructura documentos, extrae campos y tablas, haz preguntas con citas, compara evidencia documental o construye un flujo de trabajo reutilizable con Docster dentro del agente que ya usas.

Crea una cuenta Conecta tu agente

Las cuentas nuevas creadas directamente con Docspeed comienzan con 10 créditos de saldo de API. Crea una clave de API en tu panel para usarla. Las recargas de pago no están disponibles actualmente.

Conexión MCP nativa + habilidad complementaria · No se requiere ZIP ni Python

Registro oficial del MCP Registry: ai.docspeed/docspeed · 0.1.0 (JSON). Instala y conecta abajo; una lista en el registro no instala ni habilita herramientas automáticamente en tu cliente.

Conéctate ahora: no se requiere ZIP ni Python

Crea tu cuenta y tu clave de API. Abre tu proyecto de documentos en una terminal de macOS o Linux usando Bash o zsh. Ejecuta este bloque, pega la clave en el aviso oculto y presiona Enter:

printf 'Docspeed API key (input hidden): '
read -r -s DOCSPEED_API_KEY
printf '\n'
export DOCSPEED_API_KEY

La clave permanece en el entorno de esta terminal, fuera del historial de comandos y de la configuración de MCP. Mantén esta terminal abierta para la instalación y el lanzamiento; repite el aviso oculto en una terminal nueva. No pegues la clave en el chat ni en archivos compartidos. Una aplicación de escritorio lanzada por separado no hereda automáticamente la clave de esta terminal; estos pasos lanzan los clientes de terminal.

Abre una terminal en tu proyecto de documentos. Elige tu cliente instalado y pega su comando. Esto añade la conexión MCP nativa y obtiene la habilidad complementaria directamente. ¿Ya personalizaste esta habilidad? Consérvala y usa las comprobaciones de conflictos del instalador ZIP.

Codex

codex mcp add docspeed --url https://api.docspeed.ai/mcp/ --bearer-token-env-var DOCSPEED_API_KEY && \
mkdir -p .agents/skills/docspeed-documents/agents .agents/skills/docspeed-documents/scripts && \
curl --fail --silent --show-error https://api.docspeed.ai/agent-tools/skills/docspeed-documents/SKILL.md -o .agents/skills/docspeed-documents/SKILL.md && \
curl --fail --silent --show-error https://api.docspeed.ai/agent-tools/skills/docspeed-documents/agents/openai.yaml -o .agents/skills/docspeed-documents/agents/openai.yaml && \
curl --fail --silent --show-error https://api.docspeed.ai/agent-tools/skills/docspeed-documents/scripts/upload.py -o .agents/skills/docspeed-documents/scripts/upload.py

Codex registra el servidor MCP en tu configuración de usuario y la habilidad en este proyecto. Desde la misma terminal, inicia una sesión nueva aquí:

codex -c mcp_servers.docspeed.tool_timeout_sec=1200

El tiempo de espera conserva los permisos normales. Para uso recurrente, establece tool_timeout_sec = 1200 en la tabla del servidor Docspeed a continuación.

Claude Code

claude mcp add --transport http --scope project docspeed https://api.docspeed.ai/mcp/ --header 'Authorization: Bearer ${DOCSPEED_API_KEY}' && \
mkdir -p .claude/skills/docspeed-documents/scripts && \
curl --fail --silent --show-error https://api.docspeed.ai/agent-tools/skills/docspeed-documents/SKILL.md -o .claude/skills/docspeed-documents/SKILL.md && \
curl --fail --silent --show-error https://api.docspeed.ai/agent-tools/skills/docspeed-documents/scripts/upload.py -o .claude/skills/docspeed-documents/scripts/upload.py

Claude registra ambos en este proyecto. Mantén el nombre del servidor y la URL antes de --header, y conserva las comillas simples para que la configuración guardada contenga el nombre de la variable, nunca la clave. Desde la misma terminal, lanza:

MCP_TOOL_TIMEOUT=1200000 claude

Si claude mcp get docspeed muestra Aprobación pendiente, inicia la sesión interactiva de arriba, acepta el aviso de confianza del espacio de trabajo para tu proyecto y revisa y aprueba el servidor MCP del proyecto docspeed cuando se te pida. El registro por sí solo no aprueba la conexión.

Tu primer resultado fundamentado

Dentro de la nueva sesión del cliente, ingresa /mcp (no en el shell de tu terminal). Sigue los avisos normales de confianza y permisos de herramientas del cliente: revisa la conexión y luego permite la operación documental solicitada cuando tengas la intención de enviar ese documento. Confirma que Docspeed está conectado y que la habilidad docspeed-documents está disponible. Adjunta una factura autorizada y pregunta:

"Extrae el número de factura, proveedor, moneda, impuestos, total y cada línea de detalle. Muestra la página de respaldo y la evidencia de origen para cada valor. Marca los valores ausentes del documento como faltantes."

Comprueba cada valor devuelto contra el original y abre su evidencia de origen. La carga envía el documento a Docspeed y se aplican los cargos normales de procesamiento. Un servidor conectado demuestra el descubrimiento, no la precisión documental.

Si MCP aún se está conectando, la habilidad reintenta el descubrimiento una vez. Si las herramientas siguen sin estar disponibles, ofrece explícitamente la lectura nativa/local para que elijas. Ask proporciona cajas de origen que facilitan la verificación de respuestas en escaneos y documentos largos.

Lee la habilidad antes de instalar. Los comandos siguen la documentación de MCP de Codex y la documentación de MCP de Claude.

Carga un documento local con un solo comando

Con DOCSPEED_API_KEY establecido en la misma terminal, ejecuta el asistente instalado en un documento que autorices enviar a Docspeed. Se necesita Python 3.10+ para este asistente opcional, sin paquetes adicionales:

# Codex project:
python3 .agents/skills/docspeed-documents/scripts/upload.py "/absolute/path/to/document.pdf"

# Claude Code project:
python3 .claude/skills/docspeed-documents/scripts/upload.py "/absolute/path/to/document.pdf"

El asistente transmite bytes multipart directamente a POST https://api.docspeed.ai/api/v1/upload usando el campo de formulario files existente. Mantiene los bytes del documento fuera de la conversación de tu agente e imprime solo:

{"file_id":"your-returned-file-id","filename":"document.pdf"}

Entrega esa referencia a tu agente junto con tu pregunta sobre el documento. Usa file_id en el parámetro real file_id o file_ids de cada herramienta; las muestras de Docster también usan filename. Reutilízala en varias llamadas. La carga y la conexión MCP deben pertenecer a la misma cuenta.

El asistente acepta un PDF/imagen no vacío compatible de hasta 50 MiB; la API lo valida. Lee la clave solo del entorno, requiere HTTPS verificado y no sigue redirecciones ni reintentos automáticos. Si una conexión falla después de enviar bytes, el resultado de la carga puede ser desconocido; no reintentes a ciegas. No se necesita publicación de URL ni un flujo de credenciales nuevo. La carga no ejecuta extracción por sí misma.

Usa la carga directa para cualquier cosa mayor de 4 KiB. Para una entrada pequeña de files_upload solamente, este comando portátil de Python/stdin funciona en macOS y Linux y rechaza archivos más grandes:

python3 -c 'import base64,sys; data=sys.stdin.buffer.read(4097); len(data)<=4096 or sys.exit("Use direct upload for files larger than 4 KiB"); print(base64.b64encode(data).decode("ascii"))' < "/absolute/path/to/tiny.pdf"

Pasa ese resultado pequeño como content_base64 con el filename original. Nunca imprimas el base64 de un documento más grande en la conversación.

Inspecciona un resultado antes de integrarlo

Abre la factura sintética original junto con su extracción registrada. Selecciona un campo o una celda de línea de detalle para ver la región de origen exacta devuelta con ese valor y luego descarga el PDF y el JSON del resultado.

Explora el ejemplo de revisión de origen

Una ejecución registrada de Codex: se comprobaron 11 campos de factura y 15 valores de líneas de detalle contra el origen. Esto es una prueba sintética histórica, no una demostración en vivo, un resultado de cliente ni una garantía general de precisión. No se necesita clave de API ni cargo de procesamiento para inspeccionarla.

O inspecciona una sesión de preguntas y respuestas registrada con seguimiento y citas de origen. Este ejemplo de factura sintética muestra dos llamadas Ask guardadas de una verificación MCP interna, con las respuestas devueltas y las áreas de origen. No es una conversación de agente registrada ni una demostración de procesamiento en vivo.

Compara dos acuerdos sintéticos con preguntas y respuestas citadas. Esta ejecución registrada de API directa muestra una comparación del período de aviso y sus cajas de origen. La respuesta inicial sobre tarifas omite el pagador y la fecha de vencimiento; ambas limitaciones son visibles junto a los pasajes originales.

Inspecciona la evidencia. Compara un valor devuelto con el texto dentro de su caja de origen. El ejemplo conserva el cero impreso y los tipos numéricos.
Conecta las herramientas. Sigue la configuración a continuación usando tu propia cuenta y la guía completa de capacidades del paquete.
Prueba tu tarea documental. Usa el comando de carga directa para un PDF/imagen autorizado y entrega su ID de archivo devuelto a tu agente. Las entradas pequeñas también pueden usar files_upload. El MCP alojado no puede leer una ruta local ni ingerir una URL por sí solo. Se aplican los cargos normales de procesamiento.

Elige la operación que tu aplicación necesita: OCR o Parse para contenido documental; Classify y Split para paquetes; Layout, Tables, Charts o Equations para elementos de página; Schema Auto y Extract para campos; Ask para respuestas citadas; Compare para valores documentales correspondientes. Synthesize usa su API separada y no está expuesto en el catálogo MCP actual; los límites de fidelidad siguen bajo validación. Docster añade flujos de trabajo reutilizables a través de la interfaz autenticada descrita a continuación. La descarga explica las rutas y limitaciones compatibles.

MCP compare devuelve un veredicto compacto, elementos y evidencia de origen de forma predeterminada. Establece include_extractions: true para extracciones completas por documento. Ambos modos conservan la geometría de página de origen y las regiones de fundamentación sin cambios; los clientes HTTP API existentes conservan la respuesta completa de forma predeterminada.

Respaldo del instalador ZIP

Descarga el ZIP de integración. Descomprime la descarga y abre una terminal dentro de docspeed-agent-tools. Usa Python 3.10 o posterior. En Python 3.10, instala su dependencia TOML con python3 -m pip install -r requirements.txt; Python 3.11+ usa su biblioteca estándar.

Establece tu clave de API con el aviso oculto de arriba, luego ejecuta el asistente y lanza tu cliente desde esa misma terminal. Mantén la clave fuera del chat y de los archivos compartidos.

1. Comprueba la conexión

python3 scripts/setup.py check --catalog-out /tmp/docspeed-tools.json

La comprobación autentica, inicializa MCP y lista las herramientas disponibles. No carga un documento ni ejecuta extracción.

2. Instala para tu cliente

python3 scripts/setup.py install --client codex --project /absolute/path/to/your/project

# For Claude Code:
python3 scripts/setup.py install --client claude --project /absolute/path/to/your/project

El instalador añade la conexión del proyecto y la habilidad, conserva configuraciones no relacionadas y almacena solo el nombre de la variable de credencial. Los conflictos con configuraciones existentes de Docspeed requieren revisión manual.

3. Inicia una sesión nueva

Abre el proyecto en tu agente, sigue sus controles normales de confianza y permisos, e inspecciona /mcp. La conexión debe estar activa antes de que se puedan seleccionar las herramientas. Instalar el paquete no inyecta herramientas en una conversación existente.

Configuración MCP directa opcional para Codex

Para clientes Codex con Code Mode, añade --codex-direct-mcp al comando del instalador para exponer el espacio de nombres DocSpeed directamente. Esta configuración se usó en una llamada MCP nativa registrada con Codex CLI 0.159.2; no es un requisito universal ni una garantía de selección. El catálogo completo sigue disponible y tu modelo, confianza y configuraciones de aprobación permanecen sin cambios. Revisa las configuraciones personalizadas existentes de Code Mode antes de fusionar el fragmento config/codex-direct-mcp.toml incluido.

Los servidores de proyecto de Claude Code también necesitan la aprobación MCP normal del cliente. Una conexión MCP saludable es distinta del acceso a un modelo de Claude.

Pide el resultado que necesitas

"Extrae el proveedor, número de factura, impuestos, total y cada línea de detalle de este PDF. Incluye evidencia para cada valor."

"En estos PDF de pólizas, ¿qué exclusiones aplican a daños por inundación? Cita las páginas relevantes."

"Construye un flujo de trabajo reutilizable de conciliación de facturas, órdenes de compra y recibos con una pantalla de revisión y un endpoint de API."

La habilidad complementaria ayuda al agente a reconocer estas tareas incluso cuando no mencionas Docspeed. La selección aún depende de la solicitud, las herramientas disponibles y los permisos. Las elecciones explícitas de proveedor y los requisitos solo locales tienen prioridad.

Crea con Docster

Las construcciones de flujos de trabajo de Docster están disponibles para cuentas autenticadas de Docspeed que usen una clave de API estándar de Docspeed. Se aplican cargos normales de uso y validación de flujos de trabajo.

Ejecuta python3 scripts/setup.py check --require-docster para requerir la interfaz completa de construcción, estado, revisión e invocación. Si esas herramientas faltan, la implementación conectada no puede aceptar una transferencia de Docster.

docster_build comienza con aclaraciones, conserva un attempt_id y luego construye el flujo de trabajo solicitado. Comprueba docster_status y su evidencia de validación; una solución está lista solo cuando su estado es ready. Usa docster_revise para actualizarla y docster_invoke para ejecutarla en documentos nuevos cargados.

Las herramientas documentales se ejecutan de forma síncrona. Las APIs heredadas de definición de agente y de trabajos no están expuestas a través de este catálogo MCP. Construir un flujo de trabajo privado no lo publica ni autoriza enviar resultados a otras personas.

Conexión manual

Endpoint HTTP de transmisión: https://api.docspeed.ai/mcp/. La autenticación usa una clave de API de Docspeed como token de portador. Conserva la barra diagonal final.

Configuración de Codex

[mcp_servers.docspeed]
url = "https://api.docspeed.ai/mcp/"
bearer_token_env_var = "DOCSPEED_API_KEY"
startup_timeout_sec = 30
tool_timeout_sec = 1200

Añade esto a tu .codex/config.toml de proyecto o a la configuración de usuario. La descarga también contiene la configuración de Claude Code, manifiestos de complementos portátiles, la habilidad complementaria y un ejecutor de evaluación de enrutamiento.

Entradas y evidencia

La producción admite PDF, PNG, JPEG/JPG, TIFF/TIF, WebP, BMP y GIF. El TIFF de varias páginas está indexado por página. Los flujos de trabajo nativos de Word/Excel (DOCX/XLSX) están disponibles a través de APIs beta separadas contactando a Docspeed.

La carga envía los documentos seleccionados a Docspeed; usa solo archivos autorizados para el flujo de trabajo. El procesamiento y las construcciones usan tu cuota y facturación normales de API. Los resultados fundamentados conservan sus regiones de origen; los valores faltantes y las fallas de procesamiento deben permanecer explícitos. Una verificación de conexión exitosa demuestra el descubrimiento, no la precisión de los documentos ni la finalización del flujo de trabajo. La evaluación de selección incluida mide las decisiones de enrutamiento por separado de la ejecución real de herramientas y la calidad de los documentos.

Guía completa incluida en la descarga · Referencia de MCP para Codex · Referencia de MCP para Claude Code