Cursor
Cursor 是基于 VSCode 的 AI 编辑器。它从 0.42+ 起原生支持 MCP。
前置条件
- Sigil 已安装 并启动
- Cursor 0.42 或更高版本
第一步:在 Sigil 生成 Token
打开 Sigil → 左侧 MCP → 客户端管理 → 新增客户端:
- 名称:
cursor - 范围:根据需要
- 过期:可留空
复制 sk_sigil_xxxxxxxxxx。
第二步:在 Cursor 添加 MCP Server
打开 Cursor → 设置(Ctrl+, / Cmd+,) → 搜索 MCP 或直接进 Settings → Cursor Settings → Features → MCP。
也可以直接编辑配置文件:
| 平台 | 路径 |
|---|---|
| Windows | %USERPROFILE%\.cursor\mcp.json |
| macOS | ~/.cursor/mcp.json |
| Linux | ~/.cursor/mcp.json |
添加:
json
{
"mcpServers": {
"sigil": {
"url": "http://127.0.0.1:8421/mcp",
"headers": {
"Authorization": "Bearer sk_sigil_xxxxxxxxxx"
}
}
}
}TIP
Cursor 的 MCP 配置字段名与 Claude Code 略有不同(没有 type: "http"),按上面格式填写即可。
第三步:重启 Cursor
完全退出 Cursor 进程并重启。
打开 Composer / Chat 面板,输入 @ 触发提示,应该能看到 Sigil 暴露的工具列表。
试一次
在 Chat 里:
@sigil 帮我查一下 prod 库今天 0 点之后的新注册用户数Cursor 通过 Sigil 调用 db_query,注入 prod-db-readonly 凭据,返回脱敏结果。
推荐配置:项目级 Token
Cursor 也支持项目级 MCP 配置(.cursor/mcp.json 放在项目根)。
如果你为不同项目使用不同范围的凭据,建议:
- 全局
~/.cursor/mcp.json:日常开发用 Token(范围广) - 项目
.cursor/mcp.json:生产关联项目用受限 Token(只读 / 仅特定能力)
项目级配置会覆盖全局——Cursor 进入对应项目时自动切换。
记得把 .cursor/mcp.json 加入 .gitignore,避免 Bearer Token 提交进仓库。
故障排查
在 Cursor 看不到 Sigil 工具
- 完全退出 Cursor 进程并重启
- 检查
~/.cursor/mcp.json格式(合法 JSON、字段名正确) - 在 Cursor Settings → MCP 看 Sigil 状态
"MCP Server failed to start"
Cursor 把 stdio 类型的 MCP server 标"failed to start"是因为它尝试用 stdio 通信。确保你的配置是 URL 模式(HTTP),不是 stdio 命令。
工具调用返回 not_in_scope
- 同 Claude Code 故障排查 的相应章节
- Sigil → MCP → 客户端管理 → cursor → 检查并调整范围
与 Claude Code 同时使用
完全可以。给两个客户端独立的 Bearer Token:
| 客户端 | Token 名 | 备注 |
|---|---|---|
claude-code | sk_sigil_xxx_1... | 全部能力 |
cursor | sk_sigil_xxx_2... | 全部能力 |
审计日志的 caller 列会区分。任一客户端出问题(被改、被改主人、被钓鱼)可单独撤销。
下一步
- 看 Cline 怎么配:Cline →
- 看通用 MCP 客户端:通用 MCP 客户端 →
- 看 Scope Policy 怎么细化:凭据金库 →
