集成指南
Clavitor + Cursor
Cursor 智能体模式在编辑器内部运行 shell 命令和 HTTP 调用。将其配置为使用 Clavitor CLI 获取命名凭据,并使用 Clavitor 代理实现透明的 API 身份验证——密钥绝不会进入编辑器的内存或您的对话历史记录。
Cursor 智能体能看到的内容
共享字段
智能体通过集成终端读取这些信息,以进行部署、身份验证和调用 API。
- API 密钥(Anthropic、OpenAI、GitHub、AWS、Stripe……)
- SSH 主机凭据
- 数据库连接字符串
- TOTP 种子——按需生成实时 2FA 代码
- 服务帐户密码
智能体永远看不到的内容
个人字段
使用您的指纹、面容或安全密钥在客户端进行加密。服务器仅存储密文。没有密钥,就无法访问。
- 信用卡号与 CVV
- 护照与政府签发的身份证件
- 恢复代码与助记词
- 社会安全号码
- 银行账户详细信息
无需 MCP。由代理和 CLI 代为完成工作。
Cursor 支持通过 MCP 进行工具调用——但 Clavitor 有意不提供 MCP 服务器。MCP 会向智能体暴露枚举操作(列表、搜索、浏览);智能体接口仅限功能调用,绝不包含枚举。CLI 仅获取智能体被指定访问的命名条目,别无其他。代理将凭据注入出站请求,而智能体完全看不到这些凭据。
这是一种架构选择,而非缺失集成。下两种模式涵盖了 Cursor 所需的一切。
设置
从终端启动 Cursor,以便其继承您的 HTTPS_PROXY 和 PATH。在 macOS 上,通过 Finder 启动 GUI 应用程序会跳过您的 shell rc 文件——请在终端中使用 cursor .,或通过 LaunchAgent 设置代理以实现持久化。
1. 创建智能体
打开您的保管库 → 智能体 → 创建。将其命名为“Cursor”并选择它可以访问的条目。复制设置令牌。
2. 初始化 CLI
$ echo "$CLAVITOR_TOKEN" | clavitor-cli init
3. 在代理处于活动状态时启动 Cursor
$ export HTTPS_PROXY=http://localhost:1983 $ cursor .
模式 1——通过集成终端进行命名查找
Cursor 的智能体可以调用任何 shell 命令。当它需要一个特定值时,它会调用 shell 执行:
# In a script Cursor's agent generated:
key=$(clavitor-cli get "Anthropic API" --field key)
curl -H "x-api-key: $key" https://api.anthropic.com/v1/messages -d '{...}'该变量的生命周期仅限一条语句。智能体在赋值和使用之间看不到 key——并且凭据绝不会出现在聊天记录中,因为 Cursor 不会将展开的值回显到对话中。
对于多凭据配置文件,请使用 render:
$ clavitor-cli render app.config.json | myapp --config -
模式 2——通过代理进行透明注入
设置 HTTPS_PROXY 后,智能体写入引用,由代理在网络传输时进行解析。机密绝不会进入智能体的内存或对话中:
# Cursor's agent runs this verbatim curl -H "Authorization: Bearer clavitor://OpenAI/key" \ https://api.openai.com/v1/models
智能体在其自身的命令历史记录中看到 clavitor://OpenAI/key。实际发出的网络请求在 Authorization 标头中包含真实的 sk-... 值。日志抓取器、崩溃转储和 cursor 历史记录均保持干净。
在以下情况下,这是正确的模式:
- 智能体在会话期间生成临时 curl/HTTP 调用
- 智能体调用的工具自行发出 HTTPS 调用
- 您希望将机密完全移出对话上下文窗口
Cursor CLI(通过脚本运行智能体模式)
Cursor 1.x 提供了一个单独的 CLI,用于无头智能体运行。适用相同的 HTTPS_PROXY 规则——在调用前在 shell 中设置它:
$ export HTTPS_PROXY=http://localhost:1983 $ cursor-agent "deploy the latest tag to staging" --workspace ~/dev/myapp
对于长时间运行的作业,智能体令牌的 IP 白名单将凭据读取锁定在智能体运行的主机上。在其他地方运行,保管库将拒绝访问。
每次访问都会被记录
审计日志会记录哪个智能体访问了哪个凭据、何时访问以及从何处访问。Cursor 智能体活动会被明确标记,以区别于人类活动。
# TIME ACTION ENTRY ACTOR 2026-03-08 10:23:14 read anthropic cli:cursor 2026-03-08 10:23:15 read openai proxy:cursor 2026-03-08 11:45:02 read github-deploy cli:cursor 2026-03-08 14:12:33 render - cli:cursor