GoLogin MCP

面向 AI Agent 的 GoLogin MCP 服务

通过 AI 对话管理 GoLogin 浏览器配置文件、代理、指纹、文件夹和云浏览器会话。此模型上下文协议（MCP）服务将 AI 客户端连接到 GoLogin API。

快速开始

你需要 Node.js 22 或更高版本、有效的 GoLogin 账户以及 GoLogin API 令牌。我们已在 macOS Apple Silicon 上测试 Node.js 22 和 24 LTS。

1. 登录你的 GoLogin 账户，打开 API & MCP，并在 API 标签页中生成令牌。
2. 将此配置添加到你的 MCP 客户端，并替换令牌占位符。将其合并到任何现有的 mcpServers 配置中。

{
  "mcpServers": {
    "gologin-mcp": {
      "command": "npx",
      "args": ["-y", "gologin-mcp"],
      "env": {
        "API_TOKEN": "your-gologin-api-token-here"
      }
    }
  }
}

3. 重启或重新加载客户端的 MCP 连接，然后询问：“显示我的 GoLogin 配置文件。”

客户端会自动启动服务。-y 允许 npm 无需交互式确认即可安装此软件包。此服务读取 API_TOKEN；其他 GoLogin CLI 使用的 GOLOGIN_TOKEN 变量在此处不是别名。

如需在终端中检查启动情况，请先确保环境中已设置 API_TOKEN：

npx -y gologin-mcp

此服务通过标准输入/输出（stdio）进行通信，并等待 MCP 客户端连接。它不会自行打开浏览器，也不会提供交互式命令提示符。

你可以做什么

• 创建、读取、更新、删除和整理浏览器配置文件。
• 配置配置文件代理并刷新浏览器指纹。
• 管理文件夹及其配置文件成员。
• 读取账户信息。
• 在 GoLogin 云端启动和停止浏览器配置文件。

云端启动会返回一个连接 URL。此服务不提供页面导航、点击、表单填写或本地 Orbita 启动工具。如需自动化操作页面，请使用单独的浏览器自动化客户端或 GoLogin Agent Browser CLI。

MCP 进程在本地运行；GoLogin API 请求和云浏览器会话需要网络连接。云服务的可用性和 API 操作取决于你的账户权限和套餐。

工具

工具名称根据 GoLogin OpenAPI 规范中的 HTTP 方法和路径生成，服务会在启动时加载该规范。以下仅列出部分可用工具，并非固定的别名列表。请在 MCP 客户端中查询 tools/list，获取当前名称和输入架构。

工具	描述
get_profile_v2	列出和搜索配置文件，并支持分页和文件夹筛选
post_profile_custom	创建配置文件，并设置名称、操作系统和代理等部分选项
get_profile_id	按 ID 读取配置文件
put_profile_id_custom	更新所选配置文件设置
delete_profile	删除 profilesToDelete 中列出的配置文件
patch_profile_proxy_many_v2	为一个或多个配置文件配置代理
patch_profile_fingerprints	刷新 browsersIds 中列出的配置文件指纹
get_proxy_v2	列出代理
get_folders	列出文件夹
post_folders_folder	按名称创建文件夹
patch_folders_folder	在文件夹中添加或移除配置文件
delete_folders_folder	按名称删除文件夹
post_profile_id_web	在云端启动配置文件并返回连接 URL
delete_profile_id_web	停止云端配置文件
get_user	读取账户信息

例如，MCP 客户端可以发送以下 tools/call 请求来读取配置文件：

{
  "name": "get_profile_id",
  "arguments": {
    "id": "your-profile-id"
  }
}

参数遵循各工具的输入架构。路径参数、查询参数和请求正文中的字段均作为顶层参数传递。

示例提示词

• “显示我的 GoLogin 配置文件。”
• “创建一个名为 ‘Research’ 的 Linux 配置文件。”
• “将配置文件 PROFILE_ID 重命名为 ‘Research US’。”
• “更新配置文件 PROFILE_ID，使其使用这些代理设置。”
• “刷新配置文件 PROFILE_ID 的指纹。”
• “创建一个名为 ‘Research’ 的文件夹，并将配置文件 PROFILE_ID 添加到其中。”
• “在云端启动配置文件 PROFILE_ID，并提供连接 URL。”
• “停止配置文件 PROFILE_ID 的云端会话。”
• “显示我的 GoLogin 账户信息。”

MCP 客户端设置

Claude Desktop

打开 Settings > Developer > Edit Config，并将 Quickstart 配置添加到 claude_desktop_config.json。完全退出并重启 Claude Desktop，然后检查 gologin-mcp 及其工具是否可用。

有关配置路径和故障排除，请参阅官方本地 MCP 设置指南。

Cursor

将 Quickstart 配置添加到用户账户的 ~/.cursor/mcp.json，或项目的 .cursor/mcp.json。重新加载 MCP 连接并启用服务的工具。请勿将包含 API 令牌的配置纳入版本控制。

有关当前客户端设置，请参阅 Cursor 的 MCP 文档。

其他 MCP 客户端

使用支持本地 stdio MCP 服务的客户端。将 npx 配置为命令，将 -y 和 gologin-mcp 配置为其参数，并在服务环境中设置 API_TOKEN。配置格式和位置取决于客户端。

故障排除

• 服务无法连接： 检查客户端是否可以使用 Node.js 和 npx，然后重启其 MCP 连接。服务还需要访问 docs-download.gologin.com，以加载其工具定义。
• API 返回 401 Unauthorized： 检查传递给服务的 API_TOKEN，以及该令牌在 GoLogin 中是否有效。更改令牌后，请重启连接。
• 找不到工具名称： 刷新工具列表，并使用 tools/list 返回的名称；list_profiles 和 start_browser 等名称不是内置别名。
• 云端启动失败： 检查 API 响应和账户的云端访问权限。本地 MCP 服务启动本身不会在你的计算机上启动 Orbita。

开发

git clone https://github.com/gologinapp/gologin-mcp.git
cd gologin-mcp
npm ci
npm run build

若要使用已配置 API_TOKEN 的本地构建，请运行：

node dist/index.js

发布前，请运行：

npm run release:check

此软件包仅包含已构建的服务、软件包元数据、README 和许可证。发布检查会验证此允许列表，确保本地状态、数据库、凭据和开发文件不会作为额外文件包含在内。npm publish 会自动运行相同的检查。

MCP Registry 发布

server.json 描述了此服务在官方 MCP Registry 中的信息，标识符为 io.github.gologinapp/gologin-mcp。npm 软件包在 mcpName 中声明了相同的标识符。

请确保 package.json、package-lock.json 和 server.json 中的版本一致。先发布通过检查的 npm 软件包，然后在 main 分支的仓库 Actions 选项卡中运行 Publish to MCP Registry。此工作流会验证 npm 发布包包含正确的 Registry 标识符，并使用 GitHub OIDC 进行身份验证，无需单独的 Registry 令牌。它不会发布到 npm。

链接

• GoLogin
• GoLogin API 文档
• npm 软件包
• Glama 目录

许可证

MIT，版权所有 GoLogin。