Reportflow Mcp

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 エージェントから直接利用できます。

機能

• *「Acme Corp 宛てに合計 300 ドルの請求書を作成して」*のような自然言語のリクエストから PDF を生成
• Re:port Flow のデザインとそのパラメータースキーマを、MCP リソースとして AI に直接公開
• 多数の PDF を一括生成し、単一の ZIP ファイルとしてダウンロード
• ユーザーが現在使用しているワークスペースのフォルダーに出力を保存（Claude Desktop / Claude Code / Cursor / VS Code に対応）

エージェントスキル

プロトコルを読むだけでなく、手順に従う必要があるエージェントは、 skills/re-port-flow/SKILL.md を使用してください。 このディレクトリを Claude Code / Codex の .agents/skills または Cursor のプロジェクトスキル フォルダーにコピーします。PDF の生成は常に https://mcp.re-port-flow.com/mcp に送信されます。 Hugging Face Space MCP（組織カード）はギャラリー専用です。 製品エンドポイントの代わりとしてではなく、Space の MCP バッジ → Add to MCP tools から 追加してください。

セットアップ

Re:port Flow MCP の実行方法は 2 種類あります。お使いのクライアントに合った方法を選んでください。

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

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

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

Claude（claude.ai）で Settings → Connectors → Add custom connector に移動し、上記の URL を貼り付けます。認証はアプリ内で OAuth により処理されます（ 認証を参照）。ローカルへのインストールは不要です。

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

設定ファイル（.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）：22.x 系の Node.js 22.23.4 以降（engines: ^22.23.4）と、初回ログイン時に利用可能なブラウザーが必要です。パッチ適用済みの Node.js を別途インストールしてください。npx が MCP パッケージをダウンロードします。最低パッチ要件には、2026-10-21 の Node.js セキュリティ修正が含まれます。
• 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を送信します。どちらの側でも設定は不要で、既存の接続も変更なく動作します。

どちらのハンドシェイクでも、MCPのinstructionsが返されます。これは、Re:port Flowの機能と最初のPDFを取得する方法（ギャラリーで検索 → コピー → パラメーター設定 → 生成）を接続されたAIに伝える簡潔な説明です。これにより、依頼されるのを待たずに、接続直後からドキュメントの作成を提案できます。クライアントがこれらの指示にどの程度従うかは、そのクライアントによります。

A2A（Agent2Agent）

リモートサーバーは、JSON-RPCバインディングでA2A v1.0にも対応しています。

• エージェントカード：https://mcp.re-port-flow.com/.well-known/agent-card.json
• エンドポイント：POST https://mcp.re-port-flow.com/a2a（SendMessage）

各A2Aスキルは、上記のMCPツールのいずれかです（スキルIDはツール名です）。データパート{"skill": "<tool name>", "arguments": {...}}を含むメッセージを送信してください。引数はそのツールの入力スキーマに従い、呼び出しはMCPと同じ認証およびワークスペースの権限を通じて実行されます。同じOAuthフローで認証してください（MCPアクセストークンをそのまま使用できます）。ストリーミング、プッシュ通知、タスクの取得には対応していません。すべてのSendMessageは完了済みのタスクを返します。

認証

リモート（claude.ai）

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

ローカル（stdio）

MCPクライアントを再読み込みした後、AIに次のように尋ねてください。

Authenticate with Re:port Flow

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

使用例

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

1. PDFを1つ生成する（一覧 → スキーマ → 生成）

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

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

• リモート：fileUrl（Re:port Flow Webアプリの出力履歴ページ）を返します（サインインが必要です）。直接ファイルをダウンロードするリンクではありません。
• 同期生成は60秒後にタイムアウトします（APIは504を返します）。それ以上かかる可能性がある場合は、generate_pdfs_asyncを使用してください。
• ローカル：ファイルも保存し、その絶対パスを返します。

2. PDFをまとめて生成する

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

• ローカル（stdio）：generate_pdfs_syncは、ワークスペースに単一のZIPファイルを書き込みます。
• リモート：generate_pdfs_asyncがバッチを実行し、リクエストIDと 出力履歴ページのURL（url）を返します。get_generation_statusで、 バッチが完了または失敗したかを確認できます。

3. 非同期で生成してからダウンロードする（ローカル）

契約書の PDF 生成をバックグラウンドで開始し、準備ができたらダウンロードします。

AI は generate_pdf_async を呼び出し（すぐに requestId を返します）、get_generation_status で進行状況を確認してから、download_file を呼び出して完成した PDF を保存します。一括生成に相当するのは generate_pdfs_async → download_zip です。ファイルの生成中にダウンロードを試みると、ツールは失敗する代わりに、待機する秒数とともに FILE_NOT_READY を返します。これらのダウンロードツールは stdio 専用です。リモートサーバーでは、同期／非同期ツールは代わりに出力履歴ページの URL を返します。

requestId、fileId、designId は UUID ではなく、短い英数字の文字列です（例：0eUDdgAjNXrrItA2）。

ヒント — 自然言語のパラメーター： 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 はほかのワークスペースをコピー先に指定できません。

検索で何も見つからない場合、結果には templateSite のリンクが含まれます。テンプレートギャラリーサイトでデザインを閲覧できます。気に入ったデザインのページ URL（/templates/{slug}）を共有すると、AI はその slug を使ってコピーします。

