提出需求，
ROOTKey 来完成。

开始之前：自定义连接器适用于 Free（一个自定义连接器）、Pro、Max、Team 和 Enterprise。在 Team 中，只有 Owner 和 Primary Owner 可以添加；在 Enterprise 中，自定义角色包含 Manage access to Libraries 的用户也可以添加。成员随后点击 Connect。在移动应用中添加仍处于测试阶段，请使用网页版或 Claude Desktop。

1. 打开 Connectors在 claude.ai 或 Claude Desktop 中，打开 Customize > Connectors。在 Team 或 Enterprise 中，由 Owner 打开 Organization settings > Connectors。
2. 添加自定义连接器点击 + Add > Add custom connector（部分账户显示为 Add > Custom > Web）。Team 或 Enterprise 的 Owner 在 Organization settings > Connectors 中点击 Add > Custom，如有提示则选择 Web。将其命名为 ROOTKey，并输入此地址：https://mcp.rootkey.ai/mcp复制
3. 选择登录设置在 Authentication 下选择 Sign in now 或 Sign in when needed，不要选 No sign-in。在 OAuth client 下选择 Use Claude's published identity (Recommended)。Request headers 留空，然后点击 Add。这些设置之后无法更改：如需更改，请移除连接器后重新添加。如果您的对话框是带有 Advanced settings 的单个页面，请输入名称和地址，Advanced settings 留空，然后点击 Add。
4. 连接并登录 ROOTKey点击 Connect 并登录 ROOTKey。在授权页面上，选择权限（Read、Write、Delete）、Stay connected 和组织，然后点击 Allow access。无需创建或粘贴令牌。
5. 在对话中启用在消息框中选择 + > Connectors，开启 ROOTKey。当 Claude 请求使用工具时，选择 Allow once 或 Always allow。之后可以在 Customize > Connectors > ROOTKey 中更改工具权限（Always allow、Needs approval、Blocked）。在 Team 和 Enterprise 中，Owner 可以为整个组织限制这些权限，您无法覆盖这些限制。
6. 用完后断开连接在 ROOTKey 中打开 Account Settings > Connected apps，打开该应用的操作菜单并选择 Disconnect app。然后在 Claude 中移除连接器（Customize > Connectors > ROOTKey，三点菜单，Remove）。组织连接器由 Owner 在 Organization settings > Connectors 中移除。

步骤已对照官方文档（Claude Help Center、Claude Docs）核对，2026 年 10 月。

开始之前：自定义 MCP 服务器需在浏览器中通过 chatgpt.com 添加，移动应用中无法添加。完整支持（包括写入操作）适用于 Business 和 Enterprise/Edu，由管理员和所有者添加（在 Enterprise/Edu 中，获得 Create plugins with MCPs 权限的成员也可以）。Pro 仅提供读取和获取工具。OpenAI 未说明 Plus、Go 或 Free 能否添加。

1. 打开 Plugins在 chatgpt.com 上进入 Plugins，选择加号按钮，然后选择 Add custom MCP server。无需开启 Developer Mode。将其命名为 ROOTKey。
2. 使用此地址在 Connection 下输入：https://mcp.rootkey.ai/mcp复制
3. 选择 OAuth身份验证选择 OAuth。无需粘贴任何令牌。如果 ChatGPT 询问注册方式，请选择 CIMD（客户端 ID 元数据文档）：ROOTKey 不提供动态客户端注册。
4. 创建并登录勾选 I understand and want to continue，然后选择 Create as a plugin。当 ChatGPT 要求登录时（立即或在首次使用 ROOTKey 工具时），登录 ROOTKey，选择组织和权限，然后点击 Allow access。
5. 安装插件，并为工作区发布安装该插件。若要在 Business 或 Enterprise/Edu 工作区中共享，由管理员或所有者在 Admin Console > (工作区) > Plugins > Manage Legacy Apps > Drafts > Publish 中发布。在 Enterprise/Edu 中，发布对话框还提供 Configure Actions 和 Configure Access。用户随后可在 Settings > Plugins 中找到它。
6. 在对话中使用在输入框中键入 @ 并选择 ROOTKey。该选择只对一条消息有效，因此每次请求都需再次提及。ChatGPT 请求确认写入操作时，请予以确认。

注意：ChatGPT 会保存工具的快照。ROOTKey 更改工具后，请在 Plugins 中打开该服务器并选择 Refresh；发布到工作区的应用需要管理员刷新并重新发布。如果某个 ROOTKey 组织将 Allowed apps 限制为 Only these apps，则在管理员添加 ChatGPT 的客户端元数据地址之前，ChatGPT 在该组织中会被阻止；该地址预计为 https://chatgpt.com/oauth/client.json（未经测试）。

步骤已对照官方文档（OpenAI Help Center）核对，2026 年 10 月。

