MCP 連携

Printgraph は MCP（Model Context Protocol）サーバーを提供しています。 ChatGPT や Claude から、対話しながら直接テンプレートを作成・編集できます。ワークフローの管理と実行にも対応しています（ベータ）。

単発の PDF 生成は MCP からは行えません。従来どおり API キーを使った API から実行してください。ワークフローを実行すれば PDF は生成されますが、ファイル自体は MCP からは受け取れないため、ワークフローの画面から取得してください。

接続用の URL

各アプリのコネクタ設定に、次の URL を登録します。

https://printgraph.jp/api/mcp

ChatGPT / Claude から接続する

アプリのコネクタ（外部連携）設定を開き、上記の URL を追加します。
ブラウザが開くので、Printgraph にログインします。
許可する操作を確認して「連携を許可する」を押します。

API キーの入力は必要ありません。連携はアカウント単位で行われ、アプリごとにトークンが発行されます。

Claude Code から接続する

次のコマンドで登録できます。初回接続時にブラウザでの許可を求められます。

claude mcp add --transport http printgraph https://printgraph.jp/api/mcp

設定ファイルに直接書く場合は次のようになります。

{
  "mcpServers": {
    "printgraph": {
      "type": "http",
      "url": "https://printgraph.jp/api/mcp"
    }
  }
}

許可される操作

連携時に、アプリが求めた権限をまとめて許可します。

閲覧（templates:read） — テンプレートの一覧・内容の閲覧
編集（templates:write） — テンプレートの作成・更新・削除
閲覧（workflows:read） — ワークフローの一覧・設定・実行履歴の閲覧
編集（workflows:write） — ワークフローの作成・更新・削除・実行

実際に何が許可されるかは同意画面に表示されます。ワークフロー系の権限は、アプリがそれを求めた場合にだけ一覧に並びます。既に連携済みのアプリからワークフローを操作したい場合は、一度連携を解除してから登録し直してください。

テンプレートのツール

ツール	権限	説明
`list_templates`	閲覧	テンプレートの一覧を取得します。本文は含みません。
`get_template`	閲覧	テンプレートの詳細（メインバージョンの HTML と変数定義）を取得します。
`list_template_versions`	閲覧	テンプレートのバージョン一覧を取得します。
`get_template_version`	閲覧	特定バージョンの本文と変数定義を取得します。
`search`	閲覧	テンプレートを名前で検索します。
`fetch`	閲覧	search で得た ID からテンプレート本文を取得します。
`create_template`	編集	テンプレートを新規作成します。
`update_template`	編集	テンプレートの名前を変更します。
`create_template_version`	編集	新しいバージョンを追加します。既定でメインになります。
`set_main_template_version`	編集	メインバージョンを既存のバージョンに切り替えます。
`delete_template`	編集	テンプレートとすべてのバージョンを削除します。

ワークフローのツール（ベータ）

ワークフローは順に公開している機能です。アカウントで有効になっている場合にだけ、以下のツールが連携先に表示されます。表示されない場合はお問い合わせください。

ステップは分岐のない一直線の並びで、配列の順序がそのまま実行順になります。update_workflow_steps は渡した内容で全置換するため、先に get_workflow で現在の構成を読んでから、変更後の全ステップを渡してください。

ツール	権限	説明
`list_workflows`	閲覧	ワークフローの一覧を取得します。ステップの中身は含みません。
`get_workflow`	閲覧	ワークフローの詳細（トリガー設定と、実行順に並んだステップ）を取得します。
`list_workflow_runs`	閲覧	実行履歴を新しい順に取得します。
`get_workflow_run`	閲覧	実行の進捗・結果を取得します。
`create_workflow`	編集	ワークフローを新規作成します。名前だけを受け取り、中身は続けて update_workflow_steps で設定します。
`update_workflow`	編集	ワークフローの名前や、自動起動の有効・無効を変更します。
`update_workflow_steps`	編集	トリガー設定とステップ構成をまとめて置き換えます。渡した内容で全置換されます。
`issue_workflow_webhook_token`	編集	Webhook トリガーのワークフローを起動する URL を発行します。発行時に一度しか表示されません。
`run_workflow`	編集	ワークフローをその場で実行します。完了は待たず、進捗は get_workflow_run で確認します。
`delete_workflow`	編集	ワークフローと、その実行履歴をすべて削除します。

連携を解除する

「設定 → 連携アプリ」から、連携中のアプリを確認して解除できます。解除すると、そのアプリが持つトークンは有効期限内であっても即座に無効になります。

MCP 経由の操作には有効なサブスクリプションが必要です。お支払い情報に問題があると、テンプレート・ワークフローいずれの操作もエラーになります。