MCP 接続

Signal Foundry MCP は、ChatGPT と Claude から会社、event、求人、建設業許可、展示会を検索し、Company Card と関連 evidence を読むための Remote MCP surface です。

公開toolは search と fetch の2つです。

AI clientが依頼の意味から search.operation と引数を選びます。 Signal Foundry serverは自然言語からoperationを推測せず、operationごとの入力schema、account scope、permission、quota、rate limit、creditを決定的に適用します。

契約サマリー

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

接続する

ChatGPTのconnector / MCP設定、またはClaudeのremote MCP設定に次のURLを登録します。

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

確認すること:

• 接続先URLが /api/mcp で終わっている
• 認証方式がOAuthとして始まる
• Signal Foundryのサインイン画面に進む
• 接続後のpublic toolsが search と fetch の2つだけである

接続確認prompt:

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

期待する動き:

1. clientが search(operation: "company.search") を呼ぶ
2. search が候補とcanonical sf:// URIを返す
3. clientが候補の uri を fetch.id に渡す
4. fetch がCompany Card、evidence、gaps、関連linkを返す

ChatGPT の画面例

ChatGPTの画面名や配置は変わることがあります。 確認する値は接続URL、OAuth、search / fetch のtool表示です。

リクエスト

search

search は、依頼に対応するoperationを1つ明示して呼びます。 query の文面からserverがoperationを選ぶことはありません。

基本形:

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

filters はoperationごとに許可されたkeyと型だけを受け付けます。 未知のkey、別operation用のkey、矛盾する条件は invalid_arguments です。

company.resolve の例:

{
  "operation": "company.resolve",
  "query": "7203",
  "filters": {
    "identifier_type": "securities_code"
  }
}

結果が ambiguous の場合、候補から勝手に1社を選びません。 識別子を追加するか、人間に確認してください。

company.query は、AI clientが作ったtyped contractを contract.value に渡します。

{
  "operation": "company.query",
  "contract": {
    "version": "company_query.v1",
    "value": {
      "contract_version": "company_query.v1",
      "raw_request": "売上100億円以上をROEの高い順",
      "predicates": [
        {
          "type": "financial_metric",
          "metric": "revenue",
          "operator": "gte",
          "period": { "latest": true },
          "value": {
            "amount": 10000000000,
            "currency": "JPY",
            "unit": "absolute"
          }
        }
      ],
      "requested_output": {
        "limit": 10,
        "sort": [
          {
            "type": "financial_metric",
            "metric": "return_on_equity",
            "direction": "desc",
            "period": { "latest": true }
          }
        ]
      }
    }
  }
}

fetch

fetch はcanonical sf:// URIだけを受け付けます。 任意のHTTP URL、file path、他accountのopaque IDは受け付けません。

{
  "id": "sf://companies/cn_example"
}

レスポンス

search の主なresponse key:

• operation: 実行したoperation
• results[]: 次の fetch に渡すSearch Card
• results[].uri: canonical sf:// URI
• data: operation固有の既存payload
• gaps[]: 未対応条件、coverage不足、追加確認
• meta.internal_operation: server内で実行したoperation
• meta.cursor: 同じ条件で続行できる場合だけ返すopaque cursor

fetch の主なresponse key:

• id: 取得したcanonical URI
• type: 実行したtyped resource operation
• data: 既存domain serviceが返したfact payload
• evidence[]: payloadに含まれるsource / evidence
• gaps[]: coverage不足や未確認条件
• links[]: 次に fetch できる関連resource
• meta.internal_operation: server内で実行したoperation

認証、usage、credit

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

tool名ではなく、実行したdomain operationに対応するaccount scope、permission、quota、rate limit、creditを適用します。 usageは fetch({ "id": "sf://account/usage" })、credit残高は fetch({ "id": "sf://account/credits" }) で確認します。

復旧方法

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

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

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