ИИПодпись

ИИПодпись — MCP-сервер для ИИ-помощников

English below

Подключите своего ИИ-помощника (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 Ивановой Анне, [email protected].

Помощник возьмёт одноразовую ссылку, загрузит файл, создаст черновик и пришлёт ссылку на страницу пакета. Вы открываете её, проверяете и нажимаете «Подтвердить отправку». Подписант получает письмо и код.

Проверь ИНН 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 as ru.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.