集成指南
Clavitor + Cursor
Cursor 的 Agent 模式在编辑器内执行 shell 命令和 HTTP 调用。将其指向 Clavitor CLI 以获取具名凭证,并指向 Clavitor 代理以实现透明的 API 身份验证——密钥绝不会进入编辑器内存或您的对话历史。
Cursor Agent 可见内容
共享字段
Agent 通过集成终端读取这些内容,以进行部署、身份验证和调用 API。
- API 密钥(Anthropic、OpenAI、GitHub、AWS、Stripe...)
- SSH 主机凭证
- 数据库连接字符串
- TOTP 种子——按需获取实时双因素认证码
- 服务账户密码
Agent 不可见内容
个人字段
使用您的指纹、面容或安全密钥在客户端进行加密。服务器仅存储密文。无密钥,则无法访问。
- 信用卡号及 CVV
- 护照及政府身份证件
- 恢复码及助记词
- 社会安全号码
- 银行账户详情
无需 MCP。由代理和 CLI 完成相应工作。
Cursor 支持通过 MCP 进行工具调用——但 Clavitor 刻意不提供 MCP 服务器。MCP 会向 Agent 暴露枚举(列表、搜索、浏览)功能;而 Agent 的交互界面仅提供功能调用,绝不提供枚举。CLI 仅获取 Agent 被明确指定的凭证,不获取其他任何内容。代理会将凭证注入出站请求,而 Agent 完全无法看到这一过程。
这是架构层面的设计选择,而非集成缺失。接下来的两种模式涵盖了 Cursor 的所有需求。
设置
请从终端启动 Cursor,使其继承您的 HTTPS_PROXY 和 PATH。在 macOS 上,从 Finder 启动的 GUI 会跳过 shell rc 文件——请在终端中使用 cursor . 启动,或通过 LaunchAgent 设置代理以实现持久生效。
1. 创建 Agent
打开您的保险库 → Agent → 创建。将其命名为 "Cursor",选择其可访问的条目,然后复制设置令牌。
2. 初始化 CLI
$ echo "$CLAVITOR_TOKEN" | clavitor-cli init
3. 启用代理并启动 Cursor
$ export HTTPS_PROXY=http://localhost:1983 $ cursor .
模式 1——通过集成终端进行具名查询
Cursor Agent 可调用任意 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 '{...}'该变量仅在单条语句中有效。Agent 在赋值和使用之间无法看到 key 的值——且由于 Cursor 不会将展开后的值回显到对话中,该凭证绝不会出现在聊天历史中。
对于多凭证配置文件,请使用 render:
$ clavitor-cli render app.config.json | myapp --config -
模式 2——通过代理进行透明注入
设置 HTTPS_PROXY 后,Agent 会写入引用,代理会在传输过程中解析该引用。密钥绝不会进入 Agent 内存或对话内容:
# Cursor's agent runs this verbatim curl -H "Authorization: Bearer clavitor://OpenAI/key" \ https://api.openai.com/v1/models
Agent 会在自身的命令历史中看到 clavitor://OpenAI/key。而出站请求会在 Authorization 头中携带真实的 sk-... 值。日志抓取工具、崩溃转储和 cursor 历史记录均保持干净。
以下情况适合使用该模式:
- Agent 在会话期间生成临时 curl/HTTP 调用
- Agent 调用的工具自行发起 HTTPS 调用
- 您希望将密钥完全移出对话上下文窗口
Cursor CLI(通过脚本调用 Agent 模式)
Cursor 1.x 提供了用于无头 Agent 运行的独立 CLI。适用相同的 HTTPS_PROXY 规则——请在调用前在 shell 中设置该环境变量:
$ export HTTPS_PROXY=http://localhost:1983 $ cursor-agent "deploy the latest tag to staging" --workspace ~/dev/myapp
对于长时间运行的任务,Agent 令牌的 IP 白名单会将凭证读取权限锁定到 Agent 运行的主机。在其他主机上运行时,保险库将拒绝访问。
所有访问操作均会被记录
审计日志会记录哪个 Agent 访问了哪个凭证、访问时间及访问来源。Cursor Agent 的活动会被明确标记,以区别于人类用户活动。
# 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