Merget

Merget

Merget 是面向 GitHub 的语义合并队列。对于每个拉取请求，它都会为合并涉及的树构建代码属性图，找出分支合并时会破坏的内容（无法解析的引用、双方修改内容之间的交互、文本冲突），撰写简报并排列合并顺序；在仓库允许的情况下，它会根据拉取请求最终合入的代码准备该拉取请求并完成合并。它以 GitHub App 和服务的形式运行，地址为 sema.merget.ai。

此仓库是 Merget 面向编码 Agent 的插件：一个将 Agent 连接到 Merget MCP 服务 https://sema.merget.ai/mcp 的软件包，并附带四项技能。

• merget-setup — 首次运行：了解组织当前状况、连接 GitHub 的页面、首个仓库及其自动化模式。
• merget-operate — 像仪表盘一样操作 Merget，但不包括所有者需要执行的步骤：设置、合并队列、失败的批次、冲突、运行记录、密钥。
• merget-pr — 拉取请求的发现结果、判定、简报、队列位置、强制执行状态和额度。
• merget-graph — 对任意提交的代码属性图进行类型化查询：符号、调用方、被调用方、定义-使用链、切片、图差异。

服务包含 Agent 必须了解的内容（工具描述、提示词、指令）；技能则提供更深入的信息。Agent 会在你登录时授予的权限范围内代表你操作，绝不会以组织所有者的身份操作：所有者需要执行的步骤和浏览器中的步骤仍由你在 Merget 仪表盘中完成。

使用一条提示词进行设置

你需要先拥有 Merget 账号和组织：请在 sema.merget.ai 注册。然后将以下内容粘贴到你的 Agent 中：

Fetch and execute the instructions to set me up for Merget from https://sema.merget.ai/agent-setup/prompt.md

Agent 会安装此插件（如果使用不支持插件的 Agent，则会注册服务和技能）、登录并引导你完成 Merget 设置。没有 shell 的 Agent 会把命令提供给你。登录、批准 Agent 以及连接 GitHub（所有者需要执行的步骤）仍由你在浏览器中完成。

安装

插件 ID 为 merget@merget-queue，可从本仓库的 marketplace 安装； 服务地址为 https://sema.merget.ai/mcp。每个客户端选择一种接入方式。插件包含服务和技能，因此安装了插件的 Agent 无需手动添加服务，也无需运行 npx skills；如果插件和手动添加的服务地址相同，Agent 会看到两份相同的工具（在 Claude Code 中，手动添加的服务还会覆盖插件的服务），因此只保留一种。

客户端	安装方式
Claude Code	/plugin marketplace add MergetAI/merget-plugin，然后运行 /plugin install merget@merget-queue，再运行 /reload-plugins
Codex（CLI、ChatGPT 桌面应用）	codex plugin marketplace add MergetAI/merget-plugin，然后运行 codex plugin add merget@merget-queue
GitHub Copilot CLI	copilot plugin marketplace add MergetAI/merget-plugin，然后运行 copilot plugin install merget@merget-queue
VS Code（Copilot）	设置 "chat.plugins.marketplaces": ["MergetAI/merget-plugin"]，然后运行 /plugin install merget@merget-queue
Cursor	使用一键链接或配置 ~/.cursor/mcp.json，并运行 npx -y skills add MergetAI/merget-plugin -a cursor -g -y
Devin、Devin Desktop	devin plugins install MergetAI/merget-plugin
Kiro	Powers 面板 › Add Custom Power › Import power from GitHub › https://github.com/MergetAI/merget-plugin
Google Antigravity	agy plugin install https://github.com/MergetAI/merget-plugin
Gemini CLI	gemini mcp add -s user --transport http merget https://sema.merget.ai/mcp，并运行 npx -y skills add MergetAI/merget-plugin -a gemini-cli -g -y
Replit Agent	使用一键链接，并运行 npx -y skills add MergetAI/merget-plugin -a replit -y
claude.ai、Claude Desktop、ChatGPT	将服务添加为连接器
其他所有客户端	npx -y add-mcp https://sema.merget.ai/mcp -n merget -a <agent> -g -y，并运行 npx -y skills add MergetAI/merget-plugin -a <agent> -g -y

