如何通过 MCP 将 1Password Connect 连接到 Cursor

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

1Password Connect + Cursor

通过你自托管的 1Password Connect 服务器访问 1Password 的保险库和项目：列出保险库和项目，读取项目及其机密值和附件，创建带生成密码的项目，用 JSON Patch 修改项目，并读取服务器的请求日志。删除在安装时关闭。

前提条件

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

ONEPASSWORD_CONNECT_URL, ONEPASSWORD_CONNECT_TOKEN

步骤 1 — 获取凭证

设置大约需要 15 分钟，需要一台已部署的 1Password Connect 服务器，也就是 1Password 为 Secrets Automation 在你自己的基础设施中运行的自托管 REST API。

1. 在 1Password.com 打开 Developer、Directory，在 Infrastructure Secrets Management 下选择 Other，然后选择 Create a Connect server（或运行 op connect server create <name> --vaults <vault>）。把 1password-credentials.json 文件和第一个访问令牌保存在 1Password 中。Connect 只能访问授权给它的共享保险库，永远无法访问个人或私人保险库。
2. 部署服务器：使用 https://github.com/1Password/connect 中的 connect-api 和 connect-sync 容器，通过 Docker Compose、Kubernetes 或 Helm chart 运行。默认监听 8080 端口。
3. 使用第一个令牌，或专门为 AI 签发一个：Developer、Connect servers，选择服务器，New Token（或 op connect token create <name> --server <server> --vault <vault>）。只授予 AI 应该看到的保险库。令牌的保险库之后无法更改；需要更改时，请撤销它并签发新令牌。可以设置 30、90 或 180 天的有效期。
4. 把 ONEPASSWORD_CONNECT_URL 设为 AnythingMCP 访问该服务器所用的地址，不带 /v1，末尾不加斜杠（例如 https://op-connect.example.com 或 http://10.0.0.5:8080），并把令牌（以 eyJ 开头的 JWT，不带 Bearer）粘贴到 ONEPASSWORD_CONNECT_TOKEN。
5. 安装连接器并运行 onepassword_connect_list_vaults：它会确认令牌并列出可访问的保险库。

Connect 服务器的位置：在 AnythingMCP Cloud 上，Connect 服务器需要公网 HTTPS 地址。自托管的 AnythingMCP 要访问私有网络或私有 IP 上的服务器，必须先通过 SSRF_ALLOWED_HOSTS 允许该主机，因为出站防护默认会拦截私有地址段。

AI 会看到机密值。以下工具以明文返回机密：

• onepassword_connect_get_item：项目的密码、API 密钥、TOTP 种子、备注和其他隐藏字段，位于 fields[].value。
• onepassword_connect_get_file_content：附件的内容（证书、密钥文件、文档），最大 4 MB。
• onepassword_connect_create_item 和 onepassword_connect_update_item：它们返回完整的项目，包括机密值和生成的密码。

这些值会传给 AI 模型并出现在聊天中。列表工具（onepassword_connect_list_vaults、onepassword_connect_list_items、onepassword_connect_list_files）以及 onepassword_connect_get_vault 和 onepassword_connect_get_file 只返回元数据。只给令牌授予 AI 应该看到的保险库；如果 AI 只应处理名称，请让工作区管理员关闭 onepassword_connect_get_item 和 onepassword_connect_get_file_content。除非你要求，AI 不会在回答中复述机密。

查找机密：先用 onepassword_connect_list_vaults（筛选条件如 name eq "Production"），再用 onepassword_connect_list_items 查看标题、类别、标签、URL、版本和日期（筛选条件 title eq "Stripe API" 或 tag eq "prod"），只有确实需要值本身时才调用 onepassword_connect_get_item。文件：用 onepassword_connect_list_files 或 onepassword_connect_get_file 查看名称和大小，用 onepassword_connect_get_file_content 下载。

可写入的内容：onepassword_connect_create_item 需要类别、标题和字段；带有 generate: true 和 recipe 的字段会由 1Password 生成随机值。onepassword_connect_update_item 用 JSON Patch（RFC 6902：add、remove、replace）修改项目的一部分，路径包括 /title、/favorite、/tags、/urls、/fields（添加字段）、/fields/<field id> 或 /fields/<field id>/value；路径 / 会替换整个项目。AI 会先用 onepassword_connect_get_item 读取字段 id。1Password 会在项目历史中保留上一个版本。

检查服务器：onepassword_connect_list_activity 按从新到旧列出服务器处理过的请求：READ、CREATE、UPDATE 或 DELETE，结果为 SUCCESS 或 DENY，按令牌和项目区分。onepassword_connect_get_health 显示服务器、同步服务和账户连接是否正常，从而区分服务器问题和令牌问题。

安装时关闭：onepassword_connect_delete_item。删除无法撤销，通过 Connect 读取该机密的应用会立即找不到它，因此由工作区管理员在团队需要时开启。

数据格式：保险库和项目的 id 由 26 个小写字母和数字组成。字段包含 id、label、type（STRING、CONCEALED、EMAIL、URL、TOTP、DATE、MONTH_YEAR、MENU）、purpose（USERNAME、PASSWORD、NOTES）、value 和 section；密码字段还带有 entropy。日期为 ISO 8601 格式。

分页：列表在一次响应中返回整个集合。只有 onepassword_connect_list_activity 分页，使用 limit（默认 50）和 offset，并在 content-range 响应头（1-50/1134）中给出总数。

常见错误：401 表示令牌错误或已撤销，或是为另一台 Connect 服务器签发的。403 vault ... is not in scope 表示令牌未获授权访问该保险库，或无权写入。404 表示保险库、项目或文件不存在；每次调用都返回 404，说明 ONEPASSWORD_CONNECT_URL 不是 Connect API 的地址。写入时的 400 会指出无效的字段或类别。413 表示文件太大，无法返回。连接错误通常表示 AnythingMCP 无法访问 ONEPASSWORD_CONNECT_URL；onepassword_connect_get_health 和服务器日志会提供更多信息。

连接器无法访问个人或私人保险库，也无法访问未授权给令牌的保险库；使用安装时开启的工具不会删除项目；不会创建 Connect 服务器或令牌；也不读取账户的登录和审计事件（那是 1Password Events 连接器的功能）。

步骤 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. 开始对话，智能体现在可以调用 1Password Connect 的工具。

可用工具

示例提示

• “AI 能访问哪些保险库，每个保险库里有多少个项目？”
• “在 Production 保险库中找到 Stripe API 项目，告诉我它最后一次修改的时间，不要显示密钥。”
• “在 DevOps 保险库中为 staging 数据库创建一个 Login 项目，用户名为 app，并使用生成的密码。”
• “给 Infrastructure 保险库中的 Mail relay 项目添加标签 rotated。”
• “今天有哪些令牌通过 Connect 读取了项目，有没有请求被拒绝？”

FAQ

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

下一步

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