ИИПодпись

AIПодпись — 面向 AI 助手的 MCP 服务

English below

将您的 AI 助手（Claude、Claude Code、Cursor、Битрикс24、Yandex AI Studio 或您自己的 Agent）连接到 AIПодпись 服务。助手可以上传文档、为签署做准备、通过纳税人识别号（ИНН）核查交易对方，并使用风险扫描器审查合同。您需要在网站上自行确认将文件发送给签署人，签署也只能由本人使用邮件或 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 MB）
create_upload_link	获取有效期为 10 分钟的一次性链接，无需密钥即可从磁盘上传文件
send_for_signature	准备待签署的文件包草稿：文档、签署人和方式（email 或 SMS）
package_status	查看文件包和签署人的状态，以及已签署归档文件的链接
cancel_draft	取消尚未确认的草稿
check_inn	通过纳税人识别号（ИНН）核查交易对方：个人是否为自雇人士（ФНС 数据），以及 ЕГРЮЛ/ЕГРИП 信息卡。仅提供公开信息
scan_contract	根据账户中的 PDF 或文本扫描合同风险。可选择网站上的免费档或完整付费审查。在后台运行
scan_status	查看审查是否完成：显示风险、解释和法律规范；完整审查还会提供面向用户的报告链接

助手不能做什么

• 未经您在网站上确认，不能将文档发送给签署人。
• 不能签署文档，也不能查看验证码：验证码只有签署人才能收到。
• 不能查看签署人的电话号码、邮箱和纳税人识别号（ИНН），也不能以您的名义下载已签署文件。
• 余额不足时不能付款：完整合同审查会从余额或已购买的检查次数中扣费；余额不足时，助手会提供充值链接。

如何连接

一键连接（OAuth）

将服务端地址添加到助手中。系统会打开我们的“允许”窗口：登录或注册、接受条款并确认。密钥会自动生成，您可以在“个人资料” → “AI 助手”中查看和撤销密钥。

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：前往“个人资料” → “AI 助手”选项卡 → “生成密钥”。密钥只会显示一次。请在 Authorization: Bearer ВАШ_КЛЮЧ 标头中传入：

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

Битрикс24（MCP Hub） — 在与 AI Agent 的聊天中，点击“连接”，选择外部 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 protected]。

助手会获取一个一次性链接，上传文件，创建草稿，并发送套餐页面链接。您打开链接，检查内容，然后点击“确认发送”。签署人会收到电子邮件和验证码。

查询 ИНН 7707083893，并告诉我这是谁。

助手会返回 ЕГРЮЛ/ЕГРИП 中的企业信息卡片；如果是个人，则会根据 ФНС 当日数据告知其是否为自雇人士。

用风险扫描器检查账户中的合同，先免费检查。

助手会启动免费档，并在一分钟后显示发现的风险。只有在您下达指令后，它才会启动包含法规依据和“应要求什么”建议的完整分析，因为这项服务需要付费。

费用和限制

费用与网站上的价格相同，具体取决于您的套餐：电子邮件签名每次 8 至 25 ₽（免费套餐每月包含两次），SMS 每次 15 至 50 ₽。风险扫描器免费档每天最多可分析 10 次。完整合同分析费用为 199 ₽，从余额中扣除，或使用已购买套餐中的一次检查额度。ИНН 查询免费，每天最多 30 次。如果余额不足，助手会获取余额充值链接。每天对套餐、文档和邀请数量均有限制，以免助手陷入循环并耗尽您的资金。

助手连接条款

密钥专属于您，并以您的名义生效。助手使用密钥执行的所有操作，均视为由您本人执行。您可以随时在账户中撤销密钥。文档可能包含第三方的个人数据：您确认自己有权将这些数据传输给 ИИПодпись。助手会将 ИНН 查询和风险扫描结果接收至其上下文中，也就是说，这些结果会发送给您所使用的模型提供商。数据在俄罗斯境内的服务器上处理。ИИПодпись不对助手自身的决策负责，例如它选择了哪些文档，以及指定了谁为签署人。完整条款：https://iipodpis.ru/ai#terms。

反馈

如有问题或建议，请提交至此存储库的 Issues，或通过网站上的邮箱联系。此存储库仅包含连接说明；服务源代码不予公开。

---

English

ИИПодпись (iiPodpis) 是一项俄罗斯电子签名服务。此 MCP 服务允许 AI 助手（Claude、Claude Code、Cursor、Bitrix24、Yandex AI Studio 或您自己的 Agent）上传 PDF 文档并代表账户所有者准备签署文件、通过税号（ИНН）查询俄罗斯交易对手方，以及扫描合同风险。发送操作始终需要所有者在网站上确认，签署则由真人使用一次性验证码完成（根据俄罗斯法律 63-ФЗ，这属于简单电子签名）。

• 服务端：https://iipodpis.ru/api/mcp（Streamable HTTP），已在官方 MCP 注册表中列为 ru.iipodpis/iipodpis
• 身份验证：OAuth 2.1 一键同意页面（客户端会自动发现；支持 Dynamic Client Registration 和 Client ID Metadata Documents），或通过 Authorization: Bearer <key> 使用个人 API 密钥
• 工具：list_documents、upload_document、create_upload_link、send_for_signature、package_status、cancel_draft、check_inn、scan_contract、scan_status
• 未经所有者确认，助手绝不会向签署人发送文件；助手不会看到确认码或签署人联系方式，也无法支出超过账户余额的金额。

使用 OAuth 连接：在 claude.ai 中添加自定义连接器，并填写服务端 URL；在 Claude Code 中：

claude mcp add --transport http iipodpis https://iipodpis.ru/api/mcp

然后选择 /mcp → iipodpis → Authenticate。不使用 OAuth 时：在 iipodpis.ru 注册 → Profile → “AI assistant”选项卡 → 创建密钥，并通过 --header "Authorization: Bearer YOUR_KEY" 传入。

价格遵循网站套餐（电子邮件签名每次 8–25 RUB，SMS 每次 15–50 RUB；免费套餐每月免费提供两次电子邮件签名）。合同免费扫描：每天最多 10 次。完整付费扫描：199 RUB，从余额中扣除，或使用已购买套餐中的一次额度。ИНН 查询免费，每天最多 30 次。条款：https://iipodpis.ru/ai#terms。