Claude Code

/plugin marketplace add MergetAI/merget-plugin
/plugin install merget@merget-queue
/reload-plugins

也可以将 marketplace 和插件写入 ~/.claude/settings.json，并启用自动更新，然后启动新会话：

{
  "extraKnownMarketplaces": {
    "merget-queue": {
      "source": { "source": "github", "repo": "MergetAI/merget-plugin" },
      "autoUpdate": true
    }
  },
  "enabledPlugins": { "merget@merget-queue": true }
}

要登录，请运行 /mcp，选择 plugin:merget:merget，然后选择 Authenticate；在此处选择 Clear authentication 可重新登录。Claude Code 会在插件工具前加上插件和服务自身的名称，merget-setup 技能的 references/clients.md 中对此有详细说明。不要再对同一地址运行 claude mcp add：你自行添加的服务会优先于插件中的服务，并会取代插件服务显示在 /mcp 中。

Codex

ChatGPT 桌面应用会将本仓库的 .claude-plugin/marketplace.json 作为旧版兼容的 marketplace 读取；以下 Codex CLI 命令已于 2026-10-30 在 codex-cli 0.166.0 上验证。

codex plugin marketplace add MergetAI/merget-plugin
codex plugin add merget@merget-queue

也可以在 Codex CLI 中打开 /plugins，或在 ChatGPT 桌面应用中打开 Plugins 标签页，然后从 merget-queue 标签页安装 merget。之后启动新会话。IDE 扩展不支持插件。仅添加服务： 运行 codex mcp add merget --url https://sema.merget.ai/mcp，然后运行 codex mcp login merget；Codex 会从 ~/.agents/skills 读取技能 （npx -y skills add MergetAI/merget-plugin -a codex -g -y）。

GitHub Copilot

Copilot CLI：

copilot plugin marketplace add MergetAI/merget-plugin
copilot plugin install merget@merget-queue

仅添加服务：copilot mcp add --transport http merget https://sema.merget.ai/mcp。

VS Code：在设置中添加 "chat.plugins.marketplaces": ["MergetAI/merget-plugin"]，然后在聊天中运行 /plugin install merget@merget-queue，或从 Chat: Open Customizations › Browse 安装。 仅添加服务时，请使用此链接或此命令：

vscode:mcp/install?%7B%22name%22%3A%22merget%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fsema.merget.ai%2Fmcp%22%7D

code --add-mcp '{"name":"merget","type":"http","url":"https://sema.merget.ai/mcp"}'

Copilot 的云端编码 Agent 通过仓库中的 Settings › Copilot › MCP servers 接收 JSON 格式的服务配置；请求头需来自 COPILOT_MCP_* 机密，且不支持浏览器登录：请参阅无头环境和云端运行器。

Cursor

一键配置，服务器配置已进行 Base64 编码：

cursor://anysphere.cursor-deeplink/mcp/install?name=merget&config=eyJ1cmwiOiJodHRwczovL3NlbWEubWVyZ2V0LmFpL21jcCJ9

也可以将其添加到 ~/.cursor/mcp.json（适用于所有项目）或 .cursor/mcp.json：

{ "mcpServers": { "merget": { "url": "https://sema.merget.ai/mcp" } } }

技能：npx -y skills add MergetAI/merget-plugin -a cursor -g -y。Cursor 会从市场安装 Agent 插件；团队管理员可在 Customize › Plugins & MCPs › Add Marketplace › Import from Repo 中添加此仓库。在 CLI 中，运行 agent mcp login merget 登录。Cloud Agents 会使用该页面中的团队服务器，并使用自己的登录信息；在 Customize 中，找到服务器的 Cloud 行即可。

