Как подключить OCR.space к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → OCR.space, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

OCR.space + Gemini

OCR.space OCR API: чтение текста изображений и PDF (чеков, счетов, сканов, скриншотов, фотографий документов) по публичной ссылке, с автоматическим определением языка, табличным режимом для чеков и экспортом в PDF с поиском. Бесплатный API-ключ.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

OCR_SPACE_API_KEY

Шаг 1 — Получите учётные данные

Настройка занимает около 1 минуты. Нужен API-ключ OCR.space: бесплатный ключ, который приходит по e-mail, или ключ тарифа PRO.

1. Запросите бесплатный API-ключ на ocr.space/ocrapi/freekey. OCR.space пришлёт его по e-mail.
2. Вставьте в OCR_SPACE_API_KEY только ключ, без пробелов и кавычек. Коннектор передаёт его в заголовке apikey.
3. Установите коннектор. Проверка при установке читает небольшое тестовое изображение, это считается одним запросом.
4. Запустите ocr_space_read_url для небольшого публичного изображения, например скриншота или фотографии чека: он вернёт текст каждой страницы.

Что он читает: текст изображений (JPG, PNG, GIF, TIF, BMP, WEBP) и PDF по публичной ссылке: чеки, счета, накладные, отсканированные письма, скриншоты и фотографии документов. ocr_space_read_url возвращает текст каждой страницы с переносами строк и коды завершения. ocr_space_make_searchable_pdf превращает скан в PDF с поиском (невидимый текстовый слой поверх оригинала) и возвращает ссылку на скачивание вместе с распознанным текстом.

Файл должен быть публичным: OCR.space сам скачивает файл, поэтому ссылка должна открываться из интернета без входа в систему. Ссылка на закрытый диск или вложение письма завершится ошибкой E217 (could not download). Если у ссылки нет расширения файла, ИИ сообщает OCR.space тип файла.

Движки и языки: движок 2 (по умолчанию) быстрый, сам определяет язык и хорошо справляется с цифрами и специальными символами. Движок 3 самый точный: более 200 языков, рукописный текст и сложная вёрстка, но он медленнее. Язык auto работает с обоими; если язык определился неверно, ИИ задаёт код, например ger, fre, ita, spa, chs или jpn.

Чеки, мелкие и повёрнутые изображения: табличный режим сохраняет чеки и таблицы построчно в порядке чтения. Увеличение помогает с мелкими или размытыми изображениями, сканами и скриншотами. Определение ориентации поворачивает фотографии правильно перед чтением.

PDF с поиском: ссылка на скачивание (SearchablePDFURL) истекает примерно через час, поэтому сохраните файл сразу. На бесплатном тарифе в PDF есть водяной знак. Текстовый слой можно показать с подсветкой или оставить невидимым в программах просмотра PDF.

Только чтение: оба инструмента только читают, хотя это POST-запросы. В вашем аккаунте OCR.space ничего не меняется, поэтому подтверждать нечего, и ни один инструмент не отключён при установке.

Ограничения: на бесплатном тарифе файл может весить до 1 МБ, а PDF содержать до 3 страниц; доступно 25 000 запросов в месяц и 500 в день с одного IP-адреса. Движок 3 на бесплатном тарифе ограничен 1000 страниц в месяц. Ключи PRO допускают 5 МБ на файл и больше страниц.

Как читать ответ: OCRExitCode 1 означает, что прочитаны все страницы, 2 часть, 3 или 4 ни одной, а ErrorMessage объясняет причину. OCR.space сообщает об ошибках обработки с HTTP 200; коннектор превращает их в неудачный вызов с сообщением OCR.space.

Частые ошибки: 403 E555 означает неверный API-ключ. 400 E400 означает, что файл не передан, E204 неверный параметр. E217 означает ссылку, которую не удаётся скачать. 429 или E500 означает, что достигнут месячный или дневной лимит: повторите позже или используйте ключ PRO.

Коннектор не загружает файлы с вашего компьютера и не читает ссылки на закрытые диски и вложения писем: он работает только с публичной ссылкой.

Шаг 2 — Установите адаптер

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

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты OCR.space.

Доступные инструменты

Примеры запросов

• «Прочитай чек по ссылке https://example.com/receipts/2026-10-14.jpg и перечисли все позиции с ценой в рублях и итоговую сумму.»
• «Достань номер, дату, поставщика и итоговую сумму из отсканированного счёта https://example.com/scans/schet-4711.pdf.»
• «Сделай из отсканированного договора аренды https://example.com/docs/dogovor-scan.pdf PDF с поиском и дай мне ссылку на скачивание.»
• «Фото накладной повёрнуто: https://example.com/photos/nakladnaya.jpg. Прочитай его и скажи, какие товары и в каком количестве там указаны.»
• «Прочитай самым точным движком рукописные заметки с доски на https://example.com/notes/whiteboard.jpg.»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT