Merget

Merget

Merget は GitHub 向けのセマンティックマージキューです。各プルリクエストについて、マージに関わるツリーのコードプロパティグラフを構築し、ブランチを統合したときに発生する問題（解決できなくなる参照、双方で変更された内容の相互作用、テキスト上の競合）を特定し、概要を作成してマージの順序を決定します。リポジトリで許可されている場合は、各プルリクエストをマージ先のコードに対して準備し、マージします。GitHub App として、また sema.merget.ai のサービスとして動作します。

このリポジトリは、Merget のコーディングエージェント向けプラグインです。エージェントを Merget の MCP サーバー https://sema.merget.ai/mcp に接続する単一のパッケージで、4 つのスキルを提供します。

• merget-setup — 初回実行時に、組織の状況、GitHub を接続するページ、最初のリポジトリとその自動化モードを確認します。
• merget-operate — オーナーが行う手順を除き、ダッシュボード上で Merget を運用します。設定、マージキュー、失敗したバッチ、競合、実行、シークレットが対象です。
• merget-pr — プルリクエストの検出結果、判定、概要、キュー内の位置、適用状態、クレジットを確認します。
• merget-graph — 任意のコミットのコードプロパティグラフに対する型付きクエリを実行します。シンボル、呼び出し元、呼び出し先、定義と使用の連鎖、スライス、グラフの差分を扱います。

サーバーにはエージェントが把握しておくべき内容（ツールの説明、プロンプト、指示）が含まれ、スキルがより詳しい情報を提供します。エージェントはサインイン時に付与した権限の範囲で、あなたとして動作し、組織のオーナーとして動作することはありません。オーナーが行う手順とブラウザー上の手順は、Merget のダッシュボードで人が行います。

1 つのプロンプトでセットアップ

まず Merget アカウントと組織が必要です。sema.merget.ai で登録してください。その後、次の内容をエージェントに貼り付けます。

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

エージェントはこのプラグインをインストールするか（プラグインに対応していないエージェントの場合は、サーバーとスキルを登録し）、サインインして、Merget のセットアップを一緒に進めます。シェルを使えないエージェントの場合は、代わりにコマンドが提示されます。サインイン、エージェントの承認、GitHub の接続（オーナーが行う手順）は、ブラウザー上であなたが行います。

インストール

プラグイン ID は merget@merget-queue で、このリポジトリのマーケットプレイスからインストールできます。サーバーは https://sema.merget.ai/mcp です。クライアントごとにいずれか1つの方法を選んでください。プラグインにはサーバーとスキルがまとめて含まれているため、インストールしたエージェントは、サーバーを手動で追加したり npx skills を実行したりする必要はありません。同じアドレスのプラグインと手動で追加したサーバーを併用すると、エージェントに同じツールが二重に表示されます（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

または、マーケットプレイスとプラグインを ~/.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 をレガシー互換マーケットプレイスとして読み込みます。以下の 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 のクラウドコーディングエージェントでは、リポジトリの 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 では、Customize のマーケットプレイスからエージェントプラグインをインストールできます。チーム管理者は Dashboard › Plugins & MCPs › Add Marketplace › Import from Repo から、このリポジトリを追加します。CLI では、agent mcp login merget を実行してサインインします。クラウドエージェントは、そのページにあるチームのサーバーを使用し、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

ルートの plugin.json、mcp.json、skills/ を読み込む Power として追加するには、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 and Gemini CLI

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

agy plugin list を実行すると、4 つのスキルと 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 をクリックします。1 つのコネクターを両方のアプリで使用できます。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 を指定してインストールするとホームディレクトリに書き込まれるため、サンドボックス内のエージェントから承認を求められる場合があります。

ヘッドレス環境とクラウドランナー

ブラウザーを開けないランナーは、OAuth でサインインできません。該当するのは、Copilot のクラウドコーディングエージェント（サーバーは COPILOT_MCP_* シークレットからヘッダーを受け取ります。OAuth はサポートされていません）、Amp Orbs（ブラウザーを使った OAuth はできません。代わりに、ampcode.com 上のリモート定義 amp mcp remote --personal add Merget https://sema.merget.ai/mcp でサインインします）、URL で指定するサーバーを使う Warp の Oz クラウドエージェント（Oz ウェブアプリの Integrations で一度認証するマネージド MCP インストールなら動作します）、Kiro Web のカスタムサーバー（URL とヘッダーを使用します。OAuth が記載されているのは Powers のみです）、CI です。これらに向けた Merget のエージェントキーは近日提供予定です。

サインイン

すべてのクライアントでサインイン方法は同じです。ブラウザーで Merget のサインインサービスを開き、Merget アカウントとその第 2 要素でサインインします。このエージェントに不要な権限のチェックを外し、組織を選択して Approve を選びます。コピーするトークンはありません。Merget のダッシュボードにあるドキュメントの Connect coding agents ページでは、権限、同意ページ、再承認の方法、およびページに Merget doesn't recognize this application と表示された場合や、クライアントが invalid_redirect_uri を報告した場合の対処方法を説明しています。エージェントの権限は、再サインインせずに Settings › Agents から後で変更できます。

更新

• 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>/ の下にあります。

node packaging/build.mjs --check は、マニフェストが最新でない場合、CHANGELOG の見出しとバージョンが一致しない場合、スキルが Agent Skills のルールに違反している場合、またはユーザー向けの文言にクライアント固有のツールプレフィックスが含まれている場合に失敗します。--base <ref> を指定すると、バージョンを上げずにクライアントが読み込むファイルが <ref> 以降に変更された場合も失敗します。node packaging/build.mjs --validate は、生成されたファイルを packaging/schemas/ に固定されているスキーマと照合します。 RELEASING.md では、バージョンのリリース方法を説明しています。