Magellan Data Spotlight

Magellan Data MCP

AI エージェント向けの企業所有関係インテリジェンス。 Claude、Cursor、または任意の MCP 対応クライアントを Magellan Data の Spotlight プラットフォームに接続し、 何千社もの企業のリストを一度に処理しながら、親会社、PE ファンドの出資状況、企業グループ、 同じポートフォリオ内の企業など、企業の所有関係を尋ねることができます。

ホスト型サーバーです。インストールは不要です。API キーを使って、または claude.ai などのホスト型 コネクターから OAuth で接続できます。

https://spotlight-mcp.magellandata.io/mcp

これは MCP エンドポイントであり、ウェブページではありません。ブラウザーではなく、クライアントの設定に貼り付けてください。 直接開くとエラーが返りますが、これはホスト型 MCP サーバーとして正常な動作です。

質問してみる

接続したら、次のような質問を自然な言葉でできます。

「accounts.xlsxを読み込んで、これらの企業のうちPEファンドの出資を受けている企業と、その出資元を教えてください。」

「Moosendを買収したところです。同じPEファンドが所有するほかの企業をすべて見つけてください。これらは、拡大提案をしやすい対象です。」

「私の200社の取引先のうち、大きな親会社の子会社はどれですか？スプレッドシートに親会社名を追加して保存してください。」

「Constant Contactの親会社傘下にある企業グループ全体をマッピングして、まだ担当していない系列会社を確認できるようにしてください。」

エージェントがパイプライン全体を処理します。バッチを送信し、実行が完了するまでポーリングし、料金を確認して、 結果をinput_urlで元のファイルに結合します。

クイックスタート

1. API キーを取得します。 magellandata.io で登録し、Spotlight ダッシュボードから キーを生成してください。キーはmgln_sk_live_…の形式です。各キーには個別のクレジット残高があり、利用料金は呼び出しを行ったキーに請求されます。

2. クライアントを接続します。

claude mcp add --transport http magellan-data https://spotlight-mcp.magellandata.io/mcp \
  --header "Authorization: Bearer mgln_sk_live_YOUR_KEY"

claude mcp list   # expect: magellan-data ... ✓ Connected

{
  "mcpServers": {
    "magellan-data": {
      "url": "https://spotlight-mcp.magellandata.io/mcp",
      "headers": {
        "Authorization": "Bearer mgln_sk_live_YOUR_KEY"
      }
    }
  }
}

{
  "inputs": [
    {
      "type": "promptString",
      "id": "magellanKey",
      "description": "Magellan Data API key (mgln_sk_live_...)",
      "password": true
    }
  ],
  "servers": {
    "magellan-data": {
      "type": "http",
      "url": "https://spotlight-mcp.magellandata.io/mcp",
      "headers": { "Authorization": "Bearer ${input:magellanKey}" }
    }
  }
}

3. 接続を確認します。 エージェントに「Magellan Data のクレジット残高を確認してください」と尋ねます。数値が返ってくれば 接続されています。この呼び出しは無料です。

認証

2つの方法に対応しています。接続方法に合ったものをお使いください。

API キー（mgln_sk_live_…）— Claude Code、Cursor などのローカルクライアントや CLI クライアント、 または手動で設定するクライアント向けです。Spotlight ダッシュボードでキーを生成し、 上記のクイックスタートのとおり、Authorizationヘッダーに Bearer トークンとして指定してください。利用料金は呼び出しを行ったキーに請求されます。

OAuth 2.1 — claude.ai や ChatGPT などのホスト型コネクター向けです。お客様側で OAuth 固有の設定を行う必要はありません。 コネクターを追加すると（ディレクトリから追加する場合、またはプラットフォームがクライアント認証情報を保持するカスタムコネクターとして追加する場合）、 Spotlight でのサインインとアクセスの承認に案内されます。一般的な「接続、サインイン、許可」のフローです。 その後のトークン処理はクライアントが行います。利用料金は、承認に使用した Spotlight アカウントに請求されます。

いずれの方法でも、すべてのリクエストは認証され、1つの Spotlight アカウントに紐付けられます。 2つの方法の違いは、認証情報がサーバーに届く方法だけです。

調べられる情報

parent_companiesとpe_ownershipでは、該当した場合にのみ料金がかかります。何も見つからなかったURLの料金はかからないため、70クレジット×URL数は請求額ではなく、上限額です。他の2つは、出力レコードごとの料金です。いずれの場合も、実行が完了すると正確な料金が分かります。エージェントが実行結果から料金を確認し、ダウンロード前にお知らせします。

クレジットの仕組み

自律型エージェントが残高を知らないうちに消費してしまわないようにする仕組みなので、ここは理解しておく価値があります。

• バッチの送信は無料です。 処理の実行開始、ステータスの確認、残高の確認も無料です。
• クレジットが請求されるのは、download_runの1か所だけです。 それ以前の操作に料金はかかりません。
• エージェントが先に料金を提示します。 各実行にはpriceフィールドがあり、サーバーは接続されたクライアントに、その金額を伝えてからダウンロード前にユーザーの確認を待つよう指示します。
• 再ダウンロードは、いつでも無料です。 実行結果を購入すると、その状態は維持されます。ダウンロードリンクの有効期限が切れた場合は、もう一度依頼してください。追加料金はかかりません。

料金について考えたくない場合は、「これにいくらかかるか」までの操作はすべて無料で、エージェントが確認を求めます。

ツール

フローは常に送信 → 処理 → ポーリング → ダウンロードです。結果はインラインではなく、短いダウンロードリンク（https://api.magellandata.io/dl/…、有効期間は1時間）で返されるため、200万行の結果セットがエージェントのコンテキストウィンドウに入ることはありません。このリンクには認証ヘッダーが不要なので、そのままcurl、pandas.read_csv、またはブラウザーに渡せます。claude.aiコネクターのように一般的なインターネットアクセスがないホスト型チャット環境では、アシスタントが自ら取得するのではなく、ユーザーが開けるクリック可能なリンクとして提示します。

magellan_playbookプロンプトもあります。これは、拡大ターゲットのランキング、deal_typeの解釈、MSA締結時期のトリガーを扱うGTM戦略ガイドです。Claude Codeでは、magellan-dataサーバーのスラッシュコマンドとして表示されます。

実行例

examples/quickstart.py は、REST API に直接接続してパイプライン全体を実行します。エージェントが内部で何をしているかを理解したい場合や、Magellan Data をエージェントを使わないパイプラインに組み込む場合に便利です。

export MAGELLAN_API_KEY=mgln_sk_live_YOUR_KEY
python examples/quickstart.py --urls moosend.com constantcontact.com --type pe_ownership

examples/accounts.csv と accounts.xlsx は、独自のデータを用意しなくてもエージェントに渡せる、12 行のサンプルデータです。独立系企業、買収された子会社、PE の支援を受けた企業が含まれているため、どの出力タイプでも結果が得られます。12 社すべてをエンリッチしても、マッチベースの出力タイプごとに最大 840 クレジットです（何かが見つかった企業にのみ課金されます）。実際にパイプラインを検証するには十分安価です。

ダウンロードの前に処理を停止して確認を求めるため、実行するまではクレジットを消費せずに最初から最後まで試せます。

examples/PROMPTS.md では、意欲の度合いを高めていくエージェント向けプロンプトを、各プロンプトの想定コストを冒頭に示しながら順を追って説明しています。

スキル

skills/ ディレクトリには、ツールの生の出力を JSON ではなく、ランク付けされたターゲットリスト、カバレッジマップ、エンリッチ済みスプレッドシートなどの完成した成果物に変換する、タスクに特化したプレイブックが含まれています。スキルに対応したクライアントはこのリポジトリから読み込めます。対応していないクライアントでも、Markdown ファイルを直接指定できます。

リポジトリの内容

.mcp.json                     MCP registration (Claude Code, Codex)
mcp.json                      MCP registration (Cursor)
.vscode/mcp.json              MCP registration (VS Code, prompts for key)
.claude-plugin/
  plugin.json                 Claude plugin metadata
  marketplace.json            Claude marketplace metadata
server.json                   Official MCP Registry metadata
skills/*/SKILL.md             Task playbooks
examples/
  quickstart.py               Full pipeline against the REST API
  PROMPTS.md                  Agent prompt walkthrough
  accounts.csv         12-row test fixture
  accounts.xlsx        Same fixture, spreadsheet form
assets/
  logo.png                    Wordmark, navy (for light backgrounds)
  logo-light.png              Wordmark, white (for dark backgrounds)
  social-preview.png          1280x640 social card — upload under
                              Settings > Social preview
  social-preview-light.png    Light-background alternate

マニフェストをローカルで使用するには、次の手順に従います。

git clone https://github.com/sorrek/mcp.git

その後、クライアントにリポジトリのルートまたは特定のマニフェストのパスを指定します。

トラブルシューティング

ブラウザーでエンドポイント URL を開くとエラーが表示されます。 想定どおりです。/mcp は POST 経由で JSON-RPC を扱います。トランスポート仕様では、そのパスへの GET はイベントストリームの開始用に予約されています。そのため、このようにストリームを提供しないサーバーは 405 を返します。そこには何も表示されません。サーバーが実際に稼働しているか確認するには、エージェントに check_credits を呼び出すよう依頼してください。無料で、認証経路全体を確認できます。

クライアントは接続しますが、ツールが表示されません。 ほとんどの場合、トランスポートではなく認証の問題です。ヘッダーが Bearer プレフィックス付きの Authorization: Bearer mgln_sk_live_... になっていることと、Spotlight ダッシュボードでキーが有効になっていることを確認してください。

ダウンロードリンクが期限切れと表示されます（HTTP 410）。 ダウンロードリンクの有効期間は 1 時間です。download_run を再度呼び出して新しいリンクを取得してください。再ダウンロードは無料です。

実行が長時間 processing のままです。 大規模なバッチは秒ではなく分単位でかかります。短い間隔で繰り返すのではなく、10～30 秒ごとにポーリングしてください。実行が 20 分を超えても続く場合は、run_id を添えて issue を作成してください。

注意事項と制限

• バッチサイズ： 1 バッチあたり最大 5,000 URL です。それより大きなリストは分割する必要があります。依頼すれば、エージェントが分割します。
• 所要時間： 大規模な実行は秒ではなく分単位でかかります。10～30 秒ごとのポーリングが適切な間隔であり、サーバーの指示にも記載されています。
• 入力の重複： 2 社の入力企業が同じ親会社または PE ファームを共有している場合、両方の入力に課金されます。すべての出力行に input_url が含まれるため、クライアント側での重複排除は簡単です。
• 認証： すべてのリクエストには API キーまたは OAuth トークンが含まれるため（認証を参照）、使用状況は常に適切な Spotlight アカウントに紐付けられます。

ロードマップ

• 公式 MCP Registry および関連ディレクトリへの掲載
• 所有関係レコードへの last_verified タイムスタンプの追加

issue や機能リクエストを歓迎します。このリポジトリで issue を作成してください。

サポート

• API ドキュメント： docs.magellandata.io
• バグとリクエスト： イシューを作成
• データ品質に関する問題： [email protected]
• 商用に関するお問い合わせ： magellandata.io

ライセンス

MIT — このリポジトリに適用されます。Spotlight API 自体は商用サービスであり、Magellan Data の利用規約が適用されます。