Add MCP docs. by huacnlee · Pull Request #338 · longbridge/developers

huacnlee · 2026-02-26T11:54:11Z

No description provided.

Colbert-Ran · 2026-02-27T08:32:21Z

+
+Longbridge provides an online MCP service so AI tools can securely access market and account capabilities through the Model Context Protocol.
+
+- MCP endpoint: `https://openapi.longbridge.com/mcp`


这里的域名不正确，实际上为 openapi.longbridgeapp.com

已修正为 openapi.longbridgeapp.com，并已推送到 PR #338 分支。感谢指出。

Colbert-Ran · 2026-02-27T08:32:53Z

+Longbridge provides an online MCP service so AI tools can securely access market and account capabilities through the Model Context Protocol.
+
+- MCP endpoint: `https://openapi.longbridge.com/mcp`
+- OAuth discovery: `https://openapi.longbridge.com/.well-known/oauth-authorization-server`


这里的域名也应该是 openapi.longbridgeapp.com

已同步修正 OAuth discovery 域名为 openapi.longbridgeapp.com，已推送更新。

Colbert-Ran · 2026-02-27T08:39:57Z

+### 1）在客户端发起 MCP 连接
+
+在支持 MCP 的客户端（如 Cursor、Claude Desktop、Cherry Studio）中，发起连接 Longbridge MCP 服务。
+


这里可能需要说明下，部分未按照完整的 MCP 协议实现（未支持 OAuth 2.1 协议）的客户端无法接入 Longbridge OpenAPI MCP，例如早期版本的 Cherry Studio 等。

已补充兼容性说明：未完整支持 MCP OAuth 2.1 的客户端（如早期 Cherry Studio）可能无法接入，建议升级最新版本。已推送到当前 PR 分支。

…ity note

huacnlee · 2026-02-27T08:43:49Z

+
+Open **Cursor Settings → MCP Servers**, add a remote MCP server endpoint:
+
+- Server URL: `https://openapi.longbridge.com/mcp`


@xiaobo-gaga 这里还没处理完，同时检查其他类似的问题。

收到，我会把 docs/en/docs/mcp.md 中其余类似域名与相关描述一并全面排查并统一修正，然后在本线程逐条回报。

huacnlee · 2026-02-27T08:45:07Z

+- 遵循最小权限原则，仅授予必要 scope。
+- 涉及交易操作时，建议始终加入人工确认。
+
+## 客户端接入方式


以下的授权方式介绍过于简单，参考一些其他的 MCP 例如 GitHub MCP，Stripe MCP 之类的他们是如何介绍的。需要比较详细，让用户一看就明白。

收到，我会参考 GitHub MCP / Stripe MCP 的写法，把授权流程补充为更完整的分步说明（前置条件、OAuth 流程、回调与常见问题），确保用户一看就能操作。完成后在这里同步。

这个还没完成处理

Colbert-Ran · 2026-02-27T08:46:34Z

+
+打開 **Cursor Settings → MCP Servers**，新增遠端 MCP 服務：
+
+- 服務地址：`https://openapi.longbridge.com/mcp`


本文档中所有对于 openapi.longbridge.com 都需要替换为 openapi.longbridgeapp.com

huacnlee · 2026-02-27T09:06:53Z

@xiaobo-gaga 检查 Review Comment

huacnlee · 2026-02-27T09:08:26Z

@xiaobo-gaga check

huacnlee · 2026-02-27T09:13:31Z

@xiaobo-gaga 检查前面 Review 并处理

huacnlee · 2026-02-27T09:18:43Z

@xiaobo-gaga 检查前面 Review 并处理

huacnlee · 2026-02-27T09:22:05Z

@xiaobo-gaga 检查处理 Git 冲突

endless-bot · 2026-02-27T09:23:15Z

（更正）上一条评论格式异常，已忽略。请以下一条为准。

endless-bot · 2026-02-27T09:23:20Z

@huacnlee 已处理并解决 Git 冲突，变更已推送到 update-llm。

处理说明：

解决冲突文件：docs/en/docs/mcp.md、docs/zh-CN/docs/mcp.md、docs/zh-HK/docs/mcp.md
保留并统一为在线 MCP + OAuth 文档结构
全部域名统一为 openapi.longbridgeapp.com

commit: d40130f

endless-bot · 2026-02-27T09:32:32Z

（更正）上一条评论内容异常，请忽略，以后一条评论为准。

endless-bot · 2026-02-27T09:32:38Z

@huacnlee 已处理：针对误入 main 的 commit 01d9605，我已提 Revert PR：#341。
合并 #341 后可从 main 移除该误合并内容。

huacnlee · 2026-02-27T09:34:04Z

解决冲突

endless-bot · 2026-02-27T09:34:42Z

@huacnlee 已处理，冲突已解决并推送到 update-llm。

merge main 后冲突文件：
- docs/en/docs/mcp.md
- docs/zh-CN/docs/mcp.md
- docs/zh-HK/docs/mcp.md
处理结果：保留本 PR 的 MCP 文档更新内容
最新 commit: a3ec0e0

endless-bot · 2026-03-01T02:31:16Z

@huacnlee 已根据最新 OAuth 2 文档检查并修正 PR #338 的 MCP 部分（3 语言同步）。

本次调整：

