U2Ojb/
Важливий реліз: Mistral OCR тепер підтримує протокол MCP

Важливий реліз: Mistral OCR тепер підтримує протокол MCP

Author

MISTRAL OCR Team

7 червня 2025 р.

Важливий реліз: Mistral OCR тепер підтримує протокол MCP

З радістю повідомляємо, що Mistral OCR офіційно підтримує MCP (Model Context Protocol)! Це означає, що ви можете легко інтегрувати наші потужні OCR-можливості в різні AI-інструменти та середовища розробки, включаючи Cursor IDE, Claude Desktop та інші популярні додатки.

🤖 Що таке MCP?

Model Context Protocol (MCP) — це відкритий стандартний протокол від Anthropic, створений для надання AI-агентам безпечних та контрольованих можливостей виклику інструментів. Завдяки MCP, AI-моделі можуть:

  • 🔧 Викликати зовнішні інструменти та сервіси
  • 📊 Отримувати доступ до структурованих джерел даних
  • 🌐 Взаємодіяти з різними додатками
  • 🔒 Працювати в захищених середовищах (sandbox)

Простими словами, MCP дозволяє AI виходити за межі звичайних текстових діалогів та фактично "діяти" для вирішення реальних завдань.

🚀 Інтеграція Mistral OCR з MCP

Основні функції

Наш MCP-сервер надає один потужний інструмент:

🔍 extract_text — Витяг тексту

  • Випадки використання: Витяг тексту з різних документів та зображень
  • Методи введення: Дані у форматі Base64 або URL-адреси файлів
  • Формати виведення: Звичайний текст, структуровані дані JSON, Markdown
  • Швидкість обробки: Синхронна обробка з миттєвими результатами
  • Підтримувані формати: PDF, JPEG, PNG, WebP

Підтримка двох транспортних протоколів

Режим HTTP/JSON-RPC

POST https://www.mistralocr.app/api/mcp
  • ✅ Синхронні запити/відповіді
  • ✅ Підтримка CORS для міждоменних запитів
  • ✅ Ідеально підходить для веб-клієнтів
  • ✅ Аутентифікація за допомогою API-ключа

Режим SSE Streaming

GET https://www.mistralocr.app/api/mcp
  • ✅ Події, що надсилаються сервером (Server-Sent Events)
  • ✅ Двосторонній зв'язок у реальному часі
  • ✅ Обробка повідомлень на основі подій
  • ✅ Підтримка постійного з'єднання

🛠️ Посібник з інтеграції клієнта

Інтеграція з Cursor IDE / Claude Desktop

Для розробників ми спеціально оптимізували процес інтеграції з Cursor IDE та Claude Desktop:

Кроки налаштування

  1. Створіть файл конфігурації cursor_mcp_config.json:
{
  "mcp": {
    "servers": {
      "mistral-ocr": {
        "url": "https://www.mistralocr.app/api/mcp",
        "transport": "http",
        "headers": {
          "x-api-key": "mk_your_api_key_here",
          "Content-Type": "application/json"
        },
        "capabilities": { "tools": true }
      }
    }
  },
  "shortcuts": {
    "ocr": "@mistral-ocr extract_text"
  }
}
  1. Використовуйте швидкі команди в Cursor:
    • @ocr — Пряме розпізнавання OCR
    • @mistral-ocr extract_text — Повний виклик інструменту

Реальні сценарії використання

Сценарій 1: Аналіз документації до коду

Користувач: @ocr Допоможіть проаналізувати інформацію про API у цьому скріншоті документації
AI: Я проаналізую цей скріншот документації API для вас...

Сценарій 2: Обробка документів

Користувач: У мене є PDF-документ, з якого потрібно витягти текст
AI: Я можу допомогти вам витягти текст з вашого PDF-документу...

Інтеграція власного клієнта

Для розробників, яким потрібно створити власну інтеграцію, ми надаємо повні шаблони конфігурації:

{
  "mcp": {
    "servers": {
      "mistral-ocr": {
        "url": "https://www.mistralocr.app/api/mcp",
        "transport": "http",
        "authentication": {
          "type": "api_key",
          "header": "x-api-key",
          "key": "mk_your_api_key_here"
        },
        "capabilities": {
          "tools": true,
          "resources": false,
          "prompts": false
        }
      }
    }
  }
}

💡 Сценарії використання та робочі процеси

Стандартний робочий процес

graph LR
    A[Завантаження зображення/PDF] --> B[Кодування Base64 або URL]
    B --> C[extract_text]
    C --> D[Отримання текстового результату]