Gemini 应用目前还无法连接 ROOTKey 托管连接器。Gemini 应用和 Gemini CLI 通过 Dynamic Client Registration 或预先签发的 OAuth 凭据登录服务器，而 ROOTKey 使用客户端 ID 元数据文档。请将 Gemini CLI 与 ROOTKey 本地服务器配合使用，或使用 Claude 等其他应用。

开始之前：自 2026 年 6 月 18 日起，Gemini CLI 和 Gemini Code Assist 扩展仅支持 Gemini Code Assist Standard 或 Enterprise 许可证或付费 Gemini API 密钥，不再支持 Google AI Pro、Ultra 或免费个人版。本地服务器需要 Node.js 20 或更高版本。

1. 创建个人访问令牌在 ROOTKey 应用中打开 Account Settings > Personal access tokens，只选择所需的范围和组织。在 shell 中将其设置为 ROOTKEY_TOKEN。切勿将令牌粘贴到对话中。
2. 将本地服务器添加到 Gemini CLI将以下内容添加到 ~/.gemini/settings.json 的 mcpServers 下。Gemini CLI 会从您的环境中读取 $ROOTKEY_TOKEN。VS Code 中的 Gemini Code Assist 读取同一文件：之后运行 Developer: Reload Window。

   {
     "mcpServers": {
       "rootkey": {
         "command": "npx",
         "args": ["-y", "@rootkey/mcp"],
         "env": { "ROOTKEY_TOKEN": "$ROOTKEY_TOKEN" }
       }
     }
   }

   复制
3. 检查连接重启 gemini 并运行 /mcp：应能看到 rootkey 及其工具（32 个，设置 ROOTKEY_READ_ONLY=true 时为 20 个）。然后让它调用 rootkey_get_environment_info。

步骤已对照官方文档（Gemini CLI）核对，2026 年 10 月。

开始之前：xAI 表示连接器面向所有 Grok 用户开放。在 Grok Business 和 Enterprise 中，需由团队管理员先添加连接器，这需要 Team Read-Write 权限。

1. 打开 Connectors登录 grok.com 并打开 grok.com/connectors。在 Business 或 Enterprise 中，管理员需先在 console.x.ai > (您的团队) > Grok Business > Connectors > + Add Connector > Other 中为团队添加。
2. 添加自定义连接器点击 New Connector，再点击 Custom，然后输入此地址。无需令牌、请求头或 API 密钥：https://mcp.rootkey.ai/mcp复制
3. 登录 ROOTKey完成 Grok 要求的登录。在授权页面上，选择组织和权限，然后点击 Allow access。如果页面显示 Unverified app 标记，请仅在连接是您本人从 grok.com 发起时继续。
4. 在对话中使用例如提问：“列出我的 ROOTKey 组织。”xAI 未说明自定义连接器有按对话启用的开关，因此如果 Grok 没有使用 ROOTKey，请在请求中提及 ROOTKey。
5. 用完后断开连接在 ROOTKey 应用中打开 Account Settings > Connected apps，在该应用的操作菜单中选择 Disconnect app。如果不再需要，也请在 grok.com/connectors 中移除该连接器。

尚未与 ROOTKey 一起测试。xAI 未说明 Grok 如何向登录服务器注册，因此从 Grok 登录 ROOTKey 尚未得到确认。如果无法完成，请使用 Claude 或 Claude Code。

curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-4.7",
    "input": [{"role": "user", "content": "List my ROOTKey organizations"}],
    "tools": [{
      "type": "mcp",
      "server_url": "https://mcp.rootkey.ai/mcp",
      "server_label": "rootkey",
      "authorization": "<ROOTKEY_OAUTH_ACCESS_TOKEN>"
    }]
  }'

步骤已对照官方文档（xAI）核对，2026 年 10 月。

1. 添加自定义连接器在您的 AI 应用的连接器或 MCP 设置中，添加一个自定义连接器。
2. 使用此地址https://mcp.rootkey.ai/mcp复制
3. 连接并登录 ROOTKey无需创建或粘贴令牌。
4. 选择它可以做什么在授权页面上，选择该应用可访问的组织和获得的权限。

开始之前：您需要登录 Claude Code（Pro、Max、Team 或 Enterprise，或 Claude Console 账户）。无需 ROOTKey 令牌：在浏览器中登录即可。在 ROOTKey 中，如果管理员将 Organization Settings > AI agents > Allowed apps 设置为 Only these apps，Claude Code 必须在该列表中（您首次连接后，管理员即可添加）。

