第 1 课

MCP：OAuth 接入 ChatGPT / Claude / OpenCode

按官方 Connect an assistant：配置 https://mcp.finbar.com/mcp，完成浏览器 OAuth，并用找 Apple 财报的提示冒烟。

课程目录第 1 / 2 课

学习位置仅保存在当前浏览器，有效期 180 天。

来源：Finbar · Introduction、Connect an assistant。本课走 远程 MCP + 浏览器 OAuth：把 Finbar 接到 ChatGPT / Claude / OpenCode，并用一句提示验证工具调用。REST 凭证与 curl 搜公司见课时 2。

你将得到什么

一条可用的 Finbar MCP 连接（Server URL 固定为官方值）
一次成功的「找公司 + 列近期财报」对话（助手应实际调用 Finbar）
（可选）OpenCode 的 opencode.json MCP 片段与 mcp auth 对照

开始前准备

已注册 Finbar 账号，且账户具备 API/MCP access（免费档含有限 API/MCP；若连接被拒，先在账号/套餐侧确认权限）。
选用一个支持远程 MCP + 浏览器 OAuth 的客户端：ChatGPT（需开启 Developer mode）、Claude（Connectors）、或 OpenCode。
同一浏览器完成授权（官方：批准可在同浏览器记住约 30 天）。

核心事实（先记住）

项	官方值
MCP Server URL	`https://mcp.finbar.com/mcp`
认证	OAuth：浏览器登录 Finbar 账号（不需要 REST client secret）
账户要求	具备 API/MCP 访问权限的 Finbar 账号
验证提示（官方示例）	`Use Finbar to find Apple and list its recent financial reports. Include each report's period and document ID.`
文档	https://docs.finbar.com/api-mcp/mcp

步骤 1：ChatGPT 接入（若你用 ChatGPT）

按官方步骤（可用性取决于账号与工作区策略）：

Settings → Security and login，开启 Developer mode。
打开 ChatGPT Plugins，点加号，连接命名为 Finbar。
选择 public server，填入：

https://mcp.finbar.com/mcp

若出现认证选项：选 OAuth 与 CIMD；可选的 client ID / secret 留空。
创建连接 → 完成 Finbar 登录 → 查看发现的 tools。
新开对话，从 tools 菜单启用 Finbar。

对照结果：

连接状态为已授权 / Connected
工具列表非空（公司检索、文档、数据集相关工具会出现；具体名称以客户端发现为准）
CIMD = Client ID Metadata Document，避免手写 client 注册（见 OpenAI MCP 认证说明）

步骤 2：Claude 接入（若你用 Claude）

Customize → Connectors → Add custom connector。
名称 Finbar，远程 URL：

https://mcp.finbar.com/mcp

可选 OAuth client 凭证留空。 3. Add → Connect → 完成 Finbar 登录。 4. 在对话里通过 + → Connectors 启用 Finbar。

Team/Enterprise：需组织所有者先在 Organization settings → Connectors 添加（见 Claude 自定义连接器说明）。

对照结果：Connectors 列表出现 Finbar，且当前对话已勾选启用。

步骤 3：OpenCode 接入（若你用 OpenCode）

在 opencode.json 的 mcp 中加入官方片段：

{
  "mcp": {
    "finbar": {
      "type": "remote",
      "url": "https://mcp.finbar.com/mcp",
      "oauth": {
        "scope": "entities:read documents:read datasets:read"
      }
    }
  }
}

scope 请求读取公司、文档与数据集。然后：

opencode mcp auth finbar
opencode mcp list

对照结果：

mcp auth 打开浏览器完成登录后退出码 0
mcp list 显示 finbar 为已认证/可用

步骤 4：批准权限并做冒烟提问

Finbar 会在登录前展示请求方身份与权限——核对是否为你刚发起的连接。

在已启用 Finbar 的对话中发送官方示例：

Use Finbar to find Apple and list its recent financial reports. Include each report's period and document ID.

对照结果：

助手侧出现对 Finbar 工具的调用（非纯模型臆造）
回复含公司匹配与近期报告的 period / document ID（具体字段以你账号数据覆盖为准）
若「已连接但从不调用」：确认对话内已启用 Finbar，并明确要求使用 Finbar

连接问题速查（官方表）

问题	检查
客户端死要 secret	确认选的是账号 OAuth；ChatGPT 优先 CIMD
Finbar 拒绝访问	换有 API/MCP 权限的账号登录
批准过期/换浏览器	同浏览器重新走连接与登录
连上了但不调用	对话内启用 + 明确点名 Finbar
以前可用现认证失败	在助手连接设置里重新 Connect

本课检查清单

Server URL 精确为 https://mcp.finbar.com/mcp
OAuth 登录成功，未误用 REST secret
冒烟提示返回带 period / document ID 的报告列表

下一课：在 Web 应用 API 面板创建 REST 凭证，换 access_token，并用 curl 搜索 Apple。

本课资料

Finbar全球基本面数据 + AI 投研：Web、Excel、API 与 MCP。

官方文档

Finbar ↗