PDFGate

PDFGate MCP サーバー

PDFGate API 用の Model Context Protocol（MCP）サーバーです。AI アシスタントによる PDF の生成、ドキュメントの管理、電子署名に対応します。

インストール

以下を MCP クライアントの設定に追加します。

{
  "mcpServers": {
    "pdfgate": {
      "command": "npx",
      "args": ["-y", "@pdfgate/mcp-server"],
      "env": {
        "PDFGATE_API_KEY": "your_api_key_here"
      }
    }
  }
}

ホスト型サーバー（リモート）

ローカルで何も実行したくない場合は、ホスト型の MCP サーバーもご利用いただけます。npx やローカルプロセスを使わず、直接接続できます。リモート（Streamable HTTP）MCP サーバーに対応したクライアントから、次の URL を指定してください。

https://mcp.pdfgate.com/server

認証方法は 2 つあります。

オプション 1 — OAuth

Claude や ChatGPT など、OAuth によるリモート MCP サーバー接続に対応したクライアントの場合は、サーバーの URL を指定して、ブラウザーからサインインしてください。コピーや保存が必要なキーはありません。クライアントが自身を登録し、アクセスを承認するために PDFGate ダッシュボードへ移動した後、スコープ付きトークンを自動的に受け取ります。

{
  "mcpServers": {
    "pdfgate": {
      "type": "http",
      "url": "https://mcp.pdfgate.com/server"
    }
  }
}

多くのクライアントでは、設定ファイルの代わりに UI から追加できます。たとえば Claude では、設定 → コネクター → カスタムコネクターを追加を選択し、上記の URL を入力します。OAuth セッションは本番アカウントで実行されます。サンドボックスを使う場合は、test_ キーを指定した X-API-KEY を使用してください。

オプション 2 — API キー

X-API-KEY ヘッダーにキーを指定します。

{
  "mcpServers": {
    "pdfgate": {
      "type": "http",
      "url": "https://mcp.pdfgate.com/server",
      "headers": {
        "X-API-KEY": "your_api_key_here"
      }
    }
  }
}

live_ キーでは本番環境、test_ キーではサンドボックス環境が使用されます。キーに応じて環境が自動的に選択されます。

ホスト型サーバーでは、PDFGate のすべてのツールセット（PDF の生成、処理、フォームフィールド、電子署名、Webhook）を利用できます。正確なクライアント設定のフィールド名（例：type／transport、headers）は、MCP クライアントによって異なる場合があります。

API キーの取得

PDFGate.com に登録して、API キーを取得してください。

• live_ で始まるキーは本番環境に接続します
• test_ で始まるキーはサンドボックス環境に接続します

ツール

PDF 操作

ツール	説明
generate_pdf	URL または HTML から PDF を生成します
upload_file	ローカルの PDF ファイルまたは URL からファイルをアップロードします
get_document	ドキュメントのメタデータと有効なダウンロード URL を取得します
download_file	保存済みドキュメントの PDF 生バイトデータをダウンロードします
delete_document	ドキュメントを削除します
flatten_pdf	インタラクティブ PDF を編集できない静的ファイルに変換します
extract_form_data	入力可能な PDF からフォームフィールドの値を抽出します
add_form_fields	PDF にインタラクティブなフォームフィールドを追加します（プレースホルダータグまたは明示的な位置を指定）
compress_pdf	PDF を圧縮してファイルサイズを縮小します
protect_pdf	パスワードと権限制限を設定して PDF を暗号化します
watermark_pdf	PDF にテキストまたは画像のウォーターマークを適用します

電子署名

ツール	説明
create_envelope	1 つ以上のドキュメントから署名用エンベロープを作成します
send_envelope	作成したエンベロープを受信者に送信します
get_envelope	エンベロープの現在の状態を取得します
void_envelope	エンベロープを無効にし、署名できないようにします
delete_envelope	エンベロープを削除し、署名済みドキュメントを削除します
create_embed_link	埋め込み用の受信者に有効期限付き署名リンクを作成します

受信者

ツール	説明
create_recipient	エンベロープ間で再利用できるよう、受信者を保存します
list_recipients	メールアドレスで保存済みの受信者を一覧表示します
get_recipient	ID で保存済みの受信者を取得します
update_recipient	保存済みの受信者の名前またはメタデータを更新します

Webhook の管理

ツール	説明
create_webhook	PDFGate のイベントを購読します
get_webhook	ID で Webhook サブスクリプションを取得します
delete_webhook	Webhook サブスクリプションを削除します

Webhook トリガー

サーバーは、デフォルトでポート 3599 で受信する PDFGate イベントを待ち受けます。イベントを受信するには：

1. ポート 3599 をインターネットに公開します（例：ngrok を使用）
2. create_webhook ツールを使用して、公開 URL を登録します

対応イベント：

イベント	説明
envelope.sent	署名依頼メールが受信者に送信されました
envelope.completed	エンベロープ内のすべてのドキュメントに署名されました
envelope.expired	すべてのドキュメントに署名される前にエンベロープの期限が切れました
envelope.document.completed	エンベロープ内の単一のドキュメントに署名が完了しました
envelope.recipient.signed	受信者がエンベロープ内のドキュメントに署名しました
envelope.voided	送信者がエンベロープを無効にしました
envelope.deleted	エンベロープが削除されました

受信したイベントは pdfgate://events MCP リソースから利用でき、リアルタイムでクライアントにプッシュされます。

環境変数

変数	必須	デフォルト	説明
PDFGATE_API_KEY	はい	—	PDFGate API キー
PDFGATE_WEBHOOK_PORT	いいえ	3599	Webhook リスナーのポート

---