Подключить DocuSign MCP к Microsoft Copilot

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

DocuSign + Microsoft Copilot

Дайте ИИ работать с DocuSign eSignature: находить конверты и проверять, кто уже подписал, читать получателей, документы, данные форм и журнал аудита, отправлять документы или шаблоны на подпись, повторно отправлять или аннулировать конверты и просматривать шаблоны. Демо или рабочий аккаунт, вход от имени пользователя DocuSign.

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

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

DOCUSIGN_CLIENT_ID, DOCUSIGN_CLIENT_SECRET, DOCUSIGN_AUTH_URL, DOCUSIGN_BASE_URI, DOCUSIGN_ACCOUNT_ID

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

1. Заведите бесплатный аккаунт разработчика (демо) на docusign.com/developers/sandbox или используйте рабочий аккаунт. Откройте Apps and Keys: admindemo.docusign.com/apps-and-keys для демо, admin.docusign.com/apps-and-keys для рабочего аккаунта (или Settings → Integrations → Apps and Keys).
2. Нажмите Add App and Integration Key и задайте название, например «AnythingMCP». В разделе User Application → Authentication method ответьте Yes на вопрос «Is your application able to securely store a client secret?» (Authorization Code Grant).
3. Нажмите Add Secret Key и сразу скопируйте ключ: он показывается только один раз. Вставьте его в DOCUSIGN_CLIENT_SECRET, а Integration Key (GUID) в DOCUSIGN_CLIENT_ID.
4. В разделе Redirect URIs добавьте https://cloud.anythingmcp.com/api/mcp-oauth/callback. Если вы размещаете AnythingMCP сами, укажите вместо него https://your-anythingmcp-host/api/mcp-oauth/callback. URI должен совпадать в точности. Сохраните; изменения могут вступить в силу через 5 минут.
5. На той же странице в разделе My Account Information скопируйте API Account ID (GUID, а не короткий номер аккаунта) в DOCUSIGN_ACCOUNT_ID и Account's Base URI (например, https://demo.docusign.net или https://eu.docusign.net, без /restapi и без косой черты в конце) в DOCUSIGN_BASE_URI.
6. Укажите в DOCUSIGN_AUTH_URL адрес https://account-d.docusign.com для демо-аккаунта или https://account.docusign.com для рабочего.
7. Установите коннектор, нажмите Authorize with Provider на странице коннектора и войдите в DocuSign.
8. Начните с docusign_get_user_info: он показывает все аккаунты, доступные этому пользователю, с их account_id и base_uri. Если они отличаются от DOCUSIGN_ACCOUNT_ID или DOCUSIGN_BASE_URI, исправьте переменные. Base URI привязан к аккаунту и может измениться, когда DocuSign переносит аккаунт.

Переход в рабочую среду: новый Integration Key работает только в демо. Для рабочего аккаунта выберите Actions → Start Go-Live Review на демо-странице Apps and Keys. Затем в рабочем аккаунте снова добавьте секретный ключ (для DOCUSIGN_CLIENT_SECRET) и Redirect URI, потому что они не переносятся, и переключите DOCUSIGN_AUTH_URL, DOCUSIGN_BASE_URI и DOCUSIGN_ACCOUNT_ID на рабочие значения.

Как не потерять авторизацию: коннектор запрашивает scopes signature и extended. Access-токены действуют 8 часов и обновляются автоматически; при каждом обновлении выдаётся новый refresh-токен, действующий 30 дней, поэтому коннектор остаётся авторизованным, пока им пользуются хотя бы раз в месяц. После более долгого перерыва или если вход был отозван, снова нажмите Authorize with Provider.

Разрешения и режим только для чтения: коннектор работает от имени пользователя DocuSign, который выполнил вход, в пределах его прав. Для режима только для чтения отключите docusign_create_envelope_from_template, docusign_create_envelope_with_document, docusign_send_draft_envelope, docusign_resend_envelope и docusign_void_envelope.

Выключены при установке: docusign_move_envelope_to_trash, который перемещает конверты в папку Deleted. Черновик при этом удаляется, а уже отправленный конверт аннулируется (voided). Восстановить его можно в течение 24 часов. Включайте его, только если ИИ должен наводить порядок в конвертах.

Отправка настоящая: отправленный конверт рассылает каждому получателю запрос на подпись по электронной почте от имени вашей компании. docusign_create_envelope_from_template и docusign_create_envelope_with_document создают черновик, если им не сказано отправить, а docusign_send_draft_envelope, docusign_resend_envelope и docusign_void_envelope работают с реальными получателями. ИИ заранее сообщает, кто что получит, и ждёт вашего согласия. Аннулировать можно только конверты, ожидающие подписи, и отменить аннулирование нельзя.

