MCP 接続

サーバー情報

OAuth の認可サーバー(issuer)は https://www.chickstockfi.com/openapi/pro/v1 です。MCP 接続には www.chickstockfi.com のアドレスを使用してください。

Data API キーで接続

Data API のお客様は、Data API キー(ck_live_…)を Authorization ヘッダーに入れて接続します。PRO API プランは不要です。サーバー URL は共通で、どのキーで接続するかによって使えるツールが変わります。

• ツール 1 つが Data API のエンドポイント 1 つに対応します。ツール呼び出し 1 回は Data API リクエスト 1 回で、REST と同じ 1 日の上限・1 分あたりの上限で数えます。
• tools/list には、そのキーで使えるツールだけが表示されます。契約していない市場のツールは表示されません(韓国のみの契約なら get_earnings_calendar はありません)。旧 Free キーには get_news・search_news・grounded_answer・get_api_usage のみ表示されます。
• 結果は REST のレスポンス本文に usage を加えた形です。quota(1 日)・rate_limit(1 分あたり)、AI 呼び出し上限のあるアカウント(PoC · Launch · Business · Scale)では ai_quota も含まれます。
• エラーコードとメッセージは REST と同じです。例:MARKET_NOT_ENTITLED、PLAN_REQUIRED、POC_ENDED、QUOTA_EXCEEDED、RATE_LIMITED、AI_QUOTA_EXCEEDED。PoC が終了すると、接続の段階で 403 POC_ENDED が返ります。
• OAuth ログインは PRO アカウント用です。Data API キーはヘッダーで接続してください。API ドキュメントのセッションキー(ck_docs_…)では接続できず(401 WRONG_KEY_SCOPE)、ask_phoenix などの PRO ツールを呼ぶと WRONG_KEY_SCOPE が返ります。

Claude Code

claude mcp add --transport http phoenix-data https://www.chickstockfi.com/openapi/pro/v1/mcp \
  --header "Authorization: Bearer $PHOENIX_DATA_KEY"

Claude Desktop

{
  "mcpServers": {
    "phoenix-data": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.chickstockfi.com/openapi/pro/v1/mcp", "--header", "Authorization:${PHOENIX_AUTH}"],
      "env": { "PHOENIX_AUTH": "Bearer ck_live_xxxxxxxx" }
    }
  }
}

Cursor

{
  "mcpServers": {
    "phoenix-data": {
      "url": "https://www.chickstockfi.com/openapi/pro/v1/mcp",
      "headers": { "Authorization": "Bearer ck_live_xxxxxxxx" }
    }
  }
}

AI 呼び出し

grounded_answer は回答モデルを呼び出すたびに AI 呼び出しを 1 回使います。get_disclosure_summary・get_stock_briefing は要約・ブリーフィングを新しく作るときだけ 1 回使います。run_data_query はモデルを呼び出さないためカウントしません。上限は等級ごとの1日の AI 呼び出し上限で、REST と合算します(レート制限とクォータ)。

Data API ツール

エンドポイントのパスは https://api.chickstockfi.com/openapi/v1 配下です。

クライアント別の接続方法

Claude Code

# PRO API キーで接続
claude mcp add --transport http phoenix https://www.chickstockfi.com/openapi/pro/v1/mcp \
  --header "Authorization: Bearer $PHOENIX_PRO_KEY"

# OAuth で接続: ヘッダーなしで追加し、Claude Code で /mcp → phoenix → 認証
claude mcp add --transport http phoenix https://www.chickstockfi.com/openapi/pro/v1/mcp

Claude Desktop

キーを使わずに接続する場合は、設定 → コネクタ → カスタムコネクタを追加 でサーバー URL を入力して接続します。ブラウザでログインして同意すれば完了です。キーで接続する場合は、claude_desktop_config.json で mcp-remote を使います。

{
  "mcpServers": {
    "phoenix": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.chickstockfi.com/openapi/pro/v1/mcp", "--header", "Authorization:${PHOENIX_AUTH}"],
      "env": { "PHOENIX_AUTH": "Bearer ck_pers_xxxxxxxx" }
    }
  }
}

claude.ai(Web・アプリ)

設定 → コネクタ → カスタムコネクタを追加 → URL にサーバー URL を入力 → 接続 → ログイン → 同意。OAuth のみに対応しています。

ChatGPT

開発者モードでアプリ・コネクタを作成し、MCP サーバーの URL に同じアドレスを入力して、認証方式に OAuth を選びます。

Cursor

{
  "mcpServers": {
    "phoenix": {
      "url": "https://www.chickstockfi.com/openapi/pro/v1/mcp",
      "headers": { "Authorization": "Bearer ck_pers_xxxxxxxx" }
    }
  }
}

その他の MCP クライアント

Streamable HTTP に対応していれば、サーバー URL と Authorization ヘッダーを設定するだけで接続できます。接続の確認は curl でも行えます。

curl -s https://www.chickstockfi.com/openapi/pro/v1/mcp \
  -H "Authorization: Bearer $PHOENIX_PRO_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

OAuth のフロー

1. クライアントがキーなしでサーバーを呼び出すと、401 と保護リソースメタデータの URL が返ります。
2. メタデータから認可サーバーを特定し、動的クライアント登録(/oauth/register)を行います。
3. ブラウザで /oauth/authorize → ログイン → 同意画面へと進みます。同意画面には、アプリ名、リダイレクト先 URL、アカウント、プランで利用できる機能が表示されます。
4. 承認すると、クライアントが認可コードをトークンに交換します(PKCE S256 必須)。アクセストークン(ck_mcp_at_…)の有効期間は1時間、リフレッシュトークンは30日で、使用するたびに更新されます。
5. 承認には有効な PRO プランが必要です。トークンの取得後も、リクエストごとにプランを再確認します。

HTTP/2 401
WWW-Authenticate: Bearer resource_metadata="https://www.chickstockfi.com/openapi/pro/v1/.well-known/oauth-protected-resource/mcp", scope="mcp"

パスはすべて https://www.chickstockfi.com/openapi/pro/v1 の配下にあります。アカウントあたりの有効な接続は20件までで、超えると古い接続から順に切断されます。

PRO ツール(PRO API キー · OAuth)

PRO の上限

• ツールの呼び出し1回が、1日の呼び出し1回としてカウントされます。REST の呼び出しと合算します。get_ask_result・get_account_usage はカウントしません。
• キーで接続した場合は、REST と同じ1秒あたりのバケットを使います。OAuth で接続した場合は、接続ごとに別のバケットになります。
• 接続手続き(initialize · tools/list)は1日の呼び出しにカウントしません。
• 上限に達すると、ツールの結果がエラー(isError)として返り、RATE_LIMITED、DAILY_QUOTA_EXCEEDED などのコードが含まれます。コードの意味はエラーコードをご覧ください。