スラッシュコマンド

コマンド	目的
/generate_pdf	単一 PDF の手順付きレシピ
/generate_pdfs	PDF の一括生成レシピ
/reportflow_help	機能の概要

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

出力先は次の順に決定されます。

1. ユーザーからの明示的な指示（例：「デスクトップに保存して」）
2. 現在開いているワークスペースのルート（Claude Code / Cursor / VS Code）
3. フォールバックとして OS の一時ディレクトリ

独自のエージェントを構築する

上記のセットアップでは、接続とログインを独自に管理する MCP クライアントを想定しています。エージェントを自分で作成する場合（Hugging Face Agents、カスタムのツールループ、生の HTTP など）、ホスト型エンドポイントを直接利用できます。

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

• agents.md — エージェント向けガイドです。トランスポートの詳細、10 個の HTTP ツール、OAuth フロー、モデルの選択、エージェントが従うべきルール（業務データを決して捏造しないこと、copy_gallery_template は冪等ではないこと、passthrough の値が PDF のメタデータに含まれること）を説明しています。
• examples/ — 実行可能な Python、JavaScript、curl クライアントのほか、OAuth フローを実行してアクセストークンを表示するスクリプトも含まれています。

initialize と tools/list は認証情報なしで動作するため、認証を組み込む前にツールセットを確認できます。tools/call にはすべて Bearer トークンが必要です。

Hugging Face

Re:port Flow は Hub の huggingface.co/reportflow で公開されています。Hugging Face SDK には独自の MCP OAuth フローがないため、examples/oauth/get-token.sh で一度トークンを取得し、Authorization ヘッダーとして渡してください。詳しくは、examples/python/hf_mcp_client.py と examples/javascript/hf-mcp-client.mjs を参照してください。

リファレンス

ツール（AI が呼び出します）

ツール	目的
authenticate	初回認証／再認証
list_templates	利用可能なデザインの一覧表示
get_design_parameters	デザインのパラメータースキーマを取得
generate_pdf_sync / _async	PDF を 1 つ生成（同期版はパスを返し、非同期版はリクエスト ID を返します）
generate_pdfs_sync / _async	PDF を複数生成（ZIP を返します）
get_generation_status	非同期リクエスト（requestId）の状態を確認（processing／completed／failed）。失敗時は code と message を返します
download_file / download_zip	非同期ツールで生成された成果物をダウンロード（stdio のみ）。ファイルの生成中は FILE_NOT_READY と待機秒数を返します
suggest_params	MCP Sampling を介して自然言語の概要を params JSON に変換（Sampling 対応クライアントが必要です）
search / fetch	ChatGPT コネクターの規約に準拠したツール（引数は文字列 1 つ）、クローズドワールド（openWorldHint: false）。読み取るのは自身のワークスペース内のテンプレートカタログのみで、ウェブは参照しません。search は名前でテンプレートを検索し、fetch は ID でテンプレートのパラメータースキーマを返します。ChatGPT（開発者モードのない Plus／Pro を含む）がテンプレートを検索して確認できるようにする、list_templates／get_design_parameters の薄いラッパーです。
search_gallery_templates	公開テンプレートギャラリーをキーワード／カテゴリで検索（認証不要）。ワークスペースにはまだない候補テンプレートを返します。コピーするまでは、その slug を PDF 生成に使用できません。
get_gallery_template	公開ギャラリーのテンプレート 1 つについて、slug で詳細をすべて取得（認証不要）
copy_gallery_template	書き込みツール。 ギャラリーテンプレートを、認証済みのワークスペースにコピーします（対象のワークスペースはアクセストークンによって固定され、引数として渡すことはできません）。get_design_parameters／generate_pdf_sync ですぐに使用できる designId と version を返します。呼び出すたびに新しいデザインを作成し、以前のコピーを再利用することはありません。

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

URI	内容
reportflow://designs	利用可能なデザインの一覧
reportflow://designs/{designId}/parameters	1 つのデザインのパラメータースキーマ
reportflow://errors	Content Service のエラーメッセージカタログ
reportflow://server-info	サーバーの機能概要

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

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

トラブルシューティング

症状	対処方法
re-authentication required を含むエラー	AI に 「Re:port Flow で再認証して」 と依頼します
npx がパッケージを見つけられない	npm cache clean --force を実行してから再試行します
Linux でキーチェーンを利用できない	$XDG_STATE_HOME/reportflow-mcp/ 配下の chmod-0600 ファイルに自動的にフォールバックします
SSH／リモートシェル経由でブラウザーを開けない	ローカルマシンで一度だけ認証します。その後はキャッシュされたトークンをリモートホストで使用できます

プライバシー

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

収集される情報、保持期間、取り扱い方法を含むプライバシーポリシー全文については、lp.re-port-flow.com をご覧ください。

セキュリティ

ホスト型エンドポイントはHostヘッダーを検証し（DNSリバインディング対策）、MCP Streamable HTTP仕様のセキュリティ要件に従って、構造的に無効なOriginヘッダーを403 Forbiddenで拒否します。認証方式はベアラートークンのみです。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
• Hugging Face：https://huggingface.co/reportflow
• エージェントガイド：agents.md
• 使用例：examples/
• Issues：https://github.com/re-port-flow/reportflow-mcp/issues