DocSpring

npx add-mcp 'https://mcp.docspring.com/mcp'

Открыть в Claude Открыть в ChatGPT

MCP-сервер DocSpring позволяет ИИ-ассистенту работать с вашей учетной записью DocSpring. Он может находить ваши шаблоны, заполнять их и создавать PDF-файлы и документы Word, создавать макеты страниц, редактировать поля и публиковать версии, настраивать запросы на подпись и управлять папками, вебхуками и действиями электронной почты. Это удаленный сервер, использующий Model Context Protocol: добавьте его URL в ассистент и войдите в DocSpring. Копировать API-токен не нужно.

Регион	URL MCP-сервера
США	https://mcp.docspring.com/mcp
ЕС	https://mcp-eu.docspring.com/mcp

Используйте URL региона, в котором находится ваша учетная запись. Если вы входите в DocSpring по адресу app-eu.docspring.com, ваша учетная запись находится в ЕС. В примерах ниже используется URL для США. Для ЕС укажите его URL в командах и файлах конфигурации, а сервер назовите docspring-eu, как это делает плагин DocSpring, чтобы он не заменил сервер для США с именем docspring.

Для агентов программирования (Claude Code, Codex, Copilot, Gemini CLI) плагин DocSpring добавляет MCP-сервер вместе с навыками агента DocSpring, которые обучают агента рабочим процессам DocSpring.

Подключение ассистента

Добавьте URL в ассистент, затем войдите в DocSpring в браузере и выберите, что ассистенту разрешено делать (см. раздел Доступ).

Еще нет учетной записи DocSpring? Создайте ее на странице входа, которую откроет ассистент, используя Google, GitHub или электронную почту, и подключите ее оттуда. Затем попросите ассистента создать ваш первый шаблон.

Claude

Claude.ai, Claude Desktop и мобильные приложения Claude используют одни и те же коннекторы. Эти кнопки открывают диалог Claude «Добавить пользовательский коннектор» с уже указанным URL DocSpring:

Чтобы добавить коннектор вручную, перейдите в Настройки > Коннекторы, нажмите + Добавить, затем Добавить пользовательский коннектор. Укажите DocSpring в качестве имени и URL MCP-сервера, затем нажмите Добавить и войдите в систему. В чате включите DocSpring через меню + в разделе Коннекторы.

Пользовательские коннекторы доступны на всех тарифах Claude (на бесплатном тарифе разрешен один). На тарифах Team и Enterprise владелец добавляет коннектор в Настройки организации > Коннекторы, после чего каждый участник подключает его в разделе Настройки > Коннекторы.

Claude Code

claude mcp add --transport http --scope user docspring https://mcp.docspring.com/mcp

Затем выполните /mcp в Claude Code, выберите docspring и войдите в систему. --scope user добавляет сервер для всех ваших проектов. Если вы вошли в Claude Code с подпиской Claude, коннектор DocSpring, добавленный в Claude, уже доступен.

ChatGPT

Чтобы добавить MCP-сервер в ChatGPT, нужна рабочая область Business, Enterprise или Edu; эта функция доступна только в веб-версии. В рабочей области Business сервер добавляет администратор или владелец. В ChatGPT Pro его можно добавить с инструментами только для чтения.

1. Откройте Плагины, нажмите +, затем Добавить пользовательский MCP-сервер.
2. Укажите DocSpring в качестве имени, URL MCP-сервера в качестве адреса подключения и выберите OAuth для аутентификации.
3. Подтвердите действие, нажмите Создать как плагин и войдите в DocSpring.

В чате введите @ и выберите DocSpring.

Codex

codex mcp add docspring --url https://mcp.docspring.com/mcp
codex mcp login docspring

Интерфейс командной строки Codex, его расширение для IDE и приложение ChatGPT для компьютера используют одну и ту же конфигурацию.

Cursor

Также можно добавить сервер в ~/.cursor/mcp.json (для всех проектов) или .cursor/mcp.json (для одного проекта):

