AI / MCP
AI連携（MCP・REST API）の使い方
Compalyze は MCP（Model Context Protocol）に対応しています。Claude・ChatGPT・Cursor などの AI クライアントから、企業データを会話の中で直接呼び出せます。Pro・Growth プランでは、MCP クライアントなしで使える REST API も同じツール・クレジットで利用できます。
できること
AI に「この会社の決算を要約して」「この条件の企業を探して」と頼むだけで、Compalyze のデータをもとに答えます。
- 企業プロフィール・決算・KPI・役員・関係企業の取得
- 条件を指定した企業の発見（業種・地域・規模など）
- ニュース・イベントなど直近の動きの取得
- 取得したデータをそのまま AI で分析・要約・比較
はじめ方
API キーを発行する
cpz_で始まり、発行直後の1度だけ全体が表示されます。その場で控えてください（API キーは Free を含む全プランで発行できます）。AI クライアントに接続する
エンドポイント
https://mcp.compalyze.co.jp/mcp認証ヘッダー
Authorization: Bearer cpz_...Claude Code / Claude Desktop / Cursor / Windsurf / ChatGPT それぞれの具体的な設定手順は、MCP API のページに画面付きでまとめています。
会話の中で使う
クレジットの仕組み
MCP の利用は「クレジット」で消費します。ツールの呼び出し1回ごとに、次のクレジットを消費します（ページ送りは各ページが別の呼び出し扱い）。
| ツール | 消費 |
|---|---|
| search_companies社名・フリガナ・13桁法人番号で企業をピンポイント検索する。 | 1 credit / コール |
| discover_companies業種・タグ・キーワードの条件で企業を発掘する。 | mode="filter": 1 credit ／ mode="search": 3 credits per 250行（size≤250 → 3cr、size=1000 → 12cr） |
| match_companies社名リストを法人番号へ一括で名寄せする。 | 1 credit 固定（行数に依らない） |
| search_timeline企業をまたいでイベント（PR・知財・登記・政府調達・補助金・ネガティブ）を検索する。 | corporate_numbers[] 指定時: 1 credit ／ 未指定（横断探索）: 3 credits。ページごとに課金 |
| get_company_events1社の構造イベント（登記変更・特許・政府関連・組織再編）を取得する。 | 1 credit / ページ |
| get_company_news1社のプレスリリース・ニュースを取得する。 | 1 credit / ページ |
| get_company_financials決算公告ベースの財務データ（売上・総資産・純資産等）を会計期ごとに取得する。 | 1 credit / コール |
| get_company_kpis企業固有の KPI 時系列（ARR・店舗数・解約率など）を取得する。 | 1 credit / コール |
| get_company_relations子会社・関連会社・取引先などの企業間リレーションを取得する。 | 1 credit / ページ |
| get_company_officers役員・取締役の一覧を取得する（既定は現任のみ）。 | 1 credit / コール |
| get_company_register登記簿の構造化 JSON を取得する（資本構成・機関設計・本店支店・目的・登記記録など）。Pro 以上 | 10 credits / コール |
| report_data_issueデータの不備を報告する（選択式のみ、自由記述なし）。 | 0 credits |
月間に使えるクレジットはプランごとに決まっており、毎月（日本時間の月初）にリセットされます。
| プラン | 月間クレジット | レート制限 |
|---|---|---|
| Free | 20 / 月 | 20 req/min（瞬間24） |
| Starter | 200 / 月 | 60 req/min（瞬間72） |
| Pro | 2,000 / 月 | 120 req/min（瞬間144） |
| Growth | 10,000 / 月 | 300 req/min（瞬間360） |
月間クレジットを使い切った場合、その月の呼び出しはエラーになります(超過分が自動で課金されることはありません)。毎月 1 日にリセットされます。継続利用にはプラン変更をご検討ください。
データの誤りを見つけたら
report_data_issueツールでの報告はクレジットを消費しません。気づいた点はお気軽に報告してください。REST API で使う（Pro・Growth）
MCP クライアントがなくても、通常の HTTP リクエストから同じツールを呼び出せます。curl や Python の requests など、どの言語・ツールからでも利用できます。
呼び出せるツール・1回あたりのクレジット消費・返ってくる JSON は、上記の MCP とまったく同じです（クレジットも同じ月間枠を共有します）。ツール一覧はhttps://mcp.compalyze.co.jp/v1/toolsから取得できます。
リクエスト先（ツールごとに1エンドポイント）
POST https://mcp.compalyze.co.jp/v1/<ツール名>認証ヘッダー（MCP と共通）
Authorization: Bearer cpz_...curl -X POST https://mcp.compalyze.co.jp/v1/search_companies \
-H "Authorization: Bearer cpz_xxxxx" \
-H "Content-Type: application/json" \
-d '{"query": "コンパライズ"}'REST API は Pro・Growth プラン