MCP 経由で Adobe Acrobat Sign を Gemini に接続する方法

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

Adobe Acrobat Sign + Gemini

Acrobat Sign ユーザーとしてサインインする Adobe Acrobat Sign REST API v6：契約を探して誰が署名したかを確認し、参加者、イベント、フォームデータ、署名リンク、署名済み PDF、監査証跡を読み取り、ドキュメントやライブラリテンプレートを署名用に送信し、リマインダーを送り、テンプレート、Web フォーム、ユーザー、グループ、ワークフロー、Webhook を参照します。契約の取り消しはインストール時にオフです。

前提条件

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

ADOBE_SIGN_SHARD, ADOBE_SIGN_CLIENT_ID, ADOBE_SIGN_CLIENT_SECRET

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

設定は約 15 分です。Acrobat Sign アカウント（Business、Enterprise、またはテスト用の無料開発者アカウント）と、API アプリケーションを作成するアカウント管理者が必要です。

1. アカウント管理者として Acrobat Sign にサインインし、ブラウザのアドレスから シャード を確認します。https://secure.na1.adobesign.com/... なら na1 です。ほかに na2、na3、na4、eu1、eu2、jp1、au1、in1、sg1 があります。シャードのコードだけを ADOBE_SIGN_SHARD に入れます。
2. Account、Acrobat Sign API、API Applications を開き、+ をクリックして名前と表示名を入力し、ドメインに CUSTOMER を選びます。
3. 新しいアプリケーションを選択し、Configure OAuth for Application をクリックします。Redirect URI を、AnythingMCP Cloud なら https://cloud.anythingmcp.com/api/mcp-oauth/callback、AnythingMCP を自分でホストしている場合は <your AnythingMCP URL>/api/mcp-oauth/callback に設定します。https で、完全に一致している必要があります。
4. 同じページでスコープ user_read、agreement_read、agreement_write、agreement_send、library_read、widget_read、workflow_read、webhook_read を有効にします。個人用のコネクタなら修飾子 self を選びます。アカウント管理者は account を選ぶと全ユーザーの契約にアクセスできます（下記「スコープ」参照）。保存します。
5. アプリケーションの View/Edit をクリックし、Application ID を ADOBE_SIGN_CLIENT_ID に、Client Secret を ADOBE_SIGN_CLIENT_SECRET にコピーします。コネクタをインストールします。
6. コネクタのページで Authorize with Provider をクリックし、Acrobat Sign にサインインします。続けて adobe_acrobat_sign_get_base_uris を実行します。apiAccessPoint にあなたのシャードが含まれている必要があります。別のシャードが表示された場合は、ADOBE_SIGN_SHARD を直してもう一度承認します。

スコープ: コネクタは user_read agreement_read agreement_write agreement_send library_read widget_read workflow_read webhook_read を要求します。これは修飾子 :self、つまりサインインしたユーザー自身の契約、テンプレート、Web フォームを意味します。AI にアカウント全体を見せたいアカウント管理者は、コネクタの OAuth 設定でこれを agreement_read:account、user_read:account などに変更し（同じ修飾子がアプリケーションでも有効になっている必要があります）、もう一度承認します。adobe_acrobat_sign_list_users には user_read:account が必要です。

トークン: アクセストークンは 1 時間有効で、シャードの /oauth/v2/refresh を通じて自動で更新されます。60 日間使われなかったリフレッシュトークンは失効するので、その場合はもう一度 Authorize with Provider をクリックします。

読み取れるデータ: 新しい順の一覧、またはテキスト（名前、参加者のメールアドレスと名前、メッセージ、外部 ID、フィールドの内容）による検索で取得する契約。ステータス、ロール、種類、作成日または更新日、参加者のメールアドレスで絞り込めます；送信者、参加者セット、CC リスト、メッセージ、日付、元のドキュメントを含む 1 件の契約；契約のメンバーと、それぞれがどの段階にいるか；監査イベント（作成、送信、閲覧、署名、委任、リマインダー送信、完了）；フォームフィールドに入力された値；今対応すべき参加者の署名リンク；契約のドキュメント；1 つの PDF にまとめた契約（一時リンクまたはファイル）と、PDF ファイルとしての監査証跡レポート；リマインダー；フォームフィールド付きのライブラリドキュメント（再利用できるテンプレート）；公開 URL、設定、入力データ、そこから作成された契約を含む Web フォーム；ユーザー、グループ、グループのメンバー；カスタム送信ワークフロー；Webhook です。

