MCP サーバー連携（Claude / Cursor / VS Code）

Model Context Protocol (MCP) に対応した公式サーバー reportflow-mcp を提供しています。Claude Desktop / Claude Code / Cursor / VS Code などの MCP 対応 AI クライアントから、自然言語で Re:port Flow テンプレートを呼び出して PDF を生成できます。

ホスト型エンドポイント（npm 不要）: https://mcp.re-port-flow.com/mcp
Claude のコネクタディレクトリ: Claude アプリの ディレクトリ → コネクタ に Re:port Flow として掲載（コミュニティコネクタ）
npm: reportflow-mcp
ソース: github.com/re-port-flow/reportflow-mcp
MCP Registry: io.github.re-port-flow/reportflow-mcp

なぜ Re:port Flow MCP か

PDF 生成系の MCP サーバーは複数存在しますが、Re:port Flow MCP は次の 3 点で他のサーバーと差別化されます。

リモート対応・セットアップ不要 — https://mcp.re-port-flow.com/mcp にホスト型エンドポイントを提供しており、npm / Node.js のインストール無しで Claude.ai (Web) からそのまま接続できます。ローカル MCP サーバー（stdio）のみを提供する他社の帳票 MCP サーバーと異なり、開発者でないビジネスユーザーでも使い始められます。
ノーコード設計 + テンプレートマーケットプレイス — テンプレートはブラウザベースの GUI エディタ（Konva ベース）でノーコードに設計できます。さらにテンプレートギャラリーに請求書・見積書・領収書・納品書・レポートなどのフリーテンプレートが揃っており、AI エージェントは初日からそれらを呼び出して PDF 生成できます。テンプレートを作るために JSON スキーマを書く必要はありません。
OAuth 2.0 + 動的クライアント登録 — AI クライアントに API キーを渡さない、OAuth 2.0（Authorization Code + PKCE）+ Dynamic Client Registration ベースの認証を採用しています。トークンはローカル実行時は OS のキーチェーン、リモートエンドポイント利用時はサーバー側で管理されます。要求するスコープは OAuth と権限（スコープ）に明記しています。

できること

「Acme 社向けに合計 ¥33,000 の請求書を作って」のような自然言語から PDF を生成
テンプレートを 1 件も持っていなくても、公開テンプレートギャラリーを検索してワークスペースへ複製し、そのまま PDF 生成まで到達
ワークスペースのテンプレートとパラメータスキーマを MCP Resources として AI に直接公開
複数 PDF を一括生成し ZIP で受け取り
出力ファイルを、AI クライアントが現在開いているワークスペースフォルダに保存

動作要件

Node.js 18 以上（npx 実行時に自動取得）
初回ログイン時にブラウザを開ける環境（ローカルマシン推奨）
Re:port Flow アカウント

上記は ローカル実行（npx） の場合の要件です。リモート（ホスト型）サーバーを使う場合は Node.js のインストールやローカルのブラウザ／キーチェーンは不要で、必要なのは Re:port Flow アカウントと、リモート MCP に対応した AI クライアントだけです。

セットアップ

接続方法は 3 通りあります。用途で選んでください。

方法	向いているケース	生成物の受け取り方
コネクタディレクトリから追加	Claude を使っていて、設定ファイルを触りたくない	ダウンロード URL
リモート（ホスト型）サーバー	Claude 以外のリモート MCP 対応クライアント、URL を直接指定したい	ダウンロード URL
ローカル実行（npx）	生成した PDF をローカルのワークスペースフォルダに保存したい	ローカルファイルパス

ファイルをローカルに自動保存したい場合のみ ローカル実行（npx） を選んでください。それ以外は Node.js の導入が不要なリモート接続で十分です。

Claude のコネクタディレクトリから追加する（最短）

reportflow-mcp は Claude のコネクタディレクトリに掲載されています。Claude を使っている場合は、エンドポイント URL を手入力せずにここから追加できます。

