signforge

@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 に登録し、Developer Settings から 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. クライアントを再起動する

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

ツール

エンベロープ管理

ツール	説明
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 [email protected] (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 ([email protected]) 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 [email protected].
     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: [email protected]
- 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 にサーバーが表示されない

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

リンク

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

ライセンス

MIT