概览
你的 AI assistant 可以通过 fcontext MCP server，使用你的 fcontext 账户访问经过认证、按量计费的市场数据。第一个版本提供实时行情、证券静态数据、计算指标、K 线、市场新闻、财务日历和热门异动等工具。 远程 MCP endpoint：认证
MCP server 使用 OAuth 2.1。当交互式 MCP 客户端首次连接时，它会重定向你登录并批准市场数据访问。MCP 客户端不需要 API key。 授权服务器：market_data scope。
API key 用于
https://openapi.fcontext.com/api/market-data 的 HTTP Market Data API。MCP 客户端应使用 OAuth，除非你正在构建自己的服务端集成。开始使用
选择支持远程 MCP server 的客户端，并添加 fcontext endpoint：- Codex Desktop
- Claude / Claude Code
- Cursor
添加一个远程 MCP server，URL 为：当 Codex 提示时完成 OAuth 登录，然后在需要市场数据的聊天中启用该 server。
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 | 获取热门市场异动。 |
使用示例
连接后，可以试着向 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 和路径穿越会被拒绝。 |