跳到主要内容

连接 Cursor

已于 2026-09-29 对照厂商文档核对,尚未端到端实测

下文的 mcp.json 格式依据 Cursor 的 MCP 文档编写;我们自己还没有从 Cursor 登录过 NameBeta。文件格式比较稳定,设置界面则变化较多;如果下文的某个名称对不上,请在 Cursor Settings 中找 MCP 相关的部分。

准备工作​

  • Cursor。
  • 一个 NameBeta 账号,也可以在设置过程中于登录页注册。
  • 一个预注册的 client ID。 Cursor 登录 MCP 服务器时,要么使用 NameBeta 不支持的 Dynamic Client Registration,要么使用静态的客户端凭据;它的文档没有提到 Client ID Metadata Documents,Cursor 员工也于 2026 年 5 月 13 日在功能请求帖中表示对此暂无时间表。请按预注册的 client ID中的说明申请 client ID,注明客户端为 Cursor,回调地址为 http://localhost:8787/callback(桌面应用)和 https://www.cursor.com/agents/mcp/oauth/callback(网页版及 Cursor Agents)。

添加服务器​

Cursor 从 mcp.json 读取 MCP 服务器。想在所有项目中使用 NameBeta,就用主目录下的文件;想通过仓库共享给他人,就用项目中的文件:

文件作用范围
~/.cursor/mcp.json你的所有项目
.cursor/mcp.json当前项目

添加一个 namebeta 条目,填入 URL,并在 auth 块中填入你拿到的 client ID:

{
"mcpServers": {
"namebeta": {
"url": "https://namebeta.com/api/mcp",
"auth": {
"CLIENT_ID": "<client ID>",
"scopes": ["profile", "email"]
}
}
}
}

如果文件中已经有其他服务器,把 namebeta 加到 mcpServers 中与它们并列即可。

  • 保留 scopes 的写法不变。如果不写,Cursor 会从授权服务器的元数据中读取 scope,而其中列出的一些 scope NameBeta 并不授予 MCP 客户端。
  • 不要添加 CLIENT_SECRET。该 client ID 属于公开客户端,没有 secret。
  • 不要添加带令牌的 headers。Cursor 会通过 OAuth 自行获取令牌,而写死的令牌会过期。

登录​

  1. 打开 Cursor Settings,进入 MCP 部分(Tools & MCP)。列表中会出现 namebeta 服务器,并标注需要认证。
  2. 点击它的登录按钮。浏览器会打开 NameBeta 登录页。
  3. 登录并授权访问,然后回到 Cursor。此时服务器应显示为已连接,并列出五个工具。

试一试​

在 Agent 对话中提问:

查一下 github.com 的 MX 记录。

Cursor 会调用 lookup_dns,回答应为 github-com.mail.protection.outlook.com,与 dig MX github.com 返回的记录一致。

断开连接或切换账号​

  • 不再使用 NameBeta 时,从 mcp.json 中删除 namebeta 条目。
  • 如需改用其他 NameBeta 账号,见切换账号。

连接失败时​

如果登录无法完成,请参阅故障排查。