MCP-сервер: Documentize внутри Claude, Cursor, VS Code
Открыть приложение: Подключить MCP-сервер → (products.documentize.ai)
Кратко
MCP-сервер Documentize позволяет ИИ-ассистенту вызывать те же операции с документами, что и веб-приложения. Вы говорите: «сожми это и дай мне краткое содержание»; ассистент вызывает инструменты, ждёт завершения задач и отдаёт вам ссылки для скачивания. Страница: products.documentize.ai/pdf-mcp.
Эндпоинт и идентификация
- Эндпоинт Streamable HTTP:
https://api.documentize.app/mcp. Сервер хранит состояние: послеinitializeон возвращает заголовокMcp-Session-Id; MCP-клиенты обрабатывают это сами. - Анонимный режим работает без настройки, с крошечной дневной квотой (в репозитории указано 2 операции; проверьте актуальное значение).
- Зарегистрированные пользователи получают квоту побольше (5 в день для бесплатных аккаунтов по документации; проверьте), подписчики — платную квоту, ту же, что и на сайте.
- Чтобы вас узнавали, создайте долгоживущий ключ на странице MCP (он начинается с
dmk_, показывается один раз и хранится только в виде хеша). Передавайте его какAuthorization: Bearer dmk_.... - Клиенты, реализующие авторизацию MCP, могут использовать OAuth вместо ключа.
Одна операция — это один вызов обработки, независимо от числа файлов. Опрос статуса и инструменты аккаунта бесплатны.
Настройка клиента
Claude Desktop, claude_desktop_config.json:
{
"mcpServers": {
"documentize": {
"type": "http",
"url": "https://api.documentize.app/mcp",
"headers": { "Authorization": "Bearer dmk_your_key_here" }
}
}
}
VS Code (GitHub Copilot, режим Agent), .vscode/mcp.json:
{
"servers": {
"documentize": {
"type": "http",
"url": "https://api.documentize.app/mcp",
"headers": { "Authorization": "Bearer dmk_your_key_here" }
}
}
}
Перезапустите клиент; инструменты появятся в его списке. Уберите блок headers, чтобы подключиться анонимно. Cursor и другие клиенты используют собственные настройки MCP с тем же URL и заголовком (см. страницу MCP).
Инструменты
Имена в том виде, в каком их регистрирует сервер (tools.json):
- Конвертация и организация: ConvertDocument, MergeDocuments, SplitDocument, CompressDocument, RotateDocument, ResizeDocument, RemovePages
- Безопасность: LockDocument, UnlockDocument, SignDocument, VerifySignature
- Извлечение и поиск: ExtractText, ExtractImages, ExtractMetadata, ExtractFormData, ParseDocument, SearchInDocument
- OCR и финальная обработка: MakeSearchable, RunOcr, FlattenDocument, AddTable, AddToc, AddIllustrations
- ИИ: GenerateTableOfContents, GenerateAbstract, GenerateChecklist, AnalyzeResume, ChatWithDocument, GenerateSvg
- Пакетная обработка: ProcessBatch, WaitForTasks, ListBatchOperations
- Аккаунт: GetAccountStatus, GetSignInInstructions, SignOut
- Поток: GetTaskStatus, GetNextAppSuggestions
Каждый инструмент обработки сразу возвращает идентификатор задачи; результат приходит позже — через GetTaskStatus (одна задача) или WaitForTasks (много задач).
Пример беседы
Вы: Вот три скана (URL). Сделай из них один PDF с возможностью поиска, убери первую страницу и сожми.
Ассистент: вызывает MergeDocuments с тремя URL, затем GetTaskStatus, пока задача не завершится. Объединено. Вызывает MakeSearchable для URL результата. Вызывает RemovePages (страница 1), затем CompressDocument. Вот итоговая ссылка для скачивания. Сэкономлено примерно N МБ (ассистент назовёт реальную цифру).
Схема такая: ссылка для скачивания после каждого шага становится входом для следующего. Для 20 и более файлов ассистенту стоит использовать ProcessBatch (одна операция, применённая к файлам, до 200 за вызов, параллельно на сервере), а затем WaitForTasks, который возвращает все ссылки одним вызовом. Ожидание ограничено несколькими минутами; вызовите его снова с идентификаторами, которые ещё в работе.
Если вам отказали
Отказы написаны для модели: стабильный код ошибки и следующий шаг. quota_exceeded означает, что на сегодня квота исчерпана; credential_rejected — ключ отозван или набран с ошибкой (замените его, не повторяйте попытку); auth_required — анонимная квота потрачена. Попросите ассистента запустить GetAccountStatus, чтобы увидеть тариф и оставшиеся операции.
Предостережения
- Файлы отправляются в облако; для конфиденциальных материалов используйте self-host.
- Точные параметры инструментов клиент узнаёт у сервера; не угадывайте их, попросите ассистента вывести список (для пакетных операций — ListBatchOperations).