MCP 接続

Signal Foundry MCP は、ChatGPT と Claude から会社検索と Company Card を読むための Remote MCP surface です。

通常の流れは search -> fetch です。まず会社候補を探し、返ってきた id を使って 1 社の Company Card を読みます。Claude Code から使う場合は、このページではなく CLI / Skills の導線を使います。

契約サマリー

API key は貼りません。ChatGPT / Claude 側の OAuth 接続で認証します。

リクエスト

MCP client は JSON-RPC を POST /api/mcp に送ります。ChatGPT / Claude では手動で JSON-RPC を書かず、connector 設定に URL を登録します。

低レベルに確認する場合の endpoint:

POST https://signal-foundry.app/api/mcp
Accept: application/json, text/event-stream
Content-Type: application/json

tools/call は OAuth access token が必要です。認証がない場合は WWW-Authenticate header で protected resource metadata を返します。

ChatGPT で接続する

ChatGPT の connector / MCP 設定で、Signal Foundry の Remote MCP server を追加します。

入力する URL:

https://signal-foundry.app/api/mcp

設定時に確認すること:

• 接続先 URL が /api/mcp で終わっている
• 認証方式が OAuth として始まる
• Signal Foundry のサインイン画面に進む
• 接続後に search、fetch、usage_get が tool として見える

接続後の確認 prompt:

Signal Foundry で「トヨタ」を検索して、最初の候補の Company Card を読んでください。

期待する動き:

1. ChatGPT が search を呼ぶ
2. search が候補の id、title、url を返す
3. ChatGPT が fetch に候補 id を渡す
4. fetch が Company Card の本文、metadata、根拠付き summary を返す

ChatGPT の画面例

ChatGPT の画面名や配置は変わることがあります。確認する値は https://signal-foundry.app/api/mcp、OAuth、search / fetch の tool 表示です。

1. アプリ設定を開く

2. Remote MCP server を作る

3. Signal Foundry でサインインする

4. 権限を確認する

5. ChatGPT から tool を呼ぶ

6. 結果を確認する

Claude で接続する

Claude の connector / remote MCP 設定で、Signal Foundry を追加します。

入力する URL:

https://signal-foundry.app/api/mcp

設定時に確認すること:

• Remote MCP server として追加する
• OAuth 認証で Signal Foundry にサインインする
• 接続後に search と fetch が tool として見える
• tool call が失敗する場合は、connector を再接続してから同じ prompt を再実行する

接続後の確認 prompt:

Signal Foundry で「7203」を検索して、Company Card の会社名、所在地、主な根拠を要約してください。

Claude でも、最初は search -> fetch の順にします。会社別の事例、filing、求人、建設業許可の明細が必要な場合も、まず Company Card の text と metadata を読みます。Remote MCP の公開 tool は CLI の slim surface に揃えています。

レスポンス

search は ChatGPT / Claude が次の fetch に渡せる候補を返します。

見る key:

• results[].id
• results[].title
• results[].url

fetch は 1 社の Company Card を文書として返します。

見る key:

• id
• title
• text
• metadata
• url

warnings、gaps、weak、unsupported、needs_human がある場合は、0 件成功として扱わず回答に残します。

使う tool

通常は primary tools だけを使います。

Remote MCP では company_search、event_search、signals_get などの内部 / source-specific tool を公開しません。ChatGPT / Claude に見せる surface は、CLI の public workflow と同じく Search / Company / Usage に絞ります。

検索の指定

search は会社候補を返します。細かい条件は tool input として渡します。

よく使う指定:

• query: 社名、証券コード、法人番号、domain、短い検索 phrase
• limit: 返す候補数。最大 10
• listing_status: listed, private, delisted, unknown
• prefecture: 東京都 など
• city: 港区 など
• industry_33_code: JPX 33 業種コード
• has_jobs: active job evidence がある会社に絞る
• ai_jobs: AI 関連求人 evidence がある会社に絞る
• construction: 建設業許可がある会社に絞る
• semantic_tag: genai_interest など
• aggregate: 会社数を数える場合に使う

例:

{
  "query": "株式会社UNITE",
  "prefecture": ["東京都"],
  "city": ["港区"],
  "limit": 5
}

集計例:

{
  "aggregate": {
    "metric": "company_count",
    "group_by": "industry_33"
  },
  "listing_status": ["listed"]
}

認証と usage

MCP では API key を ChatGPT / Claude に貼りません。接続画面から OAuth で Signal Foundry にサインインします。

tool call は、通常の API / CLI と同じ account scope、quota、rate limit、credit 境界で扱います。繰り返し調査する場合は usage_get で利用量と残量を確認します。

復旧方法

このページで扱わないこと

• Claude Code での CLI / Skills 運用
• local MCP server
• write action
• batch / bulk automation
• API key を ChatGPT / Claude に貼る運用
• OpenAPI 生成

Claude Code / Codex から実行する場合は Claude Code で使う を使います。既存 backend に直接組み込む場合は API 概要 から HTTP API を選びます。