MCP-сервер arqa ЭДО
Подключите подписание документов к своему ИИ-ассистенту. Он сам загрузит PDF, назначит подписантов, выдаст ссылку или QR для eGov mobile и скажет, когда документ подписан. Подписываете по-прежнему вы — своей ЭЦП.
claude mcp add --transport http arqa-edo https://edo.arqabuh.kz/mcp/Claude Desktop и другие клиенты: добавьте https://edo.arqabuh.kz/mcp/ как Custom connector (транспорт HTTP). Слеш на конце обязателен.
Документ на подпись — прямо из разговора с ассистентом
Вместо переключения между почтой, папкой с PDF и порталом вы описываете задачу словами, а ассистент делает шаги за вас.
Готовит документ к подписанию
Ассистент загружает PDF, назначает подписантов по ИИН и отправляет документ на подпись — вы только говорите, что и кому.
Выдаёт ссылку и QR eGov mobile
Возвращает ссылку для подписания и строку для QR-кода, который сканируется приложением eGov mobile.
Следит за статусом
Показывает, кто уже подписал: ФИО, ИИН, организация и БИН из сертификата ЮЛ, дата, способ подписи и алгоритм ЭЦП.
Отдаёт подписанный PDF
Скачивает документ со штампом, угловым QR и листом подписания — тем же файлом, что вы получили бы вручную.
Четыре шага
- 1
Подключите сервер
Выполните одну команду в Claude Code либо добавьте адрес как Custom connector в Claude Desktop.
- 2
Попросите ассистента
Например: «загрузи этот акт, добавь подписанта Ерлана и дай мне ссылку на подпись».
- 3
Подпишите
Подписывает человек — своей ЭЦП через NCALayer или сканом QR в eGov mobile. Ключ подписи никуда не передаётся.
- 4
Заберите результат
Ассистент дождётся статуса «подписан» и отдаст готовый PDF со штампом и листом подписания.
Что умеет ассистент после подключения
Десять инструментов. Семь работают без ключа, три помечены — им нужен API-ключ.
| Инструмент | Что делает | Ключ |
|---|---|---|
create_document | Загрузить PDF на подписание, получить uuid и ссылку. | — |
add_signer | Добавить подписанта: имя и, если нужно, ожидаемый ИИН. | — |
send_for_signing | Отправить документ на подпись, указав, сколько подписей ждём. | — |
get_document_status | Статус и подписанты: кто, когда и чем подписал. | — |
create_sign_session | Открыть сессию eGov mobile и получить строку для QR-кода. | — |
download_signed_pdf | Скачать текущий PDF — после подписи уже со штампом. | — |
verify_document | Проверить подлинность подписей по токену из штампа. | — |
notify_signer | Отправить получателю письмо со ссылкой на подписание. | нужен |
list_documents | Список своих документов с фильтром по статусу. | нужен |
revoke_document | Отозвать документ — подписать его больше нельзя. | нужен |
Что работает без ключа, а что нет
Чтобы ассистент не пообещал вам того, чего не может.
- Ассистент видит только те документы, которые создал в этом же разговоре, — доступ даёт знание uuid, как ссылка на документ.
- Списка «все мои документы» нет: он требует ключа. Потерянный uuid восстановить нельзя.
- Письма получателям без ключа не отправляются — ссылку передаёте сами.
- Действует ограничение частоты: 20 запросов в минуту с одного адреса.
Нужен ключ
Списки своих документов, рассылка писем получателям и отзыв документа работают по API-ключу. Выдаём его организациям вручную — так документы разных владельцев не смешиваются.
Частые вопросы
- Нужен ли ключ или регистрация?
- Нет. Базовый сценарий — загрузить документ, назначить подписантов, получить ссылку или QR, дождаться подписи и скачать PDF — работает без ключа и без регистрации. Ключ нужен только для рассылки писем получателям, списка своих документов и отзыва документа.
- Может ли ИИ подписать документ за меня?
- Нет, и это сделано намеренно. Инструмента, принимающего готовую подпись, в сервере нет: ЭЦП принадлежит человеку и не должна проходить через переписку с ИИ. Ассистент готовит документ и следит за статусом, подписываете вы — через NCALayer или eGov mobile.
- Какие способы подписи поддерживаются?
- ЭЦП НУЦ РК через NCALayer (файл .p12) и eGov mobile по QR-коду. Поддержаны и RSA, и ГОСТ-сертификаты — подпись из eGov mobile проверяется через NCANode.
- Что будет в готовом PDF?
- Компактный QR проверки в углу страниц и отдельная страница «Лист подписания»: ФИО и ИИН подписанта, организация и БИН для сертификатов ЮЛ, дата и время, способ подписи, тип и серийный номер сертификата.
- Как получить API-ключ?
- Напишите на hello@arqa.cc или в Telegram — выдаём ключ организациям вручную, чтобы разделять документы между владельцами.