1. 添加托管服务器在终端中运行以下命令。--scope user 使其在所有项目中可用；--scope project 会写入 .mcp.json，与团队共享，Claude Code 随后会请每个人批准该服务器。在 VS Code 扩展（v2.1.261 或更高版本）中，也可以在聊天面板中键入 /mcp 并在那里添加。claude mcp add --transport http --scope user rootkey https://mcp.rootkey.ai/mcp复制
2. 登录在 Claude Code 中运行 /mcp，选择 rootkey 并登录。也可以在 shell 中运行 claude mcp login rootkey。
3. 在 ROOTKey 中批准登录 ROOTKey，选择组织和权限，然后点击 Allow access。页面会提示该应用在您的设备上接收结果：请仅在连接是您本人发起时继续。
4. 检查运行 claude mcp list：rootkey 应显示为 Connected。然后提问：“列出我的 ROOTKey 组织。”
5. 撤销访问在 Claude Code 中，使用 /mcp 中的 Clear authentication 或运行 claude mcp logout rootkey，再运行 claude mcp remove rootkey 移除服务器。在 ROOTKey 中，打开 Account Settings > Connected apps 并选择 Disconnect app；这不会从 Claude Code 中移除该服务器。

步骤已对照官方文档（Claude Code）核对，2026 年 10 月。

Cursor 目前还无法登录 ROOTKey 托管连接器。Cursor 通过 Dynamic Client Registration 向服务器注册，尚不支持 ROOTKey 使用的客户端 ID 元数据文档。请使用本地服务器和个人访问令牌。

开始之前：本地服务器需要 Node.js 20 或更高版本。在团队账户中，管理员设置的允许列表（Team Settings > MCP Configuration）可能会阻止不在列表中的服务器。

1. 创建个人访问令牌在 ROOTKey 应用中打开 Account Settings > Personal access tokens，只选择所需的范围和组织。在启动 Cursor 的环境中将其设置为 ROOTKEY_TOKEN，切勿提交到 git。
2. 将服务器添加到 mcp.json将以下内容添加到 ~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（当前项目）。${env:ROOTKEY_TOKEN} 可让令牌不写入文件。

   {
     "mcpServers": {
       "rootkey": {
         "command": "npx",
         "args": ["-y", "@rootkey/mcp"],
         "env": { "ROOTKEY_TOKEN": "${env:ROOTKEY_TOKEN}" }
       }
     }
   }

   复制
3. 启用在侧边栏中打开 Customize，确认 rootkey 已列出并已启用。如果工具没有出现，请完全重启 Cursor。
4. 检查连接在 Agent chat 中让 Cursor 调用 rootkey_get_environment_info，并批准该工具调用。如果失败，请查看 Output > MCP Logs。

步骤已对照官方文档（Cursor）核对，2026 年 10 月。

开始之前：请使用 VS Code 1.106 或更高版本（步骤 1 中的 Global > Copilot Global 目标需要 1.140 或更高版本）。在 Copilot Business 或 Enterprise 中，管理员必须开启默认关闭的 MCP servers in Copilot 策略，管理员设置的允许列表也可能阻止 ROOTKey。在 ROOTKey 中，如果管理员将 Organization Settings > AI agents > Allowed apps 设置为 Only these apps，VS Code 必须在该列表中（您首次连接后，管理员即可添加）。

1. 添加服务器打开 Command Palette 并运行 MCP: Add Server。选择 HTTP (HTTP or Server-Sent Events)，输入此地址和 ID rootkey，并选择 Global > Copilot Global 以便在所有工作区中使用：https://mcp.rootkey.ai/mcp复制
2. 登录 ROOTKey首次连接时，VS Code 会在浏览器中打开 ROOTKey。登录，选择组织和权限，然后点击 Allow access。无需粘贴令牌。如果无法连接，请运行 MCP: List Servers，选择 rootkey，然后使用 Restart 或 Show Output。工作区服务器（.vscode/mcp.json、.mcp.json）遵循 Workspace Trust，在 Restricted Mode 下不会启动。全局服务器可能会在首次启动时请您信任它；MCP: Reset Trust 可重置该选择。
3. 启用工具在 Copilot Chat 中选择 Agent，打开 Chat: Open Customizations > Tools，确认 rootkey 工具已启用。然后提问：“列出我的 ROOTKey 组织。”
4. 或编辑文件在 .vscode/mcp.json 或用户 mcp.json（在 Add Server 选择器中标为已弃用，但仍会读取）中添加以下内容。可移植文件（.mcp.json、~/.copilot/mcp-config.json）使用 mcpServers 而不是 servers：请勿混用两种格式。

   {
     "servers": {
       "rootkey": {
         "type": "http",
         "url": "https://mcp.rootkey.ai/mcp"
       }
     }
   }

   复制
