> ## 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 市场数据

访问官方远程 MCP server，使用 fcontext 市场数据。

## 概览

你的 AI assistant 可以通过 fcontext MCP server，使用你的 fcontext 账户访问经过认证、按量计费的市场数据。第一个版本提供实时行情、证券静态数据、计算指标、K 线、市场新闻、财务日历和热门异动等工具。

远程 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。

<Note>
  API key 用于 `https://openapi.fcontext.com/api/market-data` 的 HTTP Market Data API。MCP 客户端应使用 OAuth，除非你正在构建自己的服务端集成。
</Note>

## 开始使用

选择支持远程 MCP server 的客户端，并添加 fcontext endpoint：

<Tabs>
  <Tab title="Codex Desktop">
    添加一个远程 MCP server，URL 为：

    ```text theme={null}
    https://mcp.fcontext.com/mcp
    ```

    当 Codex 提示时完成 OAuth 登录，然后在需要市场数据的聊天中启用该 server。
  </Tab>

  <Tab title="Claude / Claude Code">
    添加一个自定义远程 MCP connector，URL 为：

    ```text theme={null}
    https://mcp.fcontext.com/mcp
    ```

    在客户端打开的浏览器窗口中完成 OAuth 认证。
  </Tab>

  <Tab title="Cursor">
    添加一个远程 MCP server，URL 为：

    ```text theme={null}
    https://mcp.fcontext.com/mcp
    ```

    当 Cursor 请求授权时，使用你的 fcontext 账户登录，并批准市场数据访问。
  </Tab>
</Tabs>

## MCP 工具

连接后，你的 AI assistant 可以调用这些工具：

| 工具                          | 描述                                                         |
| --------------------------- | ---------------------------------------------------------- |
| `fcontext_get`              | 在 `/api/market-data` 之后通过相对路径调用允许的 fcontext 市场数据 `GET` 接口。 |
| `fcontext_quote`            | 获取一个或多个标的的实时行情。                                            |
| `fcontext_static_info`      | 获取证券静态信息。                                                  |
| `fcontext_calc_index`       | 获取计算类行情指标。                                                 |
| `fcontext_candlestick`      | 获取某个标的的历史 K 线数据。                                           |
| `fcontext_news`             | 获取市场新闻。                                                    |
| `fcontext_finance_calendar` | 获取财务日历事件。                                                  |
| `fcontext_top_movers`       | 获取热门市场异动。                                                  |

工具调用会使用你的 fcontext 账户完成访问、计费和用量分析，与 HTTP Market Data API 保持一致。

## 使用示例

连接后，可以试着向 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 和路径穿越会被拒绝。                                                                                                 |