Gitkraken Mcp

GitKraken MCP サーバー

GitKraken MCP サーバーは、GitKraken を通じて Git の履歴、ブランチ、Issue、プルリクエスト、複数リポジトリのワークフローに接続し、AI アシスタントをコンテキストを理解する開発パートナーにします。GitHub、GitLab、Azure DevOps、Bitbucket、Jira など、GitKraken ソフトウェアスイートでおなじみのあらゆるプロバイダーに対応しています。初めてコントリビュートする開発者から Netflix や Adobe のエンタープライズチームまで、4,800 万人の開発者に選ばれた Git ツール GitLens を開発したチームが提供しています。

GitKraken MCP サーバーは macOS、Windows、Linux で利用でき、VS Code、Cursor、Windsurf、Claude Desktop、Kiro、JetBrains などで動作します。

MCP サーバーについて詳しく知りたい場合は、紹介ブログ記事をご覧ください。

目次

• ツール
• プロンプト
• インストール
• Docker
• トラブルシューティング
• サポート

ツール

ツールは MCP サーバーの主な目的です。コンテキストを膨張させずに AI が GitKraken とやり取りするために使える、厳選されたコマンドのセットです。ツールには issues_assigned_to_me、gitlens_commit_composer、pull_request_create_review などがあります。ツールの完全な一覧は、GitKraken ヘルプセンターのツールリファレンスをご覧ください。

このリポジトリには、Docker MCP Catalog に対応した tools.json も含まれています。Docker イメージに固定された GitKraken コアバージョンから更新するには、次を実行します。

npm run generate:tools

ジェネレーターはツールを一覧表示する前にイメージをビルドするため、Docker が利用可能である必要があります。既存のイメージを使うには TOOLS_COMMAND に JSON コマンド配列を設定するか、特定のローカル実行ファイルから生成するには GK_BIN を明示的に設定します。ジェネレーターは、MCP エージェントが呼び出してはならないアプリ専用のツールを意図的に除外します。

プロンプト

プロンプトは MCP サーバーの副次的な目的です。AI がツールの使い方、使うタイミング、使用時に提供すべき情報を理解するために利用できる、慎重に作成された指示のセットです。プロンプトの完全な一覧は、GitKraken ヘルプセンターのプロンプトリファレンスをご覧ください。

インストール

MCP サーバーのインストール方法はいくつかあります。どの方法を選んでも、MCP サーバーと連携するよう AI ツールを設定する必要がある場合があります。手順については、ヘルプセンターのMCP 入門ガイドをご覧ください。

GitLens

GitLens は、MCP サーバーをインストールする最も簡単な方法です。対応 IDE（VS Code、Cursor など）に GitLens をダウンロードしてインストールするだけで、MCP サーバーも一緒にインストールされます。GitLens をインストールすれば、すぐにツールを使い始められます。

NPM

npm を使って MCP サーバーをインストールし、利用することもできます。npm レジストリのパッケージをご覧ください。

インストール手順の詳細は AI ツールによって異なる場合がありますが、基本的には MCP サーバーの JSON 設定を次のような内容に置き換えます。

{
  "mcpServers": {
    "GitKraken": {
      "args": ["@gitkraken/gk", "mcp"],
      "command": "npx",
      "type": "stdio"
    }
  }
}

Docker

このリポジトリには、ローカル MCP サーバー向けの認証に依存しない Docker パッケージが含まれています。このイメージでは、ツールを一覧表示したり、明示的にマウントしたリポジトリに対してローカルの Git ツールを実行したりできます。クラウドワークスペース、イシュー、プルリクエスト、プロバイダーの操作には、引き続き、サポート対象の非対話型 GitKraken 認証方式が必要です。

イメージをビルドします。

docker build -t gitkraken-mcp:local .

認証せずにツールを一覧表示します。

docker run --rm gitkraken-mcp:local --list-tools

クリーンなイメージに対して tools.json を確認します。

npm install
TOOLS_COMMAND='["docker","run","--rm","gitkraken-mcp:local","--list-tools"]' npm run check:tools

イメージはデフォルトで、組み込みの非 root ユーザー node（UID/GID 1000:1000）として、stdio 経由で gk mcp を起動します。ネイティブ Linux では、バインドマウントによってホストの所有権が維持されます。マウントしたリポジトリが別の UID に属している場合、読み取り操作は成功しても、書き込み操作は permission denied、unable to create '.git/index.lock'、または同様の Git エラーで失敗することがあります。

Docker MCP Toolkit では、オプションの container_user 設定に、ホストの数値 UID または UID:GID を指定します。次のコマンドで値を取得できます。

id -u
id -g

たとえば、1001 または 1001:1001 を使用します。イメージのデフォルトを維持するには、container_user を空のままにします。通常のセットアップでは root を使用したり、リポジトリのアクセス許可を広げたりせず、マウントしたリポジトリをすでに所有している、または書き込み可能な数値 ID を指定してください。サーバー全体に適用される ID は 1 つだけなので、設定したすべてのリポジトリパスに、同じ UID と GID でアクセスできる必要があります。

サーバーによる読み取りと変更を許可するリポジトリパスのみをマウントしてください。リンクされた Git ワークツリーを使用する場合は、.git ファイルで参照される外部 Git ディレクトリへのアクセスも必要です。カタログのドラフトエントリーは、docker/catalog/server.yaml.template で確認できます。カタログのプルリクエストを準備するときは、docker/mcp-registry のチェックアウト内にある servers/gitkraken/ に、そのテンプレートと tools.json をコピーしてください。

CLI

macOS

gk は、次のコマンドで Homebrew からインストールできます。

Homebrew：

brew install gitkraken-cli

または、リリースページからダウンロードし、バイナリフォルダーに追加します。

mv ~/Downloads/gk /usr/local/bin/gk

---

Linux / Ubuntu

gk は、リリースページからダウンロードできるバイナリとして提供されています。ダウンロードしたら、バイナリフォルダーに追加します。

mv ~/Downloads/gk /usr/local/bin/gk

または、新しいディレクトリを作成してバイナリを移動し、$PATH に追加します。

mkdir "$HOME/cli"
mv ~/Downloads/gk "$HOME/cli"
export PATH="$HOME/gk:$PATH"

対応するパッケージ（.deb、.rpm）を[ダウンロード][releases page]して、次のコマンドでインストールすることもできます。

sudo apt install ./gk.deb

または

sudo rpm -i ./gk.rpm

---

Windows

gk は、次のコマンドで [Winget][winget] からインストールできます。

winget install gitkraken.cli

トラブルシューティング

Oh-My-Zsh での gk

gitkraken-cli をインストールしていて、Oh-My-Zsh を使用している場合、簡単なエイリアスの問題が発生することがあります。Oh-My-Zsh ではデフォルトで gitk が gk としてエイリアス設定されているため、問題が起きることがあります。修正するには、ターミナルで次のように入力します。

unalias gk

サポート

問題が発生した場合は、ヘルプセンターで解決方法が紹介されていないか、まずご確認ください。

GitHub でフィードバックを送ったり、バグを報告したりするには、イシューを送信してください。

サポートに直接問い合わせる場合は、チケットを送信してください。