Claude を開き、設定 → コネクタ（または画面内の ディレクトリ）を開く
コネクタ タブを選び、検索ボックスに Re:port Flow と入力する
一覧の Re:port Flow を選び、追加 / 接続 を押す
ブラウザで OAuth の同意画面が開くので、サインイン → ワークスペースを選択 → 許可

接続後は、そのまま「請求書テンプレートで Acme 社向けに合計 ¥33,000 の PDF を作って」のように依頼できます。要求されるスコープは OAuth と権限（スコープ）を参照してください。

ディレクトリ上の表示について

ディレクトリ上の表示名は Re:port Flow、種別は コミュニティコネクタ です。掲載は、それ以上の認定・提携関係を意味するものではありません。

ディレクトリに見つからない場合や Claude 以外のクライアントを使う場合は、次の 2 つの方法で URL を直接登録してください。

ローカル実行（npx・推奨）

Claude Desktop / Claude Code / Cursor

設定ファイル（.mcp.json / claude_desktop_config.json / ~/.cursor/mcp.json など）に以下を追加します。

{
  "mcpServers": {
    "reportflow": {
      "command": "npx",
      "args": ["-y", "reportflow-mcp"]
    }
  }
}

API キーや環境変数の設定は不要です。OAuth で認証するため、シークレット管理は AI クライアント側で行いません。

VS Code（MCP 対応ビルド）

VS Code は top-level キーが servers です（Claude / Cursor の mcpServers とは異なります）。.vscode/mcp.json に以下を配置してください。

{
  "servers": {
    "reportflow": {
      "command": "npx",
      "args": ["-y", "reportflow-mcp"]
    }
  }
}

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

npm / Node.js のインストールは不要です。ホスト型エンドポイントに URL で接続します。Claude.ai（Web）やリモート MCP に対応したクライアントに適しています。認証はクライアント側のブラウザで OAuth（動的クライアント登録）が実行され、トークンはサーバー側で管理されるため、ローカルのキーチェーンは使いません。

エンドポイント:

https://mcp.re-port-flow.com/mcp

HTTP トランスポートに対応したクライアント（Claude Code / Cursor など）では、設定ファイルに以下を追加します。

{
  "mcpServers": {
    "reportflow": {
      "type": "http",
      "url": "https://mcp.re-port-flow.com/mcp"
    }
  }
}

VS Code（.vscode/mcp.json）では top-level キーが servers です。

{
  "servers": {
    "reportflow": {
      "type": "http",
      "url": "https://mcp.re-port-flow.com/mcp"
    }
  }
}

Claude Code の CLI では次のコマンドでも追加できます。

claude mcp add --transport http reportflow https://mcp.re-port-flow.com/mcp

Claude.ai（Web / Desktop）では、設定の Connectors（カスタムコネクタ） から上記 URL を登録してください。接続時にブラウザで OAuth の同意画面が表示されます。Claude を使っている場合は、URL を入力しなくてもコネクタディレクトリから追加できます。

ローカル実行との違い

リモートサーバーはユーザーのファイルシステムにアクセスできないため、生成した PDF はローカルのワークスペースフォルダには保存されず、ダウンロード用 URL として返されます。生成物をローカルへ自動保存したい場合は、ローカル実行（npx）を利用してください。

対応プロトコルバージョン

reportflow-mcp は、ローカル実行（stdio）・リモート（Streamable HTTP）どちらも単一のエンドポイントで複数の MCP プロトコルリビジョンに対応しています。

2026-07-28（現行仕様） — ステートレスなプロトコル。モダンなクライアントは server/discover でサーバーを検出し、セッションヘッダーを使わず、リクエストごとに _meta でプロトコルバージョンをやり取りします。
2025 世代以前のリビジョン（2025-11-25 / 2025-06-18 / 2025-03-26 / 2024-11-05 / 2024-10-07）— 従来の initialize ハンドシェイクを使うクライアント（Claude Desktop、Claude.ai のカスタムコネクタ、Cursor、ChatGPT、n8n など）との後方互換のために引き続き提供しています。

