MCP 連携
Printgraph は MCP（Model Context Protocol）サーバーを提供しています。 ChatGPT や Claude から、対話しながら直接テンプレートを作成・編集できます。
MCP 経由でできるのはテンプレートの操作までです。PDF の生成は従来どおり API キーを使った API から行ってください。
接続用の URL
各アプリのコネクタ設定に、次の URL を登録します。
https://printgraph.jp/api/mcpChatGPT / 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"
}
}
}許可される操作
連携時に、以下の 2 種類の権限をまとめて許可します。
- 閲覧（templates:read） — テンプレートの一覧・内容の閲覧
- 編集（templates: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 | 編集 | テンプレートとすべてのバージョンを削除します。 |
連携を解除する
「設定 → 連携アプリ」から、連携中のアプリを確認して解除できます。 解除すると、そのアプリが持つトークンは有効期限内であっても即座に無効になります。
テンプレートの操作には有効なサブスクリプションが必要です。 お支払い情報に問題があると、MCP 経由の操作もエラーになります。