5. Visual Studio 和 JetBrains在 Visual Studio 2026 中，打开 Agent mode > Tools > + > Add custom MCP server（在 Visual Studio 2022 17.14 或更高版本中，+ 会直接打开 Add MCP server）。在 Tools 中开启这些工具，并通过 .mcp.json 中的 Manage Authentication CodeLens 登录。此登录能否用于 ROOTKey 尚未验证。JetBrains 版 Copilot 不支持客户端 ID 元数据文档，因此托管登录在那里很可能失败：请改用本地服务器。

步骤已对照官方文档（VS Code）核对，2026 年 10 月。

Windsurf 现已更名为 Devin Desktop，其智能体为 Devin Local。旧的 Cascade 设置（~/.codeium/windsurf/mcp_config.json）已不再适用。Devin 仅记录了通过动态客户端注册或预先注册的客户端进行登录，因此登录 ROOTKey 托管连接器尚未验证：请使用本地服务器。

开始之前：在 Enterprise 中，管理员必须先开启 Devin Local Agent，Teams 和 Enterprise 的管理员可以限制 MCP 服务器。devin 命令需要 Devin CLI：使用 Command Palette > Install Devin CLI（在 Enterprise 中，管理员须先开启 Install Devin CLI in Devin Desktop），或运行 curl -fsSL https://cli.devin.ai/install.sh | bash（macOS/Linux）或 irm https://static.devin.ai/cli/setup.ps1 | iex（Windows）。本地服务器需要 Node.js 20 或更高版本。

1. 打开 Devin Local更新 Devin Desktop。如果智能体选择器中没有 Devin Local，请打开 Devin User Settings > Agents，将其开启并重启。
2. 创建个人访问令牌在 ROOTKey 应用中打开 Account Settings > Personal access tokens，只选择所需的范围。
3. 添加本地服务器将 <token> 替换为您的令牌后运行以下命令，然后重启 Devin Desktop。不要把令牌放进 git 跟踪的文件中。devin mcp add -s user -e ROOTKEY_TOKEN=<token> rootkey -- npx -y @rootkey/mcp复制
4. 检查并使用在新的 Devin Local 标签页中，让它调用 rootkey_get_environment_info，然后提问：“列出我的 ROOTKey 组织。”默认情况下，Devin Local 会在每次调用工具前征求同意。您可以允许单个工具或整个 rootkey 服务器，仅限本次会话或永久允许。
5. 试用托管服务器请先运行 devin mcp remove rootkey -s user 移除本地条目。然后将以下内容添加到 %APPDATA%\devin\mcp_config.json（Windows）或 ~/.config/devin/mcp_config.json（macOS/Linux），或运行 devin mcp add -s user rootkey https://mcp.rootkey.ai/mcp，再运行 devin mcp login rootkey。如果在 ROOTKey 页面出现之前就出现注册或 OAuth 错误，请再次运行 devin mcp remove rootkey -s user，并按步骤 3 重新添加本地服务器。

   {
     "mcpServers": {
       "rootkey": {
         "url": "https://mcp.rootkey.ai/mcp",
         "transport": "http"
       }
     }
   }

   复制

步骤已对照官方文档（Devin）核对，2026 年 10 月。

开始之前：请使用最新的 Codex CLI 或 IDE 扩展。OpenAI 未对远程服务器规定套餐要求。Codex CLI、IDE 扩展和 ChatGPT 桌面应用共享同一配置。在 ROOTKey 中，如果管理员将 Organization Settings > AI agents > Allowed apps 设置为 Only these apps，Codex 必须在该列表中。OpenAI 未公布 Codex 的客户端元数据地址，因此在您首次连接后，管理员可从成员已连接的应用中添加它。

1. 添加服务器在终端中运行以下命令。不要传入 --oauth-client-id：ROOTKey 不需要预先注册的客户端。也可以将下方的表添加到 ~/.codex/config.toml（或受信任项目中的 .codex/config.toml）。codex mcp add rootkey --url https://mcp.rootkey.ai/mcp复制

   [mcp_servers.rootkey]
   url = "https://mcp.rootkey.ai/mcp"

   复制
2. 或在 IDE 扩展中打开 gear menu > MCP servers > Add server，命名为 rootkey，选择 Streamable HTTP，输入 https://mcp.rootkey.ai/mcp，保存后选择 Restart extension。
3. 登录运行 codex mcp login rootkey，或在 IDE 中选择 Authenticate。Codex 会在浏览器中打开 ROOTKey。其默认注册设置（auto）会为 ROOTKey 选择客户端 ID 元数据文档注册；如需强制使用，请运行 codex mcp login rootkey --oauth-client-registration cimd。不要使用 dcr：ROOTKey 没有注册端点。
4. 在 ROOTKey 中批准登录，选择组织和权限，然后点击 Allow access。
5. 检查运行 codex mcp list 或在 Codex 中键入 /mcp，然后提问：“列出我的 ROOTKey 组织。”

步骤已对照官方文档（OpenAI Codex）核对，2026 年 10 月。