连接 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 自行获取令牌,而写死的令牌会过期。
登录
- 打开 Cursor Settings,进入 MCP 部分(Tools & MCP)。列表中会出现
namebeta服务器,并标注需要认证。 - 点击它的登录按钮。浏览器会打开 NameBeta 登录页。
- 登录并授权访问,然后回到 Cursor。此时服务器应显示为已连接,并列出五个工具。
试一试
在 Agent 对话中提问:
查一下 github.com 的 MX 记录。
Cursor 会调用 lookup_dns,回答应为 github-com.mail.protection.outlook.com,与 dig MX github.com 返回的记录一致。
断开连接或切换账号
- 不再使用 NameBeta 时,从
mcp.json中删除namebeta条目。 - 如需改用其他 NameBeta 账号,见切换账号。
连接失败时
如果登录无法完成,请参阅故障排查。