AddSign

addsign-mcp

AddSign 用 MCP サーバーです。AI エージェントが署名用のドキュメントを送信し、署名状況を追跡し、署名者にリマインダーを送り、ハッシュ検証可能な署名済み PDF をダウンロードできます。

設計上、ステートレスです。お客様の API キーを使って、AddSign の公開 v1 API のみを利用します。データベースへのアクセスや共有シークレットはありません。 addsign.io/settings/api でキーを取り消すと、連携は即座に無効になります。

セットアップ

1. addsign.io → Settings → API Keys で API キーを作成します（すべてのプランで無料。Free では月 8 件のドキュメントを利用できます）。
2. 環境変数に設定します。プロンプトや、git にコミットする設定ファイルには決して記載しないでください。

export ADDSIGN_API_KEY=sk_...

Claude Code

claude mcp add addsign --env ADDSIGN_API_KEY=sk_... -- npx -y addsign-mcp

（npm パッケージが公開されるまでは、代わりにチェックアウト先を指定します。 claude mcp add addsign --env ADDSIGN_API_KEY=sk_... -- node /path/to/simple-sign/mcp/dist/index.js）

Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "addsign": {
      "command": "node",
      "args": ["/path/to/simple-sign/mcp/dist/index.js"],
      "env": { "ADDSIGN_API_KEY": "sk_..." }
    }
  }
}

環境変数

変数	必須	デフォルト	用途
ADDSIGN_API_KEY	はい	—	AddSign API キー（sk_...）
ADDSIGN_BASE_URL	いいえ	https://addsign.io	別のデプロイ先を指定します

ツール

ツール	種類	機能
list_templates	読み取り	テンプレート、各テンプレートが想定する署名者の役割、フィールドの概要
send_for_signature	書き込み	テンプレートからドキュメントを作成し、署名者にメールを送信します。request_id による冪等性を備えています
check_status	読み取り	ドキュメントと署名者ごとの状態、および最近の監査イベント
download_signed	読み取り	5 分間有効な署名済み URL と、検証用の台帳の SHA-256
remind	書き込み	署名が保留中の署名者にリマインダーを送信します（サーバー側で署名者ごとに 4 時間のクールダウン）
list_documents	読み取り	ページ分割されたドキュメント一覧。ステータスで絞り込み可能

破壊的なツールはありません。このサーバーを通じて、エージェントが法的文書をキャンセルしたり削除したりすることはできません。

一般的なエージェントのワークフロー

list_templates                      → find "Contract to Lease", roles: [tenant_1, tenant_2]
send_for_signature {template_id,
  signers: [Artem…, Valeria…],
  request_id: <uuid>}               → document_id, status: pending, usage 3/8
check_status {document_id}          → Artem signed, Valeria viewed
remind {document_id, valeria@…}     → reminded (or skipped: reminded_recently)
download_signed {document_id}       → url + sha256 → fetch, verify, file it

エラーの意味

AddSign のすべてのエラーには、安定した error_code が含まれます。このサーバーは、エージェントに適切な次の手順を追加します。特に重要なのは次の 2 つです。

• rate_limited（429） — retry_after 秒間待機してから再試行します。
• plan_limit_reached（402） — 再試行しないでください。月間上限は毎月 1 日にリセットされるか、人間がプランをアップグレードします。

開発

cd mcp
npm install
npm run build     # → dist/index.js
ADDSIGN_API_KEY=sk_... node dist/index.js