どちらのリビジョンで接続するかはクライアントとの自動ネゴシエーションで決まり、利用者側の設定は不要です。モダンなクライアントは server/discover で問い合わせ、レガシークライアントは従来どおり initialize を送信します。既存の接続方法・設定ファイルの書き方は本ページの内容から変わりません。

初回認証

クライアントを再起動した後、AI に次のように依頼します。

ReportFlow にログインして

ブラウザが開くので サインイン → ワークスペースを選択 → 同意 で完了です。アクセストークンは OS のキーチェーン（macOS Keychain / Windows Credential Manager / Linux libsecret）に保存され、自動でリフレッシュされます。

キーチェーンが使えない環境

Linux で libsecret が利用できない場合は、$XDG_STATE_HOME/reportflow-mcp/ 以下に chmod 0600 のファイルとして自動的にフォールバック保存されます。

リモート（ホスト型）サーバーの場合

上記の手順はローカル実行（npx）向けです。リモートサーバーでは、クライアントが接続したタイミングで OAuth の同意フローが自動的に開始され、トークンはサーバー側で管理されます。AI への「ログインして」という依頼や、ローカルのキーチェーンは不要です。

OAuth と権限（スコープ）

リモート（ホスト型）エンドポイントは OAuth 2.0（Authorization Code + PKCE）で保護されています。クライアント登録は Dynamic Client Registration（RFC 7591）で自動的に行われるため、Claude 側に API キーやクライアントシークレットを登録する必要はありません。

同意画面で要求されるスコープは次のとおりです。

スコープ	用途
`openid` / `profile`	サインインしたユーザーの識別、および接続先ワークスペースでの権限（ロール）解決
`pdf:generate`	Content Service の `/v1/file/*`（PDF 生成に加え、テンプレート一覧・パラメータ参照も含む）と使用量の参照
`designs:write`	ギャラリーテンプレートの複製（`copy_gallery_template`）

各スコープの詳細な定義は OAuth 2.0 認証を参照してください（MCP サーバーは同じ認可サーバーを利用します）。

スコープとワークスペース権限は別のレイヤーです

スコープは「この連携アプリに何を許可したか」を表し、あなたがそのワークスペースで何をできるか（ロール）とは別です。両方を満たしたときだけ操作が通ります。

たとえば読み取り権限（READ）のメンバーが接続した場合でも、トークンには designs:write が載ります。それでもテンプレート複製は実行できません（ロール側で拒否されます）。詳しくはワークスペース権限とツールの対応を参照してください。

認可コードフローは PKCE（S256）必須、トークンエンドポイントの認証方式は none（パブリッククライアント）です。アクセストークンは refresh_token で自動更新されます。

サーバーは以下のディスカバリ文書を配信しています。接続できないときの一次切り分けにそのまま使えます。

エンドポイント	仕様	内容
`/.well-known/oauth-protected-resource`	RFC 9728	保護リソースのメタデータ（認可サーバーの所在・スコープ一覧）
`/.well-known/oauth-authorization-server`	RFC 8414	認可サーバーのメタデータ（`/authorize`・`/token`・`/register`）
`/healthz`	—	死活確認。`{"status":"ok"}` を返す

curl -s https://mcp.re-port-flow.com/healthz
curl -s https://mcp.re-port-flow.com/.well-known/oauth-protected-resource
curl -s https://mcp.re-port-flow.com/.well-known/oauth-authorization-server

ワークスペース権限とツールの対応

OAuth の同意画面で選んだワークスペースでのあなたのロールによって、AI に見えるツールと実行できる操作が変わります。ロールはワークスペースの管理者が設定するもので、Web の画面と同じ値です。