Devin

devin plugins install MergetAI/merget-plugin

Devin 会读取 .claude-plugin/plugin.json；该插件会在云会话、 CLI 和 Devin Desktop 中加载。仅配置服务器：进入 Customize › MCPs › Add MCP › Add custom MCP，选择 HTTP 传输方式，输入服务器 URL，将身份验证设为 OAuth， 点击 Save，然后点击 Connect；在 CLI 中运行 devin mcp add merget https://sema.merget.ai/mcp， 然后运行 devin mcp login merget。仅安装技能： npx -y skills add MergetAI/merget-plugin -a devin -g -y。

Kiro

作为 Power，它会读取根目录中的 plugin.json、mcp.json 和 skills/： 打开 Powers 面板，点击 Add Custom Power、Import power from GitHub，输入 https://github.com/MergetAI/merget-plugin，然后点击 Install。仅配置服务器，一键完成：

https://kiro.dev/launch/mcp/add?name=merget&config=%7B%22url%22%3A%22https%3A%2F%2Fsema.merget.ai%2Fmcp%22%7D

或者在 .kiro/settings/mcp.json（工作区）或 ~/.kiro/settings/mcp.json （用户）中配置，使用与 Cursor 相同的 mcpServers JSON。技能： npx -y skills add MergetAI/merget-plugin -a kiro-cli -g -y。Kiro Web 仅支持通过 URL 和标头添加 自定义服务器：请参阅 无头和云端运行器。

Google Antigravity 和 Gemini CLI

agy plugin install https://github.com/MergetAI/merget-plugin

运行 agy plugin list 后，会显示四项技能和 merget 服务器。如果 服务器未显示，请按照下一段中的说明手动添加。

仅配置服务器：使用 MCP Store，或在 ~/.gemini/config/mcp_config.json 中配置 { "mcpServers": { "merget": { "serverUrl": "https://sema.merget.ai/mcp" } } }， 然后在 Customizations 下的服务器旁点击 Authenticate。Gemini CLI：运行 gemini mcp add -s user --transport http merget https://sema.merget.ai/mcp （也可以在 ~/.gemini/settings.json 中使用 "httpUrl"；如果不加 -s user，则会写入 项目的 .gemini/settings.json），再运行 /mcp auth merget 登录，并运行 npx -y skills add MergetAI/merget-plugin -a gemini-cli -g -y。

Replit Agent

一键配置：

https://replit.com/integrations?mcp=eyJkaXNwbGF5TmFtZSI6Ik1lcmdldCIsImJhc2VVcmwiOiJodHRwczovL3NlbWEubWVyZ2V0LmFpL21jcCJ9

Replit 会按项目将技能安装到 /.agents/skills，因此请在每个项目中运行 npx -y skills add MergetAI/merget-plugin -a replit -y，不要添加 -g。

claude.ai、Claude Desktop 和 ChatGPT

在 claude.ai 或 Claude Desktop 中：进入 Customize › Connectors，点击 + Add、Add custom connector；将名称设为 Merget，输入 https://sema.merget.ai/mcp，保留 Use Claude's published identity，点击 Add，然后点击 Connect。两个应用共用 一个连接器。在 ChatGPT 桌面应用中：进入 Settings › MCP servers， 点击 Add server，选择 Streamable HTTP，将名称设为 merget，输入 URL，点击 Save、 Restart，然后点击 Authenticate；它与 Codex CLI 共用 ~/.codex/config.toml， 因此运行 codex mcp logout merget，再点击 Authenticate 即可重新登录。网页版 ChatGPT 只能通过插件使用 远程 MCP 工具；通用目录列表之后会由 OpenAI 提供。

其他

