MCP-сервер DOKIVO: документы для AI-клиентов

Что доступно

MCP не запускает отдельный движок. Он вызывает существующие 66 операций через тот же admission, что и REST API: те же квоты, проверки форматов, изолированная обработка и срок результата.

Каталог операций и полные схемы полей доступны через dokivo_list_operations и dokivo_get_operation. Отдельного MCP-каталога нет — это те же операции, что на сайте. Баланс кредитов возвращает dokivo_get_credits.

Подключение за три шага

1. Создайте ключ. Войдите в аккаунт с подтверждённой почтой, откройте «Сценарии → Подключения → API» и создайте ключ на 30 или 90 дней. Ключ dki_… показывается один раз.
2. Добавьте MCP-сервер в клиент. Укажите URL https://dokivo.ru/mcp и заголовок Authorization: Bearer dki_…. Подходит для клиентов, поддерживающих Streamable HTTP и JSON-RPC 2.0.
3. Проверьте на своём файле. Сначала dokivo_create_run, затем dokivo_get_run и dokivo_get_result. Результат скачивается по ссылке с тем же ключом.

{
  "mcpServers": {
    "dokivo": {
      "url": "https://dokivo.ru/mcp",
      "headers": { "Authorization": "Bearer dki_..." }
    }
  }
}

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

curl -s https://dokivo.ru/mcp \
  -H 'Authorization: Bearer dki_...' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "dokivo_create_run",
      "arguments": {
        "operation": "compress-pdf",
        "options": { "compression": "balanced" },
        "files": [{
          "name": "scan.pdf",
          "contentBase64": "JVBERi0xLjQK..."
        }]
      }
    }
  }'

Ответ содержит runId и state. Дальше — dokivo_get_run до завершения и dokivo_get_result для ссылки, размера и SHA-256. Байты документа в ответ MCP не включаются.

Стоимость

API и MCP работают на предоплаченных кредитах. Один кредит — успешная стандартная операция с документом до 10 МБ; OCR и Office — коэффициент 3. Ошибка, отмена и повторный idempotent-запрос не списываются.

Оплата картой или по счёту для организации — в кабинете. Счёт формируется сразу, кредиты начисляются после подтверждения оплаты.

Купить кредиты

Ограничения

• До 10 файлов на запуск; до 12 МиБ на файл и 16 МиБ суммарно.
• Тело запроса — до 24 МБ; для больших файлов используйте REST multipart.
• Результат доступен 15 минут, для OCR — 30 минут; история запусков — 7 дней.
• Ключ действует 1–90 дней; одновременно можно иметь до пяти действующих ключей.
• Не более 600 MCP-запросов с одного IP в час и не более четырёх одновременных запросов.
• MCP не обходит квоты, лимиты аккаунта и проверки форматов.

Безопасность и данные

Ключ даёт только доступ к запускам и результатам своего аккаунта: runs:read и runs:write. Управление аккаунтом, сценариями и платежами через MCP недоступно.

Файл принимается только для выбранной операции и удаляется после скачивания, ошибки или истечения срока. Постоянного хранилища нет. Обработка выполняется в изолированном контейнере, как и для сайта. Подробнее — обработка и удаление.

Тело больше 64 КиБ требует действующий ключ до чтения; запрос ограничен 120 секундами; при необходимости endpoint отключается переменной MCP_ENABLED=0.

Кому подходит

• AI-ассистенту, который готовит комплект документов или извлекает таблицу и должен получить проверяемый файл.
• Интегратору, который соединяет DOKIVO с CRM, 1С, Bitrix24 или n8n через MCP-клиент.
• Команде, которой нужен повторяемый документный процесс с ключом, лимитами и аудитом.

Совместимость конкретной версии Claude Desktop, Cursor, n8n или другого клиента проверяйте на своей цепочке: MCP-стандарт не гарантирует одинаковое поведение всех клиентов.