{
  "mcpServers": {
    "docspring": { "url": "https://mcp.docspring.com/mcp" }
  }
}

После добавления сервера Cursor предложит войти в систему.

VS Code

Также можно выполнить команду MCP: Add Server из палитры команд и выбрать HTTP либо добавить сервер в .vscode/mcp.json:

{
  "servers": {
    "docspring": { "type": "http", "url": "https://mcp.docspring.com/mcp" }
  }
}

При первом подключении VS Code откроет браузер для входа в систему.

Другие ассистенты

Подключиться может любой MCP-клиент, поддерживающий удаленные серверы (Streamable HTTP) с входом через OAuth: Gemini CLI, Zed, Goose и другие. Добавьте URL MCP-сервера как удаленный сервер или HTTP-сервер, и при первом подключении клиент откроет страницу входа в DocSpring. Например, в Gemini CLI:

gemini mcp add --scope user --transport http docspring https://mcp.docspring.com/mcp

Доступ

При входе DocSpring предложит выбрать, что ассистенту разрешено делать. По умолчанию выбрано Чтение и запись:

Доступ	Что может делать ассистент
Только чтение	Просматривать шаблоны, папки, отправленные документы и их PDF-файлы, действия электронной почты и домены электронной почты, а также проверять данные на соответствие шаблону
Чтение и запись	Также создавать и редактировать шаблоны и их поля, публиковать версии, создавать PDF-файлы и запросы на подпись, добавлять домены электронной почты и проверять их
Полный доступ	Также удалять шаблоны, версии, папки и домены электронной почты, отзывать отправленные документы, создавать вебхуки для отправки отправленных документов и других событий на URL, а также создавать действия электронной почты для отправки PDF-файлов

Если при входе ассистент запрашивает доступ ниже полного, DocSpring покажет, что именно он запросил. Вы можете подключить его с этим уровнем доступа или отменить подключение.

Ассистент видит только инструменты, разрешенные его уровнем доступа. Их список приведен в разделе Инструменты MCP-сервера.

Каждый подключенный ассистент отображается в разделе Подключенные приложения на странице Интеграции в DocSpring. Любой пользователь учетной записи может отключить его там, и доступ прекратится сразу же. Чтобы изменить уровень доступа ассистента, отключите его и войдите снова.

Для создания рабочих PDF-файлов используются кредиты вашей учетной записи, как и при работе через API. Тестовые PDF-файлы бесплатны и содержат водяной знак; инструменты просят ассистента создавать тестовые PDF-файлы, если вы не запросите настоящий документ. При настройке полей нового шаблона автоматически используются бесплатные ИИ-страницы вашей учетной записи на месяц, а затем кредиты — так же, как в редакторе шаблонов.

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

В чате с ассистентом:

• «Создай шаблон сертификата об окончании курса с именем получателя, названием курса и датой».
• «Перечисли мои шаблоны DocSpring и покажи поля в договоре аренды».
• «Создай шаблон из https://example.com/form.pdf, настрой его поля, а затем покажи первую страницу».
• «Создай одностраничный счет как макет страницы, с таблицей позиций и итоговой суммой, а затем покажи предварительный просмотр».
• «Создай тестовый PDF счета по шаблону для Acme Corp с тремя позициями на свое усмотрение».
• «Переименуй поле name в шаблоне договора в full_name, затем опубликуй новую версию».
• «Отправь шаблон NDA на подпись сначала Джейн, затем Сэму, с напоминанием каждые 3 дня».
• «Перемести все шаблоны, в названии которых есть „Черновик“, в новую папку „Черновики“».

В агенте программирования, работающем с репозиторием вашего приложения:

• «Создай шаблон DocSpring из forms/application.pdf, настрой его поля и сгенерируй типы TypeScript для его данных».
• «Напиши код, который заполняет наш шаблон для новых сотрудников данными из записи клиента с помощью SDK DocSpring, а затем создай тестовый PDF, чтобы проверить результат».
• «Создай тестовый PDF шаблона договора аренды для каждого клиента из fixtures/customers.csv».

