MCP 経由で DocuSeal を Cursor に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → DocuSeal をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

DocuSeal + Cursor

オープンソースの電子署名プラットフォーム DocuSeal（クラウドの US または EU、セルフホスト）：テンプレート、署名依頼、署名者の検索、署名状況の確認、署名済み PDF と完了イベントの取得、テンプレートや単発の PDF の署名送付、署名者の変更、PDF・DOCX・HTML からのテンプレート作成。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

DOCUSEAL_API_URL, DOCUSEAL_API_KEY

ステップ 1 — 認証情報を取得

セットアップは約 2 分です。DocuSeal Cloud のアカウント、またはセルフホストの DocuSeal へのアクセスが必要です。

1. API キーをコピーします。DocuSeal Cloud では https://console.docuseal.com/api（EU アカウントは https://console.docuseal.eu/api）、セルフホストの DocuSeal では Settings > API（https://<your host>/settings/api）にあります。
2. キーを DOCUSEAL_API_KEY に貼り付けます。X-Auth-Token ヘッダーで送信され、キーの持ち主のユーザーとして動作します。
3. DOCUSEAL_API_URL を設定します。US のクラウドは https://api.docuseal.com、EU のクラウドは https://api.docuseal.eu、自前のインスタンスは https://<your host>/api（DocuSeal を開くアドレスに /api を付けたもの）です。末尾のスラッシュは付けません。
4. コネクタをインストールし、docuseal_list_templates を実行してキーを確認します。

テストモード: DocuSeal Cloud には専用の API キーを持つテストモードがあり、コンソールで切り替えます。テストの署名依頼は無料で、法的な効力はありません。コネクタを試す間はテスト用のキーを使ってください。

読み取れるデータ:

• テンプレート：ロール、フィールド（名前、種類、ロール、必須）、文書つき。名前（q）、フォルダー、外部 ID で検索できます。フィールド名は事前入力する値のキーになります。
• 署名依頼（submission）：ステータス、テンプレート、各署名者のメール・ロール・ステータス、イベント履歴、結合済み文書、監査ログのリンク。テンプレート、ステータス、フォルダー、署名者で絞り込めます。
• 全署名依頼にわたる署名者：送信・開封・完了・辞退の日時、辞退理由、入力した値、個人用の署名リンク embed_src。
• 署名依頼の文書のダウンロードリンク：完了後は署名済み PDF、完了前は途中まで入力された PDF。merge で 1 つの PDF にまとめられます。
• 完了イベント：署名を終えた署名者ごと（form.completed）と、全員が署名した依頼ごと（submission.completed）に 1 件ずつ。Webhook と同じデータで、ある時点以降に署名されたものをまとめて確認できます。

書き込める内容:

• 署名の送付：docuseal_create_submission はロールごとに 1 人の署名者でテンプレートを送ります。role はテンプレートのロール名（例: "First Party"）と一致させ、values でフィールド名ごとに値を事前入力します。署名者が 1 人のテンプレートなら docuseal_create_submissions_from_emails が手早く、メールアドレスごとに 1 件の依頼を作り、招待をすぐに送ります。docuseal_create_submission_from_pdf は、テンプレートを保存せずに単発の PDF を送ります。
• フォローアップ：docuseal_update_submitter は名前、メール、電話番号の修正、値の事前入力、send_email による招待の再送、completed による署名者に代わっての署名を行います。docuseal_update_submission は依頼の名前変更、有効期限の変更、アーカイブと復元を行い、docuseal_archive_submission はアーカイブして署名リンクを無効にします。
• テンプレート：docuseal_create_template_from_pdf、docuseal_create_template_from_docx、docuseal_create_template_from_html、docuseal_clone_template、docuseal_update_template（名前変更、フォルダー移動、ロール名変更、アーカイブと解除）、docuseal_archive_template。

すべてのツールはインストール時からオンです。送信系も含まれ、送信は実際に行われます。新しい署名依頼は send_email を false にしない限り署名者にメールを送り、completed: true は誰かに代わって署名し、アーカイブすると署名リンクは使えなくなります。AI はテンプレートか文書、ロールつきの署名者、メッセージを示し、はっきりした了承を得てから送信します。

ファイルとフィールド: documents[].file には公開 URL（DocuSeal がダウンロードします）か Base64 の内容を渡します。フィールドは、文書内の {{Full Name;role=Signer;type=text}}、{{Sign here;role=Signer;type=signature}}、{{Date;role=Signer;type=date}} のようなテキストタグか、正確な areas（page、x、y、w、h をページに対する比率で指定）を持つ fields から作られます。種類には text、signature、initials、date、number、image、checkbox、select、radio、file、stamp、payment、phone などがあります。HTML テンプレートは <signature-field name="Signature" role="Signer"></signature-field> のようなタグを使い、DOCX テンプレートでは動的な文書のために [[variables]] を使えます。

データ形式: ID は整数です。日時はタイムゾーンつきの ISO 8601 です。署名依頼の status は pending、completed、declined、expired、署名者の status は awaiting（署名順のためまだ招待されていない）、sent、opened、completed、declined です。文書の URL は一時的なものなので、早めにダウンロードしてください。

ページング: 一覧は data と、count・next・prev を持つ pagination を新しい順に返します。既定は 10 件で、limit で最大 100 件です。AI は pagination.next を after に渡して次の（より古い）ページを取得し、next が null になったら止めます。完了イベントのツールも、完了時刻（Unix 秒）で同じようにページングします。

よくあるエラー: 401 "Not authenticated" は API キーが間違っているか未設定、または US のクラウドのキーを EU のホストで使った（あるいはその逆）ことを意味します。403 はキーのユーザーにその項目を見る権限がないこと、404 は存在しない ID です。422 は無効な入力で、error メッセージがつきます（不明なロール名、メールの欠落、アーカイブ済みのテンプレート、フィールドのないテンプレート、読めないファイル）。429 はレート制限に達したことを示します。セルフホストのインスタンスで、すべての呼び出しが 404 になる場合は DOCUSEAL_API_URL に /api が抜けています。

このコネクタはテンプレートと署名依頼をアーカイブしますが、削除はしません。DocuSeal のユーザー、アカウント設定、Webhook の購読も管理しません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Cursor にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう。エージェントが DocuSeal のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「NDA テンプレートの署名依頼のうち、まだ保留中のものと、まだ署名していない人を教えてください。」
• 「テンプレート「雇用契約書」を First Party として [email protected] に送り、名前と入社日を事前入力してください。送信前にすべて見せてください。」
• 「月曜日以降に署名されたものは何ですか？署名者ごとに文書と完了時刻を一覧にしてください。」
• 「署名依頼 4521 の署名済み文書を 1 つにまとめた PDF と、監査ログのリンクを取得してください。」
• 「署名者 [email protected] が招待を開いていません。アドレスを [email protected] に直して再送してください。」

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Gemini に接続
• Meta Muse に接続
• Microsoft Copilot に接続