ИИПодпись — MCP-сервер для ИИ-помощников
Подключите своего ИИ-помощника (Claude, Claude Code, Cursor, Битрикс24, Yandex AI Studio или собственного агента) к сервису ИИПодпись. Помощник загружает документы, готовит их к подписанию, проверяет контрагента по ИНН и прогоняет договор через риск-сканер. Отправку подписантам вы подтверждаете сами на сайте, а подпись ставит только человек по коду из письма или SMS.
- Сервер:
https://iipodpis.ru/api/mcp(Model Context Protocol, Streamable HTTP) - Вход: в один клик через окно «Разрешить» (OAuth 2.1, помощник находит его сам; поддерживаются и динамическая регистрация, и Client ID Metadata Documents — «рекомендуемый» вариант в claude.ai) или ключом из кабинета в заголовке
Authorization: Bearer <ключ> - Опубликован в официальном реестре MCP как
ru.iipodpis/iipodpis - Подробности и условия: https://iipodpis.ru/ai
Что умеет помощник
| Инструмент | Что делает |
|---|---|
list_documents | Показать PDF-документы в вашем кабинете |
upload_document | Загрузить PDF (содержимое в вызове, до 10 МБ) |
create_upload_link | Получить одноразовую ссылку на 10 минут, чтобы загрузить файл с диска без ключа |
send_for_signature | Подготовить черновик пакета на подпись: документы, подписанты, способ (email или SMS) |
package_status | Статус пакета и подписантов, ссылка на подписанный архив |
cancel_draft | Отменить черновик, который ещё не подтверждён |
check_inn | Проверить контрагента по ИНН: самозанятый ли человек (данные ФНС) и карточка ЕГРЮЛ/ЕГРИП. Только открытые сведения |
scan_contract | Риск-сканер договора по PDF из кабинета или по тексту. Бесплатный уровень как на сайте или полный платный разбор. Работает в фоне |
scan_status | Готов ли разбор: риски с пояснениями и нормами права, у полного разбора — ссылка на отчёт для человека |
Чего помощник не может
- Отправить документ подписантам без вашего подтверждения на сайте.
- Подписать документ или увидеть код подтверждения: код получает только подписант.
- Увидеть телефоны, почты и ИНН подписантов или скачать подписанные файлы от вашего имени.
- Оплатить что-либо без денег на вашем балансе: полный разбор договора списывается с баланса или из купленной пачки проверок, при нехватке помощник получает ссылку на пополнение.
Как подключить
В один клик (OAuth)
Добавьте адрес сервера в помощника. Откроется наше окно «Разрешить»: войдите или зарегистрируйтесь, примите условия и подтвердите. Ключ выпустится сам, увидеть и отозвать его можно в Профиль → «ИИ-помощник».
claude.ai — Настройки → Коннекторы → «Добавить пользовательский коннектор» → адрес https://iipodpis.ru/api/mcp → «Подключить».
Claude Code
claude mcp add --transport http iipodpis https://iipodpis.ru/api/mcp
Затем в сессии /mcp → iipodpis → Authenticate, откроется браузер с окном «Разрешить».
Cursor / VS Code — файл mcp.json (см. examples/mcp.json):
{
"mcpServers": {
"iipodpis": { "url": "https://iipodpis.ru/api/mcp" }
}
}
Ключом из кабинета
Если помощник не умеет OAuth: Профиль → вкладка «ИИ-помощник» → «Выпустить ключ». Ключ показывается один раз. Передайте его в заголовке Authorization: Bearer ВАШ_КЛЮЧ:
claude mcp add --transport http iipodpis https://iipodpis.ru/api/mcp \
--header "Authorization: Bearer ВАШ_КЛЮЧ"
Битрикс24 (MCP Hub) — в чате с AI-агентом нажмите «Подключения», выберите внешний MCP-сервер, укажите адрес сервера и заголовок Authorization с ключом.
Yandex AI Studio (MCP Hub) — «Подключить внешний MCP-сервер», адрес и заголовок Authorization: Bearer <ключ>.
Без MCP, обычный REST API:
POST https://iipodpis.ru/api/external/v1/documents # PDF до 10 МБ (multipart "file" или JSON content_base64)
POST https://iipodpis.ru/api/external/v1/uploads # одноразовая ссылка для загрузки без ключа
POST https://iipodpis.ru/api/external/v1/packages # {title, document_ids, signers[{name, email|phone}], method: "email"|"sms"}
GET https://iipodpis.ru/api/external/v1/packages/{id} # статус
DELETE https://iipodpis.ru/api/external/v1/packages/{id} # отменить черновик
Authorization: Bearer ВАШ_КЛЮЧ · Idempotency-Key: любой уникальный ключ
Примеры разговора с помощником
Загрузи
~/Документы/akt.pdfв ИИПодпись и отправь на подпись по email Ивановой Анне, anna@example.ru.
Помощник возьмёт одноразовую ссылку, загрузит файл, создаст черновик и пришлёт ссылку на страницу пакета. Вы открываете её, проверяете и нажимаете «Подтвердить отправку». Подписант получает письмо и код.
Проверь ИНН 7707083893 и скажи, кто это.
Помощник вернёт карточку из ЕГРЮЛ/ЕГРИП, а для физлица — самозанятый ли он по данным ФНС на сегодня.
Прогони договор из кабинета через риск-сканер, сначала бесплатно.
Помощник запустит бесплатный уровень и через минуту покажет найденные риски. Полный разбор с нормами и рекомендациями «что требовать» он запускает только по вашей команде, потому что он платный.
Стоимость и ограничения
Столько же, сколько на сайте, по вашему тарифу: email-подпись от 8 до 25 ₽ за подпись (на бесплатном тарифе две в месяц включены), SMS от 15 до 50 ₽. Бесплатный уровень риск-сканера — до 10 разборов в сутки. Полный разбор договора — 199 ₽ с баланса или одна проверка из купленной пачки. Проверка по ИНН бесплатна, до 30 в сутки. Если средств не хватает, помощник получит ссылку на пополнение баланса. Действуют суточные ограничения на число пакетов, документов и приглашений, чтобы зациклившийся помощник не тратил ваши деньги.
Условия подключения помощника
Ключ выдаётся лично вам и действует от вашего имени. Всё, что помощник сделает с ключом, считается сделанным вами. Ключ можно отозвать в кабинете в любой момент. Документы могут содержать персональные данные третьих лиц: вы подтверждаете, что вправе передавать их в ИИПодпись. Результаты проверки по ИНН и риск-сканера помощник получает в свой контекст, то есть они уходят провайдеру модели, которой вы пользуетесь. Данные обрабатываются на серверах в России. ИИПодпись не отвечает за решения самого помощника, например какие документы он выбрал и кого указал подписантом. Полный текст: https://iipodpis.ru/ai#terms.
Обратная связь
Вопросы и предложения: Issues этого репозитория или почта на сайте. Этот репозиторий содержит только описание подключения; исходный код сервиса не публикуется.
English
ИИПодпись (iiPodpis) is a Russian e-signature service. This MCP server lets an AI assistant (Claude, Claude Code, Cursor, Bitrix24, Yandex AI Studio or your own agent) upload PDF documents and prepare them for signing on behalf of the account owner, check a Russian counterparty by tax ID (INN) and run a contract risk scan. Sending is always confirmed by the owner on the website, and signing is done by a human with a one-time code (simple electronic signature under Russian law, 63-ФЗ).
- Server:
https://iipodpis.ru/api/mcp(Streamable HTTP), listed in the official MCP registry asru.iipodpis/iipodpis - Auth: OAuth 2.1 one-click consent screen (discovered automatically by the client; both Dynamic Client Registration and Client ID Metadata Documents are supported), or a personal API key in
Authorization: Bearer <key> - Tools:
list_documents,upload_document,create_upload_link,send_for_signature,package_status,cancel_draft,check_inn,scan_contract,scan_status - The assistant can never send to signers without owner confirmation, never sees confirmation codes or signer contacts, and cannot spend money beyond the account balance.
Connect with OAuth: in claude.ai add a custom connector with the server URL; in Claude Code:
claude mcp add --transport http iipodpis https://iipodpis.ru/api/mcp
then /mcp → iipodpis → Authenticate. Without OAuth: sign up at iipodpis.ru → Profile → "AI assistant" tab → issue a key and pass it as --header "Authorization: Bearer YOUR_KEY".
Pricing follows the website plan (email signature 8–25 RUB, SMS 15–50 RUB; two email signatures per month are free on the free plan). Free contract scan: up to 10 per day. Full paid scan: 199 RUB from the balance or one credit from a purchased pack. INN check is free, up to 30 per day. Terms: https://iipodpis.ru/ai#terms.