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

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

BoldSign + Gemini

Электронные подписи BoldSign в регионе США, ЕС, Канада или Австралия: поиск документов и проверка, кто уже подписал, загрузка подписанных PDF и журналов аудита, отправка файлов и шаблонов на подпись, напоминания, продление срока, замена подписантов и предзаполнение полей, а также просмотр шаблонов, отправителей-доверителей, контактов, команд, пользователей, брендов и API-кредитов.

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

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

BOLDSIGN_API_URL, BOLDSIGN_API_KEY

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

Настройка занимает около 2 минут. Нужен тариф BoldSign с API или бесплатный аккаунт Sandbox.

1. Войдите в BoldSign (https://app.boldsign.com, аккаунты ЕС https://app-eu.boldsign.com) и откройте в левом меню API, затем API Key.
2. Нажмите Generate API Key, выберите Sandbox (бесплатно, документы с водяным знаком, 50 запросов в час) или Live, при желании задайте срок действия и скопируйте ключ в BOLDSIGN_API_KEY. Он передаётся в заголовке X-API-KEY и имеет все права.
3. Укажите в BOLDSIGN_API_URL адрес API региона вашего аккаунта, без косой черты в конце: https://api.boldsign.com (США), https://api-eu.boldsign.com (ЕС), https://api-ca.boldsign.com (Канада) или https://api-au.boldsign.com (Австралия). Регион видно по адресу в браузере после входа: app-eu означает ЕС, app-ca Канаду, app-au Австралию, просто app США.
4. Установите коннектор и запустите boldsign_list_documents, чтобы проверить ключ и регион.

Поиск документов и проверка подписей:

• boldsign_list_documents показывает отправленные и полученные вами документы, начиная с новых, со статусом, отправителем, статусом каждого подписанта, копиями, метками и датами. Фильтры: текст, status (WaitingForMe, WaitingForOthers, NeedAttention, Completed, Declined, Revoked, Expired, Draft, Scheduled), transmit_type (Sent, Received, Both), период по дате отправки или истечения, метки, бренды, email отправителя или подписанта.
• boldsign_list_team_documents показывает документы вашей команды (для администраторов команд: команд, которыми они управляют), с фильтром по команде и пользователю. boldsign_list_behalf_documents показывает документы, отправленные от имени других через sender identity, или отправленные другими от вашего имени.
• boldsign_get_document читает документ целиком: файлы, каждого подписанта с порядком, статусом, отметкой о просмотре, аутентификацией и значениями полей, копии, историю событий, срок, настройки напоминаний и причину отзыва или отказа, если она есть.

Подписанные файлы: boldsign_download_document возвращает подписанный PDF, когда документ завершён, а до этого его текущее состояние; несколько файлов приходят одним объединённым PDF или, с форматом Individually, архивом ZIP. boldsign_download_audit_log возвращает PDF журнала аудита с каждым событием (отправлен, просмотрен, подписан, отклонён), временем, email и IP-адресом. Для документов, отправленных от чьего-то имени, укажите email sender identity в on_behalf_of.

Отправка на подпись:

• Из шаблона: boldsign_list_templates, затем boldsign_get_template для индексов ролей и id полей, затем boldsign_send_from_template с одной записью в roles на каждую роль (roleIndex, signerName, signerEmail, по желанию existingFormFields для предзаполнения). Неуказанные роли сохраняют подписанта шаблона по умолчанию; role_removal_indices убирает роли из этого документа.
• Файл: boldsign_send_document принимает файлы PDF, Word или изображения как публичные URL в file_urls (BoldSign скачивает их сам) или как data URI в Base64 в files, но не то и другое сразу. У каждого подписанта есть name, emailAddress и необязательные signerOrder, signerType (Signer, Reviewer или InPersonSigner) и formFields (Signature, Initial, CheckBox, TextBox, DateSigned, RadioButton, Dropdown, Name, Email, каждое со страницей и bounds). Вместо расстановки полей можно использовать текстовые теги в документе (use_text_tags) или поручить BoldSign превратить в поля имеющиеся поля форм и пустые линии (auto_detect_fields).
• Оба инструмента принимают заголовок и сообщение, копии, порядок подписания, срок (по умолчанию Days, 60 дней; также Hours или SpecificDateTime), автоматические напоминания, бренд, метки и on_behalf_of для sender identity со статусом Verified. С disable_emails письма не отправляются; тогда boldsign_get_embedded_sign_link выдаёт прямую ссылку на подписание для каждого подписанта, при желании с ограниченным сроком и адресом перенаправления. boldsign_send_draft отправляет документ, сохранённый как черновик.
• Отправка асинхронная: ответ сразу содержит documentId, а чуть позже boldsign_get_document показывает, ушёл ли документ (неудачная отправка видна в истории).

Отправка настоящая: отправка, напоминания, замена подписанта и создание sender identity рассылают письма реальным людям, документ Live имеет юридическую силу и может расходовать API-кредиты. ИИ показывает вам файл или шаблон, подписантов и сообщение и отправляет только после вашего явного «да».

Дальнейшие действия: boldsign_remind_document напоминает всем, кто ещё не подписал, или только указанным email. boldsign_extend_expiry переносит срок документа в работе: дата yyyy-MM-dd для срока в днях, число часов для срока в часах, дата-время ISO 8601 для конкретного срока. boldsign_change_recipient заменяет подписанта, который ещё не подписал, а причина записывается в журнал аудита. boldsign_prefill_fields задаёт значения полей до того, как их заполнят подписанты (id полей из boldsign_get_document).

Аккаунт: sender identities через boldsign_list_sender_identities, boldsign_get_sender_identity и boldsign_create_sender_identity (BoldSign отправляет человеку запрос на одобрение по email; использовать identity можно, когда её статус Verified, возможные статусы Pending, Verified и Denied). Контакты через boldsign_list_contacts, boldsign_get_contact, boldsign_create_contacts и boldsign_update_contact. Команды, пользователи (роль Admin, TeamAdmin или Member, статус Active или Invited) и бренды доступны только для чтения. boldsign_get_api_credits показывает остаток кредитов и сколько из них израсходовано.

Отключены при установке: boldsign_revoke_document (останавливает подписание и сообщает подписантам причину; продолжить документ нельзя) и boldsign_delete_document (перемещает его в корзину или с delete_permanently удаляет навсегда). Ни то, ни другое нельзя отменить, поэтому администратор workspace включает их, когда они нужны команде.

Форматы данных: id это строки GUID (documentId, templateId). Даты вроде createdDate, activityDate и expiryDate это Unix-время в секундах; фильтры принимают ISO 8601 (2026-10-01T00:00:00Z). Статус документа: InProgress, Completed, Declined, Expired, Revoked, Draft или Scheduled; статус подписанта: NotCompleted, Completed, Declined, Revoked или Expired. Роли шаблона нумеруются с 1. bounds полей (x, y, width, height) отсчитываются от левого верхнего угла страницы, а id полей состоят только из букв, цифр и подчёркиваний.

Пагинация: инструменты списков принимают page (с 1) и page_size (от 1 до 100, по умолчанию 10) и возвращают pageDetails с totalRecordsCount и totalPages, а сами записи в result (results для команд). Дальше 10 000 документов ИИ передаёт cursor последнего документа как next_cursor.

Ограничения: 2 000 запросов в час на аккаунт в Live и 50 в Sandbox, ключ API и OAuth считаются вместе. Документы Sandbox получают водяной знак. На тарифах с кредитами каждый документ, отправленный через API, расходует кредиты.

Частые ошибки: 401 означает неверный или просроченный ключ либо ключ, использованный с адресом другого региона. 403 означает, что тариф не включает API или пользователю не разрешено видеть объект. 400 приходит с сообщением при неверных данных, например неизвестном индексе роли, отсутствующем email подписанта или файле, который BoldSign не может прочитать. 429 означает, что часовой лимит исчерпан; подождите до X-RateLimit-Reset.

Коннектор не создаёт и не редактирует шаблоны, не управляет вебхуками, не создаёт команды, пользователей или бренды и не удаляет контакты.

Шаг 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 теперь может вызывать инструменты BoldSign.

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

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

• «Какие документы всё ещё ждут подписи других, и кто именно ещё не подписал?»
• «Подписала ли [email protected] NDA, который мы отправили в понедельник? Покажите историю событий.»
• «Скачайте подписанный PDF и журнал аудита договора на оказание услуг с Acme.»
• «Отправьте наш шаблон договора с фрилансером на [email protected] в роли исполнителя. Перед отправкой покажите роли и сообщение.»
• «Напомните неподписавшим по договору аренды и продлите срок до 30 ноября.»

FAQ

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

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

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Meta Muse
• Подключить к Microsoft Copilot