Cómo conectar OCR.space a Microsoft Copilot vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → OCR.space, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

OCR.space + Microsoft Copilot

OCR.space OCR API: lee el texto de imágenes y PDF (tickets, facturas, escaneos, capturas de pantalla, fotos de documentos) desde una URL pública, con detección automática del idioma, modo tabla para tickets y exportación a PDF con búsqueda. Clave de API gratuita.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

OCR_SPACE_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva alrededor de 1 minuto. Necesitas una clave de API de OCR.space: una clave gratuita, que llega por e-mail, o la clave de un plan PRO.

1. Pide una clave de API gratuita en ocr.space/ocrapi/freekey. OCR.space te la envía por e-mail.
2. Pega solo la clave en OCR_SPACE_API_KEY, sin espacios ni comillas. El conector la envía en la cabecera apikey.
3. Instala el conector. La comprobación de la instalación lee una pequeña imagen de ejemplo, que cuenta como una petición.
4. Ejecuta ocr_space_read_url con una imagen pública pequeña, por ejemplo una captura de pantalla o la foto de un ticket: devuelve el texto de cada página.

Qué lee: el texto de imágenes (JPG, PNG, GIF, TIF, BMP, WEBP) y PDF en una URL pública: tickets, facturas, albaranes, cartas escaneadas, capturas de pantalla y fotos de documentos. ocr_space_read_url devuelve un texto por página, con saltos de línea, más los códigos de salida. ocr_space_make_searchable_pdf convierte un escaneo en un PDF con búsqueda (una capa de texto invisible sobre el original) y devuelve el enlace de descarga junto con el texto reconocido.

El archivo debe ser público: OCR.space descarga el archivo por su cuenta, así que la URL debe abrirse desde internet sin iniciar sesión. Un enlace a una unidad privada o a un adjunto de e-mail falla con E217 (could not download). Si la URL no tiene extensión, la IA le indica a OCR.space el tipo de archivo.

Motores e idiomas: el motor 2 (el predeterminado) es rápido, detecta el idioma solo y maneja bien los números y los caracteres especiales. El motor 3 es el más preciso, con más de 200 idiomas, escritura a mano y diseños complejos, pero es más lento. El idioma auto funciona con ambos; si se equivoca de idioma, la IA indica un código como ger, fre, ita, spa, chs o jpn.

Tickets, imágenes pequeñas y giradas: el modo tabla mantiene tickets y tablas línea a línea en orden de lectura. El escalado ayuda con imágenes pequeñas o borrosas, escaneos y capturas. La detección de orientación endereza las fotos giradas antes de leerlas.

PDF con búsqueda: el enlace de descarga (SearchablePDFURL) caduca después de una hora más o menos, así que guarda el archivo pronto. Con el plan gratuito el PDF lleva una marca de agua. La capa de texto se puede mostrar resaltada o mantener invisible en los visores de PDF.

Solo lectura: las dos herramientas solo leen, aunque sean peticiones POST. No cambia nada en tu cuenta de OCR.space, así que no hay nada que confirmar y ninguna herramienta está desactivada al instalar.

Límites: con el plan gratuito un archivo puede pesar hasta 1 MB y un PDF tener hasta 3 páginas, con 25.000 peticiones al mes y 500 al día por dirección IP. El motor 3 está limitado a 1.000 páginas al mes en el plan gratuito. Las claves PRO permiten 5 MB por archivo y más páginas.

Leer la respuesta: OCRExitCode 1 significa que se leyeron todas las páginas, 2 algunas, 3 o 4 ninguna, y ErrorMessage explica por qué. OCR.space informa de los errores de procesamiento con HTTP 200; el conector los convierte en una llamada fallida con el mensaje de OCR.space.

Errores comunes: 403 E555 significa que la clave de API es incorrecta. 400 E400 indica que no se pasó ningún archivo, E204 un parámetro incorrecto. E217 es una URL que no se puede descargar. 429 o E500 indica que se alcanzó el límite mensual o diario: vuelve a intentarlo más tarde o usa una clave PRO.

El conector no sube archivos desde tu ordenador ni puede leer enlaces a unidades privadas o adjuntos de e-mail: solo trabaja con una URL pública.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Microsoft Copilot

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de OCR.space.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

Herramientas disponibles

Ejemplos de prompts

• "Lee el ticket de https://example.com/tickets/2026-10-14.jpg y dame cada producto con su precio en euros, más el total."
• "Saca el número de factura, la fecha, el proveedor y el importe total de la factura escaneada en https://example.com/escaneos/factura-4711.pdf."
• "Convierte el contrato de alquiler escaneado en https://example.com/docs/contrato-escaneado.pdf en un PDF con búsqueda y pásame el enlace de descarga."
• "La foto de este albarán está girada: https://example.com/fotos/albaran.jpg. Léela y dime qué artículos y cantidades aparecen."
• "Usa el motor más preciso para leer las notas escritas a mano de la pizarra en https://example.com/notas/reunion.jpg."

FAQ

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse