> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fcontext.com/llms.txt
> Use this file to discover all available pages before exploring further.
# MCP Server
> OAuth 2.1 で AI assistant を fcontext 市場データに接続する
fcontext 市場データ向けの公式リモート MCP server にアクセスします。
## 概要
AI assistant は fcontext MCP server を使用して、あなたの fcontext アカウント経由で認証済みかつ従量制の市場データにアクセスできます。最初のバージョンでは、リアルタイムクォート、静的証券データ、計算済みクォート指標、ローソク足、市場ニュース、財務カレンダー、値動き上位銘柄のツールを提供します。
リモート MCP endpoint：
```text theme={null}
https://mcp.fcontext.com/mcp
```
## 認証
MCP server は OAuth 2.1 を使用します。対話型 MCP クライアントが初回接続すると、サインインして市場データアクセスを承認する画面にリダイレクトされます。MCP クライアントに API key は不要です。
認可サーバー：
```text theme={null}
https://openapi.fcontext.com/api/auth
```
MCP access token は MCP resource audience にバインドされた JWT です。
```text theme={null}
https://mcp.fcontext.com/mcp
```
Token には `market_data` scope が必要です。
API key は `https://openapi.fcontext.com/api/market-data` の HTTP Market Data API 用です。独自のサーバー側連携を構築している場合を除き、MCP クライアントでは OAuth を使用してください。
## はじめる
リモート MCP server をサポートするクライアントを選び、fcontext endpoint を追加します。
この URL でリモート MCP server を追加します。
```text theme={null}
https://mcp.fcontext.com/mcp
```
Codex に促されたら OAuth サインインを完了し、市場データが必要なチャットで server を有効にします。
この URL でカスタムリモート MCP connector を追加します。
```text theme={null}
https://mcp.fcontext.com/mcp
```
クライアントが開くブラウザウィンドウで OAuth 認証を完了します。
この URL でリモート MCP server を追加します。
```text theme={null}
https://mcp.fcontext.com/mcp
```
Cursor が認可を求めたら、fcontext アカウントでサインインして市場データアクセスを承認します。
## MCP ツール
接続後、AI assistant は以下のツールを呼び出せます。
| ツール | 説明 |
| --------------------------- | ----------------------------------------------------------------------- |
| `fcontext_get` | `/api/market-data` の後ろの相対パスで、許可された fcontext 市場データ `GET` エンドポイントを呼び出します。 |
| `fcontext_quote` | 1 つ以上のシンボルのリアルタイムクォートを取得します。 |
| `fcontext_static_info` | 静的な証券情報を取得します。 |
| `fcontext_calc_index` | 計算済みクォート指標を取得します。 |
| `fcontext_candlestick` | シンボルの過去ローソク足データを取得します。 |
| `fcontext_news` | 市場ニュースを取得します。 |
| `fcontext_finance_calendar` | 財務カレンダーイベントを取得します。 |
| `fcontext_top_movers` | 値動き上位銘柄を取得します。 |
ツール呼び出しは HTTP Market Data API と同様に、あなたの fcontext アカウントをアクセス、課金、使用状況分析に使用します。
## 使用例
接続後、AI assistant に次のように質問できます。
* “What is Apple’s latest quote?”
* “Show me one month of daily candlesticks for Nvidia.”
* “What are today’s top US market movers?”
* “Find recent news for Tesla.”
* “Check upcoming finance calendar events for this week.”
* “Compare static information for AAPL.US and MSFT.US.”
## トラブルシューティング
| 問題 | 確認すること |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| クライアントが認可メタデータを検出できない | `https://openapi.fcontext.com/api/auth/.well-known/oauth-authorization-server` または `https://openapi.fcontext.com/.well-known/oauth-authorization-server/api/auth` に到達できることを確認します。 |
| MCP リクエストが `401` を返す | MCP server に再接続し、OAuth を再度完了します。レスポンスには protected resource metadata URL を含む `WWW-Authenticate` が含まれます。 |
| MCP リクエストが `403` を返す | Token は有効ですが、`market_data` scope が含まれていません。クライアントを再認可してください。 |
| ツール呼び出しがパスエラーで失敗する | `fcontext_get` では `quote` や `content/news` などの相対パスを使用します。絶対 URL とパストラバーサルは拒否されます。 |