iipodpis-mcp

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

[English below](#english)

Подключите своего ИИ-помощника (Claude, Cursor, Битрикс24, Yandex AI Studio или собственного агента) к сервису [ИИПодпись](https://iipodpis.ru). Помощник загружает документы и готовит их к подписанию от вашего имени. Отправку подписантам вы подтверждаете сами на сайте, а подпись ставит только человек по коду из письма или SMS.

- Сервер: `https://iipodpis.ru/api/mcp` (Model Context Protocol, Streamable HTTP)
- Авторизация: ключ из личного кабинета, заголовок `Authorization: Bearer <ключ>`
- Подробности и условия: <https://iipodpis.ru/ai>

## Что умеет помощник

| Инструмент | Что делает |
|---|---|
| `list_documents` | Показать PDF-документы в вашем кабинете |
| `upload_document` | Загрузить PDF (содержимое в вызове, до 10 МБ) |
| `create_upload_link` | Получить одноразовую ссылку на 10 минут, чтобы загрузить файл с диска без ключа |
| `send_for_signature` | Подготовить черновик пакета на подпись: документы, подписанты, способ (email или SMS) |
| `package_status` | Статус пакета и подписантов, ссылка на подписанный архив |
| `cancel_draft` | Отменить черновик, который ещё не подтверждён |

## Чего помощник не может

- Отправить документ подписантам без вашего подтверждения на сайте.
- Подписать документ или увидеть код подтверждения: код получает только подписант.
- Увидеть телефоны, почты и ИНН подписантов или скачать подписанные файлы от вашего имени.

## Как подключить

1. Зарегистрируйтесь на [iipodpis.ru](https://iipodpis.ru), откройте Профиль → вкладка «ИИ-помощник» → «Выпустить ключ». Ключ показывается один раз.
2. Вставьте адрес сервера и ключ в своего помощника.

**Claude Code**

```bash
claude mcp add --transport http iipodpis https://iipodpis.ru/api/mcp \
  --header "Authorization: Bearer ВАШ_КЛЮЧ"
```

**Cursor / VS Code** — файл `mcp.json` (см. [examples/mcp.json](examples/mcp.json)):

```json
{
  "mcpServers": {
    "iipodpis": {
      "url": "https://iipodpis.ru/api/mcp",
      "headers": { "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.

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

## Стоимость и ограничения

Столько же, сколько на сайте, по вашему тарифу: email-подпись от 8 до 25 ₽ за подпись (на бесплатном тарифе две в месяц включены), SMS от 15 до 50 ₽. Если средств не хватает, помощник получит ссылку на пополнение баланса. Действуют суточные ограничения на число пакетов, документов и приглашений.

## Условия подключения помощника

Ключ выдаётся лично вам и действует от вашего имени. Всё, что помощник сделает с ключом, считается сделанным вами. Ключ можно отозвать в кабинете в любой момент. Документы могут содержать персональные данные третьих лиц: вы подтверждаете, что вправе передавать их в ИИПодпись. Данные обрабатываются на серверах в России. ИИПодпись не отвечает за решения самого помощника, например какие документы он выбрал и кого указал подписантом. Полный текст: <https://iipodpis.ru/ai#terms>.

## Обратная связь

Вопросы и предложения: [Issues](../../issues) этого репозитория или почта на сайте. Этот репозиторий содержит только описание подключения; исходный код сервиса не публикуется.

---

## English

**ИИПодпись (iiPodpis)** is a Russian e-signature service. This MCP server lets an AI assistant (Claude, Cursor, Bitrix24, Yandex AI Studio or your own agent) upload PDF documents and prepare them for signing on behalf of the account owner. 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)
- Auth: personal API key from the account, header `Authorization: Bearer <key>`
- Tools: `list_documents`, `upload_document`, `create_upload_link`, `send_for_signature`, `package_status`, `cancel_draft`
- The assistant can never send to signers without owner confirmation, never sees confirmation codes or signer contacts.

Get a key: sign up at [iipodpis.ru](https://iipodpis.ru) → Profile → "AI assistant" tab → issue a key. Then:

```bash
claude mcp add --transport http iipodpis https://iipodpis.ru/api/mcp \
  --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). Terms: <https://iipodpis.ru/ai#terms>.