如何通过 MCP 将 Infisical 连接到 Cursor

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Infisical、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Infisical + Cursor

以机器身份登录 Infisical 密钥管理（Cloud US、Cloud EU 或自托管）：项目、环境、文件夹和密钥导入，密钥名称和元数据，按需读取单个密钥值，标签，项目成员，身份和审计日志。可创建和更新密钥，创建文件夹、环境和标签；删除密钥在安装时关闭。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

INFISICAL_URL, INFISICAL_CLIENT_ID, INFISICAL_CLIENT_SECRET

步骤 1 — 获取凭证

设置大约需要 5 分钟，需要 Infisical 组织管理员操作。连接器以使用 Universal Auth 的机器身份（Machine Identity）登录。

1. 在 Infisical 中打开 Organization、Access Control、Machine Identities（旧版本：Organization Settings、Identities），点击 Create Identity，例如命名为 AnythingMCP，并赋予组织角色 Member 或自定义角色。读取审计日志需要具有审计日志访问权限的角色。
2. 为该身份添加认证方式 Universal Auth。访问令牌的 TTL（默认 30 天）可以保留或缩短；连接器会自动重新登录。在 Client Secrets 下创建一个 usage limit 0（不限次数）的密钥，因为每次新登录都会使用它一次。如果设置了 Trusted IPs，请包含你的 AnythingMCP 服务器的出站地址。
3. 把 Client ID（一个 UUID）复制到 INFISICAL_CLIENT_ID，把只显示一次的 Client Secret 复制到 INFISICAL_CLIENT_SECRET。
4. 把该身份添加到它需要访问的每个项目：在项目中打开 Access Control、Machine Identities、Add Identity，只读选择角色 Viewer，需要写入则选择 Developer 或自定义角色。把角色限制在所需的环境和路径上。
5. 把 INFISICAL_URL 设为 https://app.infisical.com（Cloud US）、https://eu.infisical.com（Cloud EU）或你自己实例的地址，不带 /api，末尾不加斜杠。
6. 安装连接器并运行 infisical_list_projects：它会确认登录并列出该身份所属的项目。

连接器在 /api/v1/auth/universal-auth/login 登录，以 Authorization: Bearer 发送访问令牌，并自动续期。

密钥值会到达 AI：Infisical 会以明文把值返回给任何有权读取的人，这个连接器读取或写入的每个值都会经过对话和 AI 提供商。因此 infisical_list_secrets 和 infisical_get_secret 只返回名称和元数据：它们要求 Infisical 不发送值。唯一返回值的工具是 infisical_read_secret_value，每次调用只读一个密钥，AI 只在你要求这个值时才使用它。你传给 infisical_create_secret 和 infisical_update_secret 的值同样会经过对话。如果聊天中永远不应出现任何值，工作区管理员可关闭 infisical_read_secret_value，或给该身份分配没有读取值权限的角色。Infisical 会在审计日志中记录每次值读取。

可读取的内容：该身份所属的组织（infisical_get_identity_details）；项目及其环境（名称、slug、id）；环境中的文件夹，以列表形式或用 recursive 获取整棵树；密钥导入，即文件夹从中继承密钥的其他环境或路径；密钥名称及版本、备注、标签、元数据和时间戳，可用 tag_slugs 或 metadata_filter 筛选，并可用 infisical_get_secret 读取单个密钥的元数据或较早的 version；标签；项目成员及其角色、项目身份和组织身份；以及组织审计日志（infisical_list_audit_logs），可按项目、环境、密钥、操作者、事件类型（例如 get-secret、update-secret 或 delete-secret）和日期筛选，查出谁读取或修改了某个密钥。除非 expand_secret_references 为 false，infisical_read_secret_value 会解析 ${DB_HOST} 这类引用。

可写入的内容：infisical_create_secret、infisical_update_secret（新值、用 new_secret_name 改名、备注或标签；tag_ids 会替换整个标签列表）、infisical_create_folder、infisical_create_environment 和 infisical_create_tag。Infisical 会保留密钥的上一个版本，因此值的更改可以在控制台中回滚。读取该密钥的应用会在下次获取时拿到新值，所以 AI 在写入生产环境前会先和你确认环境。如果某个环境设有变更审批策略，创建或更新会在 Infisical 中发起审批请求，而不是立即修改密钥。

安装时关闭：infisical_delete_secret。它无法通过此连接器撤销，并会让所有读取该密钥的应用和流水线失效，因此由工作区管理员在团队需要时开启。

数据格式：id 是 UUID；环境用 slug（dev、staging、prod）指定，项目用 id 指定。路径以 / 开头，单独的 / 是根目录。version 是密钥的修改次数；secretValueHidden: true 表示没有发送值。时间为 UTC 的 ISO 8601 格式。

分页：infisical_list_audit_logs（默认 20 条）、infisical_list_project_identities 和 infisical_list_org_identities（默认 100 条）用 offset 和 limit 分页；只要一页返回满额，AI 就用更大的 offset 继续请求。其他列表在一次响应中返回全部内容。

限制：Infisical Cloud 按每个客户端 IP 每分钟计，根据套餐允许 200 到 600 次读取、90 到 300 次写入和 120 到 500 次密钥操作，总计 600 个请求。429 会说明需要等待多少秒。审计日志的保留时长取决于套餐。自托管的 Infisical 需要 0.150 或更高版本，才能使用连接器所用的 v4 密钥 API。

常见错误：401，或带 TokenError 的 403，表示登录失败：Client ID 或 Client Secret 错误，client secret 已被吊销、过期或用尽，INFISICAL_URL 的区域不对，或 IP 不在 Trusted IPs 内。403 PermissionDenied 表示该身份的角色不允许访问这个项目、环境、路径或执行此操作。404 表示 id、slug、路径或密钥名称错误；名称区分大小写。

使用安装时开启的工具，连接器不会删除密钥。它每次调用最多读取一个值，不修改成员、角色或机器身份，也不管理证书或 KMS 密钥。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Cursor 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目：

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 Cursor。
3. 打开 Cursor → Settings → MCP，确认 anythingmcp 已列出并处于已连接状态。
4. 开始对话，智能体现在可以调用 Infisical 的工具。

可用工具

示例提示

• “我们 backend 项目的 prod 环境里有哪些密钥？只要名称，不要值。”
• “过去 7 天里是谁修改了生产环境的密钥 STRIPE_SECRET_KEY？”
• “给我看 api 项目 staging 环境中 DATABASE_URL 的值。”
• “在 dev 中创建文件夹 /payments，并添加密钥 PAYMENTS_WEBHOOK_URL，值为 https://example.com/hooks/payments。”
• “哪些机器身份和用户可以访问 web 项目，各自是什么角色？”

FAQ

Cursor 免费套餐支持自定义 MCP 服务器吗？ 支持，Hobby、Pro 和 Business 套餐均可使用 MCP。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT
• 连接到 Gemini
• 连接到 Meta Muse
• 连接到 Microsoft Copilot