MCP Server (Claude / Cursor / VS Code)

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

• ホスト型エンドポイント（npm 不要）: https://mcp.re-port-flow.com/mcp
• npm: reportflow-mcp
• ソース: github.com/re-port-flow/reportflow-mcp
• MCP Registry: io.github.re-port-flow/reportflow-mcp

なぜ Report Flow MCP か

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

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

できること

• 「Acme 社向けに合計 ¥33,000 の請求書を作って」のような自然言語から PDF を生成
• ワークスペースのデザインとパラメータスキーマを MCP Resources として AI に直接公開
• 複数 PDF を一括生成し ZIP で受け取り
• 出力ファイルを、AI クライアントが現在開いているワークスペースフォルダに保存

動作要件

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

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

セットアップ

セットアップには 2 つの方法があります。ローカル実行（npx）が推奨で、生成した PDF をローカルのワークスペースフォルダに保存できます。Node.js を入れたくない場合や、Claude.ai（Web）などブラウザベースのクライアントから使う場合は、リモート（ホスト型）サーバーを利用できます。

ローカル実行（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 の同意画面が表示されます。

ローカル実行との違い

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

初回認証

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

ReportFlow にログインして

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

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

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

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

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

使い方

1. 自然言語で PDF 生成

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

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

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

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

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

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

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

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

リファレンス

Tools（AI が呼び出す）

Tool	用途
authenticate	初回認証・再認証
list_templates	利用可能なデザインの一覧
get_design_parameters	デザインのパラメータスキーマ取得
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 対応クライアント必須）

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 が用意されたワークフローに沿って動作します。

関連エンドポイント

MCP サーバー内部では Report Flow API を呼び出しています。詳細は API リファレンスを参照してください。

• Single PDF Sync Generation
• Single PDF Async Generation
• Multiple PDF Sync Generation
• Multiple PDF Async Generation
• File Download
• Design Parameters

トラブルシューティング

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 全般: Report Flow API ドキュメント

次のステップ

• 非同期ワークフロー設計 — 大量生成のベストプラクティス
• Webhook 通知 — 完了通知と HMAC-SHA256 検証
• n8n インテグレーション — ローコードワークフロー連携