raportagent-mcp

RaportAgent MCP サーバー

MCP（Model Context Protocol） サーバーです。RaportAgent を Claude Desktop、Claude Code、Cursor など、あらゆる MCP クライアントで利用できます。アシスタントに市場調査や規制環境の分析を依頼すると、出典付きの RaportAgent レポートを作成し、完成した Markdown と監査証跡を取得します。

RaportAgent REST API（/v1）を薄くラップしているため、API キーごとのレート制限、クレジットモデル、監査証跡はそのまま引き継がれます。

ツール

ツール	説明
generate_report	レポートを開始します（query、任意のtemplate：compliance/pitch/saas/ecommerce/realestate/local/battlecard/duediligence/fintech）。report_idを返します。任意でwait_secondsを指定すると、完了までポーリングします。1 クレジット（battlecardの場合は 2 クレジット）が必要です。
get_report_status	queued / running / completed / failed のステータスを取得します
get_report	完成したレポートの Markdown 全文とセクションを取得します
get_report_audit	来歴情報：AI モデル、エージェント、ソース数、コンテンツの正確な内容の SHA-256
get_report_sources	引用されたすべてのソースとリンクの状態別件数（有効／不確実／無効）
cancel_report	キュー内または実行中のレポートをキャンセルし、クレジットを払い戻します
list_reports	最近のレポート一覧
get_account	残りのクレジットとプラン

セットアップ

1. API キーを取得します：RaportAgent → My account → API keys（ra_live_… キー）。
2. MCP クライアントに登録します。クローンもビルドも不要で、公開済みパッケージを npx が取得します。

Claude Desktop

claude_desktop_config.json に追加します （macOS：~/Library/Application Support/Claude/、Windows：%APPDATA%\Claude\）：

{
  "mcpServers": {
    "raportagent": {
      "command": "npx",
      "args": ["-y", "@raportagent/mcp"],
      "env": {
        "RAPORTAGENT_API_KEY": "ra_live_xxx"
      }
    }
  }
}

Claude Code

claude mcp add raportagent -e RAPORTAGENT_API_KEY=ra_live_xxx -- npx -y @raportagent/mcp

Cursor

上記の Claude Desktop と同じ command／args／env の形式で、Cursor の MCP 設定に追加します。

ソースから実行する場合（コントリビューション／デバッグのみ）

git clone https://github.com/raportagent/raportagent-mcp.git
cd mcp-server
npm install
npm run build

その後、command／args を npx ではなく、絶対パスを指定した node／dist/index.js に設定します。

設定

環境変数	デフォルト	備考
RAPORTAGENT_API_KEY	—	必須です。 ra_live_… キー。
RAPORTAGENT_BASE_URL	https://raportagent.com	セルフホスト環境／ステージング環境向けの上書き設定です。

注意事項

• 生成には通常約 15 分かかります。generate_report はすぐに report_id を返します。get_report を呼び出す前に、アシスタントは get_report_status をポーリングするか、wait_seconds を指定してください。
• stdout は MCP トランスポートとして使われます。サーバーのログは stderr にのみ出力されます。
• API キーが送信されるのは、設定した RAPORTAGENT_BASE_URL のみです。