操作	管理者	編集者	閲覧者	閲覧不可 / 未所属 / 未接続
公開テンプレートギャラリーの検索・詳細（`search_gallery_templates` / `get_gallery_template`）	✅	✅	✅	✅
ワークスペース内テンプレートの参照（`list_templates` / `get_design_parameters` / `search` / `fetch` / `suggest_params`）	✅	✅	✅	❌
PDF 生成（`generate_pdf_sync` / `generate_pdf_async` / `generate_pdfs_sync` / `generate_pdfs_async`）	✅	✅	✅	❌
生成済みファイルの取得（`download_file` / `download_zip`）	✅	✅	✅	❌
ギャラリーテンプレートの複製（`copy_gallery_template`）	✅	✅	❌	❌

閲覧者（READ）でも PDF は生成できます。 Web の画面で出力ボタンが押せるのと同じ扱いです。閲覧者に許可されないのは、ワークスペースへ新しいテンプレートを作る操作（テンプレート複製）だけです。
権限外のツールは tools/list に表示されません。表示されていないツール名を直接指定して呼び出した場合も、Re:port Flow の API へ要求が届く前に拒否されます（テンプレート・PDF・使用量は増えません）。
未認証のまま接続した場合は、公開ギャラリーの検索・詳細と静的リソース（reportflow://errors / reportflow://server-info）、プロンプトだけが見えます。
権限の判定はサーバー側で最大 60 秒キャッシュされます。ロールを変更した直後は、反映まで最大 1 分かかることがあります。すぐに反映したい場合は接続し直してください。
ロールの照会に失敗したとき（ネットワーク障害など）は、権限が無い場合と同じく拒否されます。応答には「権限不足ではなく権限情報の取得に失敗した」と明記されるので、そのまま少し待って再実行してください。

使い方

1. 自然言語で PDF 生成

請求書テンプレートで、Acme 社向けに合計 ¥33,000 の PDF を作成して

AI は内部で以下を実行します。

list_templates で利用可能なテンプレートを検索
get_design_parameters でパラメータスキーマを取得
ユーザーの指示から params を組み立て
generate_pdf_sync で PDF を生成し、ローカルファイルパスを返す

2. テンプレート 0 件から始める（ギャラリー検索 → 複製 → 生成）

請求書を PDF で作りたい（テンプレートはまだ持っていない）

ワークスペースにテンプレートが 1 件も無い場合、AI は公開テンプレートギャラリーから候補を探して複製し、通常の生成フローへ合流します。

search_gallery_templates でギャラリーを検索し、候補を提示（認証不要）
必要に応じて get_gallery_template で詳細（説明全文・複製実績）を確認
ユーザーが選んだテンプレートを copy_gallery_template でワークスペースへ複製
返された designId / version で get_design_parameters → generate_pdf_sync

複製先は OAuth の同意画面で選択したワークスペースに固定されており、ツールの引数で複製先を変えることはできません。また copy_gallery_template は呼ぶたびに新しいテンプレートを作成します（既存の複製は再利用されません）。

3. スラッシュコマンド（プロンプトテンプレート）

コマンド	用途
`/generate_pdf`	単一 PDF 生成のステップバイステップレシピ
`/generate_pdfs`	一括 PDF 生成のレシピ
`/reportflow_help`	機能ツアー

4. 出力ファイルの保存先

以下の優先順位で解決されます。

ユーザーが明示した場所（例: 「デスクトップに保存して」）
AI クライアントが開いているワークスペースのルート（Claude Code / Cursor / VS Code）
OS の一時ディレクトリ（フォールバック）

リファレンス

Tools（AI が呼び出す）

必要なワークスペース権限は「必要権限」列のとおりです（ワークスペース権限とツールの対応）。