В ассистентах, которые предлагают команды для запросов MCP-сервера, также есть команда Создать шаблон. Она поможет создать новый шаблон по описанию или на основе вашего PDF. Команда доступна, если у ассистента есть доступ на запись. В Claude Code введите / и найдите create_template: для сервера, добавленного как docspring, это /mcp__docspring__create_template.

Безопасность

• Ассистент с доступом может читать данные отправленных документов, в том числе персональные данные. Подключайте только те ассистенты, которым ваша организация разрешает работать с такими данными.
• Текст, который читает ассистент, например PDF из интернета или данные отправленного документа, может содержать инструкции, побуждающие его неправильно использовать инструменты. Большинство ассистентов запрашивают подтверждение перед вызовом инструмента, который что-либо изменяет. Инструменты, изменяющие или удаляющие существующие данные (редактирование шаблона или его полей, переименование, перемещение, восстановление версии, изменение вебхука или действия электронной почты, удаление, отзыв), помечены как опасные, поэтому клиенты запрашивают подтверждение для каждого вызова. Выберите Только чтение, если ассистенту нужно лишь просматривать данные.
• При полном доступе ассистент управляет вашими вебхуками, которые отправляют данные отправленных документов на URL, и действиями электронной почты, которые отправляют ваши PDF-файлы. Он может изменять их все, в том числе настроенные вами, а созданные им настройки продолжат работать после его отключения. Выберите Чтение и запись, если ему не нужно управлять ими.
• Ассистенты никогда не видят секрет подписи вебхука или значения его заголовков: скопируйте секрет со страницы вебхука в DocSpring (раздел Вебхуки на боковой панели) и добавьте заголовки там.

Устранение неполадок

У ассистента нет инструментов DocSpring. Недостаточно добавить сервер — нужно также войти в систему. В Claude нажмите Подключить рядом с DocSpring в разделе Настройки > Коннекторы, затем включите его для чата через меню +. В Claude Code выполните /mcp и выберите docspring (docspring-eu для ЕС). В Codex выполните codex mcp login docspring (или docspring-eu).

При входе не находится ваша учетная запись или в списке нет ваших шаблонов. Вы подключили сервер другого региона. Если вы входите по адресу app-eu.docspring.com, подключите https://mcp-eu.docspring.com/mcp и назовите его docspring-eu; в противном случае используйте https://mcp.docspring.com/mcp.

Не хватает нужного инструмента. Ассистенту доступны только инструменты, разрешенные его уровнем доступа: при доступе Только чтение нельзя использовать инструменты, которые что-либо изменяют. Чтобы изменить уровень доступа, отключите ассистента в разделе Подключенные приложения на странице Интеграции и войдите снова. В ChatGPT Pro доступны только инструменты для чтения независимо от выбранного уровня доступа.

Новые инструменты не появляются. Некоторые ассистенты сохраняют список инструментов, доступных на момент подключения. Переподключите DocSpring или обновите список в настройках коннектора ассистента.

Ассистент вышел из системы. Это происходит, если кто-то в вашей учетной записи отключил его в DocSpring или если он не использовался в течение 90 дней. Войдите снова через ассистента: в Claude нажмите Переподключить рядом с DocSpring в разделе Настройки > Коннекторы.

Инструмент вернул processing. Создание PDF или шаблона заняло больше примерно 50 секунд. Попросите ассистента проверить результат еще раз: он использует get_submission или get_template.

Не удается создать рабочие PDF-файлы из-за ошибки с кредитами. Для рабочих PDF-файлов используются кредиты вашей учетной записи. Добавьте кредиты на странице Оплата. Если в сообщении об ошибке сказано, что PDF будет обработан после добавления кредитов, он будет создан автоматически — не запрашивайте его повторно. Тестовые PDF-файлы бесплатны, пока вы пробуете разные варианты, но за объединение PDF-файлов всегда списываются кредиты.

По другим вопросам напишите на [email protected] или воспользуйтесь формой обратной связи.

Инструменты MCP-сервера Все инструменты и необходимые для них уровни доступа