• Amp：amp mcp add merget https://sema.merget.ai/mcp。
• Warp：Settings › Agents › MCP servers，或编辑 ~/.warp/.mcp.json。
• OpenCode：在 opencode.json 中配置 "mcp": { "merget": { "type": "remote", "url": "https://sema.merget.ai/mcp", "enabled": true } }，然后运行 opencode mcp auth merget。
• Cline、Zed、JetBrains Junie、Goose、Factory Droid 等： npx -y add-mcp https://sema.merget.ai/mcp -n merget -a <agent> -g -y （运行 add-mcp list-agents 可查看名称），然后运行 npx -y skills add MergetAI/merget-plugin -a <agent> -g -y；或者使用 JSON {"mcpServers":{"merget":{"type":"http","url":"https://sema.merget.ai/mcp"}}} 配置，具体位置取决于客户端存放服务器配置的位置。

使用 -g 安装会将文件写入主目录；沙盒环境中的 Agent 可能需要请求你批准。

无头和云端运行器

无法打开浏览器的运行器无法通过 OAuth 登录：Copilot 的云端编码 Agent（其服务器从 COPILOT_MCP_* 密钥中读取标头；不支持 OAuth）、Amp Orbs（不支持浏览器 OAuth；改为在 ampcode.com 上使用远程定义 amp mcp remote --personal add Merget https://sema.merget.ai/mcp，并在那里登录）、Warp 的 Oz 云端 Agent（通过 URL 指定服务器；可使用在 Oz Web 应用的 Integrations 下授权一次的托管 MCP 安装）、Kiro Web 的自定义服务器（URL 和标头；文档仅说明 Powers 支持 OAuth）以及 CI。对于这些运行器，Merget 即将提供 Agent 密钥。

登录

所有客户端的登录方式相同：客户端会在浏览器中打开 Merget 登录服务，你使用 Merget 账户及其第二重验证方式登录，取消勾选此 Agent 不应拥有的权限，选择组织，然后选择 Approve。无需复制令牌。Merget 控制面板中的文档 Connect coding agents 页面介绍了权限、授权页面、再次批准，以及页面显示 Merget doesn't recognize this application 或客户端报告 invalid_redirect_uri 时的处理方法。之后可在 Settings › Agents 下更改 Agent 的权限，无需重新登录。

更新

• Claude Code：运行 claude plugin update merget@merget-queue，或在 /plugin › Marketplaces 下为 merget-queue 开启自动更新。
• Codex：运行 codex plugin marketplace upgrade merget-queue。Copilot CLI：运行 copilot plugin update merget，或在 ~/.copilot/settings.json 的 extraKnownMarketplaces.merget-queue 条目中设置 "autoUpdate": true。VS Code：运行 /plugin update merget。Devin：运行 devin plugins update merget。Kiro：使用 Power 中的 Check for updates。
• 使用 npx skills 安装的技能不会自动更新：运行 npx -y skills update -g merget-setup merget-operate merget-pr merget-graph。

CHANGELOG 说明了各版本的更改。

开发

packaging/source.json 是插件名称、版本、描述和地址的唯一来源；node packaging/build.mjs 会据此生成所有清单：供 Claude Code 及读取其格式的客户端使用的 .claude-plugin/plugin.json、.claude-plugin/marketplace.json 和 .mcp.json；供 Agent Plugins 1.0（Codex、Cursor、VS Code、Copilot、Kiro）使用的 plugin.json 和 mcp.json；供 Antigravity 使用的 .antigravity-plugin/plugin.json 和 mcp_config.json；以及供 MCP Registry 使用的 server.json。技能位于 skills/<name>/ 下。

当清单不是最新版本、CHANGELOG 标题与版本不一致、某项技能不符合 Agent Skills 规则，或面向用户的文案写出了特定客户端的工具前缀时，node packaging/build.mjs --check 会报错；使用 --base <ref> 时，如果客户端读取的文件自 <ref> 以来发生了更改但版本未升级，也会报错。node packaging/build.mjs --validate 会根据固定在 packaging/schemas/ 中的架构检查生成的文件。 RELEASING.md 说明了如何发布新版本。