MCP endpoint 统一为 https://openapi.longportapp.com/mcp
OAuth discovery 统一为 https://openapi.longportapp.com/.well-known/oauth-authorization-server
并同步更新页面内所有 client setup 的 Server URL（en / zh-CN / zh-HK）

commit: 5da6377

endless-bot · 2026-03-01T02:32:12Z

@huacnlee 已补充 MCP 文档中“各类客户端配置参考”（en / zh-CN / zh-HK）。

新增内容：

ChatGPT 配置参考（示意）
Claude Code 配置参考
Cursor 配置参考
Zed 配置参考（示意）
OpenClaw 配置参考

并保留 OAuth 授权流程说明，便于直接照着接入。

commit: c538089

endless-bot · 2026-03-01T02:35:19Z

@huacnlee 你说得对，我已修正这块引导，避免误导配置。

处理内容（en / zh-CN / zh-HK）：

删除了各客户端的 JSON 配置“示例块”（这些示例在不同版本客户端中不稳定，容易误导）
保留统一且准确的接入要点：
- 在客户端中添加远程 MCP Server
- Server URL 使用 https://openapi.longportapp.com/mcp
- 完成 OAuth 授权
增加说明：客户端配置格式以官方文档/实际 UI 为准

commit: fae1c25

endless-bot · 2026-03-01T02:38:39Z

@huacnlee 已按你给的方式修正 Zed 配置（en / zh-CN / zh-HK 同步）：

改为 settings.json 方式
使用：
- context_servers.longbridge.url = https://openapi.longportapp.cn/mcp

commit: 0f7af5f

huacnlee added 2 commits February 26, 2026 19:53

Add MCP docs.

1123c70

.

71550c6

endless-bot mentioned this pull request Feb 27, 2026

Improve MCP docs details (en/zh-CN/zh-HK) #340

Closed

endless-bot added 3 commits February 27, 2026 16:24

Add detailed MCP docs and nav entries for en/zh-CN/zh-HK

7f88b47

Refine MCP docs to hosted Longbridge service and OAuth flow only

fa1d1ec

Clarify hosted MCP endpoint and OAuth discovery URL

85797cb

Colbert-Ran reviewed Feb 27, 2026

View reviewed changes

Add setup guide for ChatGPT, Claude Code, Cursor, Zed, and OpenClaw

2df1c05

Colbert-Ran reviewed Feb 27, 2026

View reviewed changes

Address review: fix longbridgeapp domain and add OAuth 2.1 compatibil…

e6e37f3

…ity note

huacnlee commented Feb 27, 2026

View reviewed changes

Colbert-Ran reviewed Feb 27, 2026

View reviewed changes

endless-bot added 2 commits February 27, 2026 16:57

Fix MCP docs domain to openapi.longbridge.com

88ad81f

Add GitHub Action to notify Discord on PR review events

3d09819

Resolve mcp docs merge conflicts with unified longbridgeapp domain

d40130f

Resolve conflicts with main and keep MCP docs updates

a3ec0e0

Align MCP docs with latest OAuth2 host (openapi.longportapp.com)

5da6377

Add client configuration references for MCP docs (en/zh-CN/zh-HK)

c538089

Fix MCP client guidance: remove speculative config snippets

fae1c25

Update Zed MCP config instructions with settings.json example

dd8332b

Add concrete MCP config examples for ChatGPT/Claude/Cursor/OpenClaw

89e1494

huacnlee marked this pull request as ready for review March 1, 2026 02:43

huacnlee merged commit 5b32bbd into main Mar 1, 2026
2 checks passed

huacnlee deleted the update-llm branch March 1, 2026 02:52


		Longbridge provides an online MCP service so AI tools can securely access market and account capabilities through the Model Context Protocol.

		- MCP endpoint: `https://openapi.longbridge.com/mcp`

		### 1）在客户端发起 MCP 连接

		在支持 MCP 的客户端（如 Cursor、Claude Desktop、Cherry Studio）中，发起连接 Longbridge MCP 服务。


		Open Cursor Settings → MCP Servers, add a remote MCP server endpoint:

		- Server URL: `https://openapi.longbridge.com/mcp`


		打開 Cursor Settings → MCP Servers，新增遠端 MCP 服務：

		- 服務地址：`https://openapi.longbridge.com/mcp`

Uh oh!

Conversation

huacnlee commented Feb 26, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

huacnlee commented Feb 27, 2026

Uh oh!

huacnlee commented Feb 27, 2026

Uh oh!

huacnlee commented Feb 27, 2026

Uh oh!

huacnlee commented Feb 27, 2026

Uh oh!

huacnlee commented Feb 27, 2026

Uh oh!

endless-bot commented Feb 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

endless-bot commented Feb 27, 2026

Uh oh!

endless-bot commented Feb 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

endless-bot commented Feb 27, 2026

Uh oh!

huacnlee commented Feb 27, 2026

Uh oh!

endless-bot commented Feb 27, 2026

Uh oh!

endless-bot commented Mar 1, 2026

Uh oh!

endless-bot commented Mar 1, 2026

Uh oh!

endless-bot commented Mar 1, 2026

Uh oh!

endless-bot commented Mar 1, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

endless-bot commented Feb 27, 2026 •

edited

Loading

endless-bot commented Feb 27, 2026 •

edited

Loading