@signforge/mcp-server

Claude Desktop、Claude Code、Cursor、その他のAIエージェントから直接電子署名用のドキュメントを送信できます。無料の電子署名プラットフォームSignForgeを利用しています。

機能

このMCPサーバーは、AIエージェントをSignForgeの電子署名APIに接続します。AIアシスタントは以下の操作が可能です：

署名用ドキュメントの送信 — PDFのアップロード、署名者の指定、送信を1ステップで実行
エンベロープの管理 — 送信、無効化、削除、ステータス確認
ドキュメントのダウンロード — 署名済みPDF、監査証明書、ZIPアーカイブ
テンプレートの使用 — 事前入力フィールドを備えた再利用可能なテンプレートからエンベロープを作成
Webhookの管理 — リアルタイムのエンベロープイベントを購読
埋め込みURLの生成 — 埋め込み可能な署名体験を作成

クイックスタート

1. APIキーの取得

signforge.ioにサインアップし、開発者設定からAPIキーを生成してください。

2. AIクライアントの設定

以下のクライアントから選択し、設定を追加してください：

Claude Desktop

claude_desktop_config.jsonに追加します：

{
  "mcpServers": {
    "signforge": {
      "command": "npx",
      "args": ["-y", "@signforge/mcp-server"],
      "env": {
        "SIGNFORGE_API_KEY": "your-api-key-here"
      }
    }
  }
}

設定ファイルの場所：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Code

claude mcp add signforge -- npx -y @signforge/mcp-server

次に、シェルで環境変数を設定します：

export SIGNFORGE_API_KEY="your-api-key-here"

Cursor

CursorのMCP設定（.cursor/mcp.json）に追加します：

{
  "mcpServers": {
    "signforge": {
      "command": "npx",
      "args": ["-y", "@signforge/mcp-server"],
      "env": {
        "SIGNFORGE_API_KEY": "your-api-key-here"
      }
    }
  }
}

直接実行 (npx)

SIGNFORGE_API_KEY="your-api-key-here" npx -y @signforge/mcp-server

3. クライアントの再起動

Claude Desktop、Claude Code、またはCursorを再起動して、新しいMCPサーバーを読み込ませます。

ツール

エンベロープ管理

ツール	説明
`create_and_send`	PDFをアップロードし、署名者を追加して電子署名用に送信します。ローカルファイルパスまたはBase64エンコードされたPDFを受け付けます。
`check_status`	エンベロープのステータスを確認します（署名の進捗、タイムスタンプ、利用可能なドキュメントを表示）。
`list_envelopes`	エンベロープを一覧表示します（ステータスによるフィルタリング可能：`draft`, `sent`, `completed`, `voided`, `expired`）。
`send_envelope`	下書き状態のエンベロープを署名用に送信します。
`void_envelope`	アクティブなエンベロープを無効化（キャンセル）します（理由の指定が可能）。
`delete_envelope`	下書きまたは無効化されたエンベロープを完全に削除します。

ドキュメントのダウンロード

ツール	説明
`download_signed`	完了したエンベロープの署名済みPDFをローカルファイルにダウンロードします。
`download_certificate`	完全な監査証跡を含む監査証明書PDFをダウンロードします。
`download_archive`	署名済みPDF、証明書、すべてのドキュメントを含むZIPアーカイブをダウンロードします。

埋め込み署名

ツール	説明
`get_embed_url`	アプリ内署名体験のための埋め込み可能な署名URLを生成します。

テンプレート

ツール	説明
`list_templates`	再利用可能なドキュメントテンプレートを一覧表示します。
`create_from_template`	事前入力フィールド値を指定して、テンプレートからエンベロープを作成します。即時送信または下書き保存が可能です。

Webhook

ツール	説明
`create_webhook`	エンベロープイベント（送信、閲覧、署名、完了、期限切れ、無効化、拒否）を購読します。
`list_webhooks`	設定済みのすべてのWebhookを一覧表示します。
`delete_webhook`	IDを指定してWebhookを削除します。

会話例

署名用ドキュメントの送信

You: Send my NDA at ~/Documents/nda.pdf to jane@example.com (Jane Smith) for signature.

AI: I'll send that NDA for signature now.

[Uses create_and_send tool]

Done! I've created and sent the envelope:
- Envelope ID: a1b2c3d4-...
- Status: sent
- Jane Smith (jane@example.com) will receive a signing link via email.

ステータス確認とダウンロード

You: Has Jane signed the NDA yet?

AI: Let me check.

[Uses check_status tool]

Yes! Jane signed it on April 7 at 2:15 PM. The envelope is now completed.

You: Great, download the signed copy and the audit certificate.

[Uses download_signed tool]
[Uses download_certificate tool]

Done! Files saved:
- Signed PDF: ~/Documents/nda-signed.pdf
- Audit Certificate: ~/Documents/nda-certificate.pdf

事前入力フィールド付きテンプレートの使用

You: Send our standard consulting agreement to bob@acme.com.
     Pre-fill the company name as "Acme Corp" and the start date as "May 1, 2026".

AI: I'll create that from your consulting agreement template.

[Uses list_templates tool — finds "Consulting Agreement" template]
[Uses create_from_template tool — with prefill_fields and send_immediately: true]

Done! Envelope created and sent:
- Title: Consulting Agreement
- Recipient: bob@acme.com
- Pre-filled: company = "Acme Corp", start_date = "May 1, 2026"
- Status: sent

エンベロープのライフサイクル管理

You: List my sent envelopes.

[Uses list_envelopes tool with status: "sent"]

You: Void the contract for Project Alpha — the deal fell through.

[Uses void_envelope tool with reason]

You: Now delete it.

[Uses delete_envelope tool]

Done — envelope voided and deleted.

Webhookの設定

You: Set up a webhook to notify my server when documents are signed or completed.

[Uses create_webhook tool]

Webhook created:
- URL: https://api.yourapp.com/webhooks/signforge
- Events: envelope.signed, envelope.completed
- Secret: whsec_abc123... (save this for signature verification!)

環境変数

変数	必須	デフォルト	説明
`SIGNFORGE_API_KEY`	はい	—	SignForge APIキー。signforge.io/dashboard/developersで取得してください。
`SIGNFORGE_API_URL`	いいえ	`https://signforge.io/api/v1`	APIベースURL。セルフホスト環境やステージング環境以外では変更しないでください。

サンドボックスモード

サンドボックスモードで作成されたAPIキーは、実際のメールを送信しないテスト用エンベロープを作成します。開発およびテスト中はサンドボックスモードを使用してください。

トラブルシューティング

"SIGNFORGE_API_KEY environment variable is required" MCPクライアント設定でSIGNFORGE_API_KEYが設定されていることを確認してください。上記の設定手順を参照してください。

"SignForge API error (401)" APIキーが無効か、期限切れです。signforge.io/dashboard/developersで新しいキーを生成してください。

"SignForge API error (403)" APIキーにこの操作を実行する権限がありません。キーのスコープを確認してください。

"SignForge API error (429)" レート制限に達しました。少し待ってから再試行してください。

Claude Desktopにサーバーが表示されない場合

設定JSONが有効であることを確認してください（末尾のカンマがないかなど）
Claude Desktopを完全に再起動してください（終了して再起動）
Claude Desktopの開発者コンソールでMCPサーバーのログを確認してください

リンク

SignForge — 無料の電子署名プラットフォーム
APIドキュメント — 完全なAPIリファレンス
GitHub — ソースコード
MCPプロトコル — Model Context Protocol仕様

ライセンス

MIT

SignForge