Підходить для: Скріншотів, зображень, документів, PDF

🔐 Аутентифікація та безпека

Підтримка різних методів аутентифікації для забезпечення безпечних викликів API:

# Метод 1: Заголовок x-api-key
x-api-key: mk_your_api_key_here

# Метод 2: Заголовок Authorization  
Authorization: Bearer mk_your_api_key_here

🧪 Швидке тестування

Тестування HTTP-ендпоінту

curl -X POST https://www.mistralocr.app/api/mcp \
  -H "Content-Type: application/json" \
  -H "x-api-key: mk_your_api_key" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

Тестування SSE-ендпоінту

curl -N -H "Accept: text/event-stream" \
  -H "x-api-key: mk_your_api_key" \
  https://www.mistralocr.app/api/mcp

🎯 Реальні кейси застосування

Кейс 1: Автоматизація технічної документації

Сценарій: Командам розробників потрібно конвертувати специфікації API з дизайн-зображень у документацію до коду

Рішення:

  1. Дизайнери завантажують зображення дизайну API
  2. Використовують MCP для виклику OCR та витягу інформації про інтерфейси
  3. AI автоматично генерує відповідну документацію до коду та тестові випадки

Кейс 2: Пакетна обробка рахунків

Сценарій: Фінансовим працівникам потрібно обробити велику кількість зображень рахунків

Рішення:

  1. Завантаження зображень рахунків
  2. OCR витягує ключову інформацію (суми, дати, постачальники)
  3. Автоматичне створення таблиць фінансових записів

Кейс 3: Допомога у наукових дослідженнях

Сценарій: Дослідникам потрібно витягти дані зі сканованих історичних документів

Рішення:

  1. Завантаження сканів документів
  2. OCR витягує текстовий вміст
  3. AI допомагає організувати та проаналізувати дослідницькі дані

🌟 Чому варто обрати інтеграцію Mistral OCR з MCP?

🚀 Технічні переваги

  • Висока точність розпізнавання: Провідна в галузі точність OCR
  • Підтримка багатьох форматів: Повний спектр PDF, JPEG, PNG, WebP
  • Швидка відповідь: Синхронна обробка з мілісекундним часом відгуку
  • Проста інтеграція: Легкі методи введення через Base64 або URL

🔧 Переваги інтеграції

  • Стандартний протокол: Відповідає відкритим стандартам MCP
  • Двоїста транспортна підтримка: Вибір між режимами HTTP та SSE
  • Plug and Play: Без складних налаштувань, швидкий старт
  • Широка сумісність: Підтримка популярних інструментів AI-розробки

💼 Бізнес-переваги

  • Економічно вигідно: Оплата за використання без фіксованих витрат
  • Масштабованість: Підтримка від особистих до корпоративних рівнів
  • Технічна підтримка: Професійна команда надає допомогу з інтеграцією
  • Постійні оновлення: Відстежує розвиток протоколу MCP

🔮 Плани на майбутнє

Ми активно розробляємо нові функції MCP:

  • 📊 Інструменти пакетної обробки: Підтримка обробки кількох файлів одночасно
  • 🎨 Попередня обробка зображень: Автоматична оптимізація якості зображень для кращого розпізнавання
  • 🔍 Інтелектуальний аналіз: Інтеграція інструментів AI-аналізу, які не лише витягують текст, а й розуміють вміст
  • 🌐 Покращення підтримки багатьох мов: Оптимізація розпізнавання для різних мов

📚 Завантаження ресурсів

Щоб допомогти вам швидко розпочати, ми підготували повні файли конфігурації:

🚀 Почніть вже зараз

Готові спробувати інтеграцію з MCP?

  1. Отримайте API-ключ: Перейти на сторінку налаштувань
  2. Перегляньте повну документацію: Документація API
  3. Приєднайтеся до спільноти: Discord-спільнота
  4. Зв'яжіться з технічною підтримкою: cc@mistralocr.app

Mistral OCR офіційно входить у нову еру екосистеми AI-інструментів завдяки підтримці протоколу MCP. Ми віримо, що ця функція значно покращить вашу продуктивність і зробить AI справжнім помічником у вашій роботі.

Почніть свою подорож з MCP вже сьогодні та разом з нами досліджуйте безмежні можливості інтеграції AI-інструментів!

Функції, описані в цій статті, вже доступні. Ласкаво просимо спробувати їх та надіслати ваші відгуки. Якщо у вас виникли запитання чи пропозиції, будь ласка, зв'яжіться з нашою технічною командою.