書き込める内容: adobe_acrobat_sign_upload_transient_document は URL からファイル（PDF、Word、Excel、画像）を取得してアップロードします。上限は 10 MB で、一時ドキュメントは 7 日で期限切れになります。adobe_acrobat_sign_create_agreement は一時ドキュメント、ライブラリテンプレート、または公開ファイル URL から契約を作成します。state が IN_PROCESS ならすぐに送信され、DRAFT なら未送信のまま、AUTHORING なら送信者が先に Acrobat Sign でフィールドを配置できます。adobe_acrobat_sign_send_agreement は DRAFT または AUTHORING の契約を送信し、adobe_acrobat_sign_create_reminder はまだ対応していない参加者に 1 回またはスケジュールでリマインドします。これらのツールはインストール時にオンで、送信とリマインダーは実際の人にメールを送るため、AI はドキュメント、順番どおりの受信者、メッセージを示し、はっきりした同意があってから送信します。

契約の作成: file_infos にはドキュメントごとに 1 件、transientDocumentId、libraryDocumentId、または Adobe 自身が取得する url・name・mimeType 付きの urlFileInfo を指定します。participant_sets は受信者を order（1、2、...）と role（SIGNER、APPROVER、ACCEPTOR、FORM_FILLER、CERTIFIED_RECIPIENT）付きで並べます。ドキュメントに署名フィールド（テキストタグやテンプレートのフィールド）がない場合、Acrobat Sign は末尾に署名欄を追加します。merge_field_info はテンプレートのフィールドを名前で事前入力し、名前は adobe_acrobat_sign_list_library_document_form_fields で確認できます。

インストール時はオフ: adobe_acrobat_sign_cancel_agreement です。取り消した契約にはもう署名できず、取り消しは元に戻せないためです。チームが必要とするときに管理者がオンにします。

データ形式: 契約の status は OUT_FOR_SIGNATURE、OUT_FOR_APPROVAL、SIGNED、APPROVED、ACCEPTED、FORM_FILLED、DELIVERED、CANCELLED、EXPIRED、DRAFT、AUTHORING などです。メンバーの status（WAITING_FOR_MY_SIGNATURE、NOT_YET_VISIBLE、COMPLETED など）は各参加者の段階を示します。日付は UTC の ISO 8601 です。フォームデータは CSV テキストで返り、読めるのは送信者だけで、既定では完了した契約に限られます。adobe_acrobat_sign_download_combined_document と adobe_acrobat_sign_download_audit_trail の PDF は 10 MB までのファイル添付として渡されます。署名リンクは送信の数秒後から利用できます。

ページング: 一覧ツールは page.nextCursor を返し、AI はそれがなくなるまで cursor として渡します。adobe_acrobat_sign_search_agreements は start_index（searchPageInfo.nextIndex の値）でページングし、1 ページ最大 100 件、合計 10,000 件までです。

制限: Acrobat Sign はプランに応じてユーザー単位とアカウント単位で API 呼び出しを制限します。429 応答には秒単位の Retry-After が付きます。

よくあるエラー: 401 INVALID_ACCESS_TOKEN は承認の期限切れまたは取り消しを意味します。もう一度承認してください。承認直後の 401 は、たいてい ADOBE_SIGN_SHARD の誤りです。403 PERMISSION_DENIED または INVALID_API_ACCESS_POINT は、スコープかその修飾子が足りない（たとえばユーザー一覧の user_read:account）、ユーザーがその契約を見られない、または呼び出しが別のシャードに送られたことを意味します。404 INVALID_AGREEMENT_ID（または別の INVALID_..._ID）は ID の誤りか、スコープが :self なのに別のユーザーの契約を指定したことを意味します。400 INVALID_ARGUMENTS、MISSING_REQUIRED_PARAM、INVALID_EMAIL は、欠けているか誤っているフィールドを示します。署名リンクでの 404 AGREEMENT_NOT_EXPOSED は契約がまだ準備中であることを意味します。数秒待ってからもう一度取得してください。

このコネクタはライブラリテンプレート、Web フォーム、ワークフロー、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 — Gemini にコネクタを追加

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

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が Adobe Acrobat Sign のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「署名待ちのまま 1 週間以上経っている契約はどれで、それぞれ誰がまだ署名していませんか？」
• 「Example 株式会社との NDA の署名済み PDF と監査証跡をダウンロードしてください。」
• 「ライブラリテンプレート Mutual NDA を [email protected] に署名用に送ってください。2 番目の署名者は私です。送信前にすべて見せてください。」
• 「第 4 四半期の仕入先契約にまだ署名していない参加者にリマインダーを送ってください。」
• 「Web フォーム Event Registration に入力されたデータを表にして見せてください。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

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