登录 永久免费 立即开始

集成指南

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_PROXYPATH。在 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