Tool	必要権限	用途
`authenticate`	不要	初回認証・再認証（ローカル実行時のみ）
`list_templates`	閲覧者以上	利用可能なテンプレートの一覧
`get_design_parameters`	閲覧者以上	テンプレートのパラメータスキーマ取得
`search` / `fetch`	閲覧者以上	ワークスペース内のテンプレートを名称の部分一致で解決し（`search`。クエリ省略で全件）、返る `<designId>@<version>` 形式の id でパラメータスキーマを取得する（`fetch`）。`search` / `fetch` という名前のツール対を要求するクライアント向け。いずれも Web 検索・外部サイトへのアクセスは行わず、参照範囲はワークスペース内に限定される
`generate_pdf_sync` / `generate_pdf_async`	閲覧者以上	単一 PDF 生成（同期はパス、非同期は requestId）
`generate_pdfs_sync` / `generate_pdfs_async`	閲覧者以上	複数 PDF 生成（ZIP で返す）
`download_file` / `download_zip`	閲覧者以上	非同期生成結果のダウンロード
`suggest_params`	閲覧者以上	自然言語ブリーフから `params` を MCP Sampling で生成（Sampling 対応クライアント必須）
`search_gallery_templates`	不要	公開テンプレートギャラリーのキーワード検索（認証不要）。返る `slug` は複製前のため PDF 生成には使えない
`get_gallery_template`	不要	ギャラリーテンプレートの詳細を `slug` で取得（認証不要）
`copy_gallery_template`	編集者以上	ギャラリーテンプレートを認可済みワークスペースへ複製（ワークスペースに新しいテンプレートを作る操作）。複製先はアクセストークンに固定され引数指定不可。`designId` / `version` を返し、そのまま `get_design_parameters` → `generate_pdf_sync` に進める

Resources（AI のコンテキストに添付）

URI	必要権限	内容
`reportflow://designs`	閲覧者以上	利用可能なテンプレートの一覧
`reportflow://designs/{designId}/parameters`	閲覧者以上	1 テンプレートのパラメータスキーマ
`reportflow://errors`	不要	Content Service のエラーメッセージカタログ
`reportflow://server-info`	不要	サーバー機能の概要

Prompts

/generate_pdf, /generate_pdfs, /reportflow_help — 引数を渡すと AI が用意されたワークフローに沿って動作します。

トラブルシューティング

まず、症状がリモート接続（コネクタディレクトリ／カスタムコネクタ）とローカル実行（npx）のどちらで起きているかを切り分けてください。

Claude のディレクトリに「Re:port Flow」が見つからない

ディレクトリの一覧内容は、クライアントの種類・バージョン・配信状況によって差が出ることがあります。見つからない場合は、リモート（ホスト型）サーバーの手順でカスタムコネクタとして URL を直接登録すれば、同じサーバーに接続できます。

https://mcp.re-port-flow.com/mcp

接続時に OAuth の同意画面が開かない / 途中で失敗する

最初にサーバー側が生きているかを確認します。

curl -s https://mcp.re-port-flow.com/healthz
curl -s https://mcp.re-port-flow.com/.well-known/oauth-protected-resource

healthz が {"status":"ok"} を返し、ディスカバリ文書が JSON で返るならサーバー側は正常です。その場合は次を確認してください。

ブラウザのポップアップブロックやトラッキング防止機能が、同意画面のウィンドウを止めていないか
社内ネットワークのプロキシ・ファイアウォールが mcp.re-port-flow.com への HTTPS 通信を許可しているか
意図したワークスペースを選択しているか（同意画面のワークスペース選択を見直す）

`401 Unauthorized` が返る

保護対象の呼び出しに有効なアクセストークンが付いていません。応答の WWW-Authenticate ヘッダに、再認証に必要な認可サーバーの情報が含まれます。Claude 側でコネクタをいったん削除してから再接続し、OAuth の同意をやり直してください。

接続はできるがテンプレートが 1 件も出てこない

list_templates は、認可したワークスペースのテンプレートだけを返します。同意画面で別のワークスペースを選択している可能性があるため、コネクタを再接続して目的のワークスペースを選び直してください。テンプレートが 1 件も無い場合でも、AI に「請求書テンプレートを探して」と依頼すれば search_gallery_templates で公開テンプレートギャラリーから候補を探し、copy_gallery_template でワークスペースへ複製してそのまま使い始められます（Re:port Flow の管理画面でゼロからテンプレートを作成することも可能です）。

一部のツールしか表示されない / ツール一覧が短い