Документы и шаблоны: документы проходят через диалог, поэтому делайте их небольшими (весь запрос ограничен примерно 35 МБ). docusign_download_document возвращает один документ, все документы одним PDF или сертификат о завершении; файлы больше примерно 1,5 МБ приходят обрезанными, а DocuSign разрешает лишь несколько скачиваний одного и того же документа в час. Для docusign_get_form_data нужна настройка аккаунта, которая разрешает отправителям скачивать данные форм. Чтобы отправить конверт по шаблону, каждой роли в шаблоне нужны имя и адрес электронной почты.

Лимиты: 3000 вызовов API в час на аккаунт, общие для всех интеграций, и пики до 500 вызовов за 30 секунд (200 в демо). DocuSign просит проверять один и тот же конверт не чаще раза в 15 минут.

Частые ошибки: 401 AUTHORIZATION_INVALID_TOKEN или USER_AUTHENTICATION_FAILED означает, что авторизация истекла или отозвана либо DOCUSIGN_AUTH_URL не соответствует среде (account-d для демо, account для рабочего аккаунта): проверьте значение, затем снова нажмите Authorize with Provider. 400 USER_LACKS_MEMBERSHIP или 404 означает, что DOCUSIGN_ACCOUNT_ID или DOCUSIGN_BASE_URI не относится к вошедшему пользователю: сравните их с результатом docusign_get_user_info. 400 TEMPLATE_ROLE_NAME_MISMATCH означает имя роли, которого нет в шаблоне, INVALID_EMAIL_ADDRESS_FOR_RECIPIENT недопустимый адрес получателя, а ENVELOPE_CANNOT_VOID_INVALID_STATE конверт, который не ожидает подписи. 429 или HOURLY_APIINVOCATION_LIMIT_EXCEEDED означает, что исчерпан часовой лимит: дождитесь следующего часа.

Коннектор не работает со встроенным подписанием и отправкой (embedded views), PowerForms, массовой рассылкой (bulk send) и вебхуками Connect и не изменяет шаблоны, пользователей и настройки аккаунта.

Шаг 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 — Добавьте коннектор в Microsoft Copilot

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Microsoft Copilot использует MCP-серверы через агентов, созданных в Copilot Studio: ты добавляешь AnythingMCP в агента как инструмент, а затем публикуешь агента в Microsoft 365 Copilot и Teams. Copilot Studio подключается из облака Microsoft по Streamable HTTP, который AnythingMCP поддерживает.

1. В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
2. Укажи Server name (например, AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер.
3. В аутентификации выбери API key, установи Type в Header, укажи имя заголовка X-API-Key и нажми Create.
4. В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
5. Проверь в панели Test агента: попроси о том, для чего нужны инструменты DocuSign.
6. Нажми Publish, затем Channels → Microsoft 365 and Microsoft Teams, оставь включённым Make agent available in Microsoft Copilot и нажми Add channel. See agent in Teams установит агента для тебя; в Microsoft 365 Copilot введи @ и выбери агента.

Хочешь, чтобы каждый входил под своей учётной записью? Вместо API-ключа выбери OAuth 2.0 → Dynamic discovery: каждый пользователь войдёт в AnythingMCP при первом вызове агентом.

Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Copilot Studio подключается из облака Microsoft, поэтому localhost не подойдёт.

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

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

• «Какие конверты, отправленные за последние 30 дней, всё ещё ждут подписи и кто ещё не подписал?»
• «Покажи журнал аудита договора на обслуживание с ООО «Акме»: когда его открыли и когда подписали?»
• «Что подписант ввёл в поля анкеты поставщика от Northwind?»
• «Подготовь черновик по нашему шаблону «Mutual NDA» для Анны Ивановой ([email protected]) и покажи, кто что получит, прежде чем что-либо отправлять.»

FAQ

Для какого Copilot это руководство? Для Microsoft 365 Copilot на работе — через агентов Copilot Studio. В приложении Microsoft Copilot для личных аккаунтов добавить свой MCP-сервер нельзя.

Что нужно? Рабочий аккаунт с доступом к Copilot Studio (лицензия или пробная версия), чтобы создать агента. Тем, кто будет пользоваться им в Microsoft 365 Copilot или Teams, нужен доступ к агенту: поделись им или попроси администратора опубликовать его для организации. Если в организации действуют политики данных для коннекторов Power Platform, они распространяются и на MCP-серверы.

Агент не вызывает инструменты. Проверь, что имя заголовка — ровно X-API-Key, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.

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

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