Re:port Flow MCP

正式な表示名: Re:port Flow MCP。パッケージおよび実装識別子: reportflow-mcp。レガシー検索エイリアス: ReportFlow MCP Server および ReportFlow。

概要

あなたの Re:port Flow テンプレートをPDFレポートに変換するMCP（Model Context Protocol）サーバーです。請求書、契約書、明細書など、デザインしたあらゆるものを、Claudeやその他のMCP互換AIエージェントから直接生成できます。

Related MCP server: PDF Tools AI MCP

機能

• "Acme Corpに合計$300の請求書を作成して" のような自然言語のリクエストからPDFを生成

• Re:port Flowのデザインとそのパラメータスキーマを、MCP リソースとしてAIに直接公開

• 多数のPDFを一括生成し、単一のZIPとしてダウンロード

• ユーザーが現在いるワークスペースフォルダに出力を保存（Claude Desktop / Claude Code / Cursor / VS Code すべて対応）

セットアップ

Re:port Flow MCP は2つの方法で動作します。お使いのクライアントに合わせて選択してください。

リモートサーバー（claude.ai / Webクライアント）— Streamable HTTP

Re:port Flow をホストされたエンドポイントに向けたカスタムコネクタとして追加します。

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

Claude（claude.ai）で 設定 → コネクタ → カスタムコネクタを追加 に移動し、 上記のURLを貼り付けます。認証はOAuth経由でアプリ内で処理されます（ 認証 を参照）。ローカルにインストールするものはありません。

ローカルサーバー（Claude Desktop / Claude Code / Cursor）— stdio via npx

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

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

設定は以上です。環境変数もAPIキーも、管理するシークレットもありません。

VS Code（MCP対応ビルド）

.vscode/mcp.json にも同じJSONを配置します。

要件

• リモート: カスタムHTTPコネクタをサポートするMCPクライアント（例：claude.ai）。ローカルインストール不要。

• ローカル（stdio）: Node.js 22以上（npxが自動取得）と、初回ログイン時に利用可能なブラウザが必要です。

• Re:port Flow アカウント（どちらの場合も必要）。

対応プロトコルリビジョン

両方のトランスポート（stdio / Streamable HTTP）は、単一のエンドポイントから2世代の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 を送信し続けます。どちら側でも設定は不要で、既存の接続はそのまま動作し続けます。

認証

リモート（claude.ai）

コネクタを追加すると、ClaudeがOAuthフローを実行してくれます: サインイン → ワークスペースを選択 → 同意。トークンはクライアント側で保持されるため、ローカルのキーチェーンやブラウザの操作は不要です。

ローカル（stdio）

MCPクライアントを再読み込みした後、AIに次のように依頼します:

Re:port Flow に認証してください

ブラウザウィンドウが開きます。サインイン → ワークスペースを選択 → 同意 で完了です。トークンはOSのキーチェーン（macOSキーチェーン / Windows Credential Manager / Linux libsecret）に保存され、chmod-0600 のファイルへのフォールバックもあり、自動的に更新されます。

使用例

以下の各例はそのまま貼り付けられるプロンプトです。AIが適切なツールを選択します。

1. 単一PDFの生成（一覧 → スキーマ → 生成）

請求書テンプレートを使用して、Acme Corp 宛ての合計$330のPDFを作成してください。

AIは list_templates でデザインを一覧表示し、get_design_parameters でパラメータスキーマを取得し、値を入力して generate_pdf_sync を呼び出します。

• リモート: ダウンロードURL（fileUrl）を返します。

• ローカル: ファイルを保存し、その絶対パスも返します。

2. 複数PDFの一括生成

明細書テンプレートから、顧客ごとに1つのPDFを生成してください （Acme $100、Globex $250、Initech $80）。まとめて渡してください。

• ローカル（stdio）: generate_pdfs_sync がワークスペースに単一のZIPを書き込みます。

• リモート: generate_pdfs_async がバッチを実行し、リクエストIDとダウンロードURLを返します。

3. 非同期生成後にダウンロード（ローカル）

契約書PDFをバックグラウンドで生成し、準備ができたらダウンロードしてください。

AIは generate_pdf_async を呼び出し（即座に requestId を返します）、その後 download_file で完成したPDFを保存します。バッチの場合は generate_pdfs_async → download_zip です。これらのダウンロードツールはstdio専用です。リモートサーバーでは、同期/非同期ツールがすでに fileUrl を返します。

ヒント — 自然言語パラメータ: Sampling対応クライアントでは、 "A社宛ての$1,000の請求書のパラメータをドラフトして" と依頼できます。 AIは生成前に suggest_params を呼び出して、 その要点を有効な params オブジェクトに変換します。

4. ゼロから始める（ギャラリー → コピー → 生成）

テンプレートがまだありません — Acme Corp の請求書PDFを作成してください。

list_templates が空の場合、AIは search_gallery_templates で公開テンプレートギャラリーを検索し、候補を表示して、copy_gallery_template で選択したテンプレートをワークスペースにコピーし、通常のフロー（get_design_parameters → generate_pdf_sync）を続行します。コピー先は常にOAuth同意画面で選択したワークスペースになります。AIが他のワークスペースを対象にすることはできません。

スラッシュコマンド

ファイルの保存先（ローカルモード）

出力場所は次の順序で決定されます:

1. ユーザーからの明示的な指示（例："デスクトップに保存して"）

2. 現在開いているワークスペースのルート（Claude Code / Cursor / VS Code）

3. フォールバックとしてOSの一時ディレクトリ

リファレンス

ツール（AIが呼び出し）

リソース（AIコンテキストとして添付可能）

プロンプト（スラッシュコマンドレシピカード）

/generate_pdf, /generate_pdfs, /reportflow_help — 引数を渡すと、AIが準備されたワークフローに従います。

トラブルシューティング

プライバシー

Re:port Flow MCP はシンクライアントです：お客様のリクエストを自分自身の Re:port Flow アカウントに転送し、生成された PDF を返します。お客様のデータを第三者に販売または共有することはありません。 認証トークンはローカルに保存され（OSキーチェーン、または chmod-0600 ファイルへのフォールバック）、Re:port Flow 自身のサービスにのみ送信されます — OAuthログイン中、および認証済みAPI呼び出しのたびに Bearer 資格情報として（テンプレートの一覧表示、PDFの生成またはダウンロード）。 第三者と共有されることは決してありません。

完全なプライバシーポリシー（収集される情報、保持期間、取り扱い方法）については、lp.re-port-flow.com を参照してください。

セキュリティ

ホスト型エンドポイントは Host ヘッダーを検証し（DNSリバインディング保護）、構造的に無効な Origin ヘッダーを 403 Forbidden で拒否します。これは MCP Streamable HTTP 仕様のセキュリティ要件に従っています。認証はBearerトークンのみです — cookieはなく、CORSが資格情報を許可することもありません。完全なポリシーとその脅威モデルは docs/security.md に文書化されています（日本語）。

サポート

ヘルプが必要ですか、バグを見つけましたか、それともディレクトリレビューの質問がありますか？

• Re:port Flow（プライバシーとサポート）：https://lp.re-port-flow.com

• GitHub Issues：https://github.com/re-port-flow/reportflow-mcp/issues

ライセンス

MIT — LICENSE を参照してください。

リンク

• Re:port Flow：https://re-port-flow.com

• プライバシーとサポート：https://lp.re-port-flow.com

• npm：https://www.npmjs.com/package/reportflow-mcp

• Issues：https://github.com/re-port-flow/reportflow-mcp/issues