ワークスペースでのあなたのロールに応じて、表示されるツールが変わります（ワークスペース権限とツールの対応）。

公開ギャラリーの 2 ツールしか見えない → 認証が完了していないか、そのワークスペースの承認済みメンバーとして解決できていません。コネクタを接続し直して同意画面をやり直してください。
copy_gallery_template だけが見えない → そのワークスペースでのロールが閲覧者（READ）です。テンプレート複製には編集者以上が必要なので、ワークスペースの管理者に権限変更を依頼してください。

`Tool ... disabled` / 「権限では実行できません」と返る

現在のロールで許可されていないツールを呼び出しています。副作用（テンプレート作成・PDF 生成・使用量）は発生していません。必要な権限は権限表を参照し、ワークスペースの管理者に変更を依頼してください。

応答に「権限不足ではなく、権限情報の取得に失敗しています」と書かれている場合はロールの照会そのものに失敗しており、権限設定の問題ではありません。少し待って再実行してください。

リモート接続で PDF がローカルに保存されない

仕様どおりの挙動です。リモートサーバーはクライアントのファイルシステムにアクセスできないため、生成物はダウンロード URL として返されます。ローカルのワークスペースフォルダへ自動保存したい場合はローカル実行（npx）を使ってください。

`re-authentication required` を含むエラー

トークンが失効しています。AI に「ReportFlow に再ログインして」と依頼してください。

`npx` がパッケージを見つけられない

npm cache clean --force

を実行してから再試行してください。

Linux でキーチェーンが使えない

libsecret が無い環境では、自動的に $XDG_STATE_HOME/reportflow-mcp/ 以下のファイル（chmod 0600）にフォールバックします。

SSH / リモートシェルでブラウザが開けない

初回認証だけは ローカルマシン上で 行ってください。一度ログインに成功すれば、保存されたトークンはそのままリモートホストへ持ち込めます（同じ OS のキーチェーンエントリ、または上記のフォールバックファイルを移送）。

`Rate limit exceeded` (429)

ワークスペース単位の API レート制限に達しています。Retry-After ヘッダの秒数だけ待ってから再試行してください。一括生成では非同期エンドポイントの利用を推奨します。

サポート

バグ報告・要望: GitHub Issues
API 全般: API クイックスタート

次のステップ

MCPで帳票PDFを生成する活用例 — AIエージェントから請求書を作る流れと利用場面
非同期ワークフロー設計 — 大量生成のベストプラクティス
Webhook 通知 — 完了通知と HMAC-SHA256 検証
n8n インテグレーション — ローコードワークフロー連携

なぜ Re:port Flow MCP か​

できること​

動作要件​

セットアップ​

Claude のコネクタディレクトリから追加する（最短）​

ローカル実行（npx・推奨）​

Claude Desktop / Claude Code / Cursor​

VS Code（MCP 対応ビルド）​

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

対応プロトコルバージョン​

初回認証​

OAuth と権限（スコープ）​

ワークスペース権限とツールの対応​

使い方​

1. 自然言語で PDF 生成​

2. テンプレート 0 件から始める（ギャラリー検索 → 複製 → 生成）​

3. スラッシュコマンド（プロンプトテンプレート）​

4. 出力ファイルの保存先​

リファレンス​

Tools（AI が呼び出す）​

Resources（AI のコンテキストに添付）​

Prompts​

関連エンドポイント​

トラブルシューティング​

Claude のディレクトリに「Re:port Flow」が見つからない​

接続時に OAuth の同意画面が開かない / 途中で失敗する​

401 Unauthorized が返る​

接続はできるがテンプレートが 1 件も出てこない​

一部のツールしか表示されない / ツール一覧が短い​

Tool ... disabled / 「権限では実行できません」と返る​

リモート接続で PDF がローカルに保存されない​

re-authentication required を含むエラー​

npx がパッケージを見つけられない​

Linux でキーチェーンが使えない​

SSH / リモートシェルでブラウザが開けない​

Rate limit exceeded (429)​

サポート​

次のステップ​