GitLab MCP Server

AIアシスタントをGitLabに接続して、マージリクエストのレビュー、パイプラインのトリアージ、イシューの管理、リリースの作成を、すべて自然言語で行えるようにしましょう。 静的バイナリ1つ（またはコンテナ）で、1000以上のGitLabツールをREST + GraphQL API全体にわたって提供し、Claude、Cursor、VS Code、およびあらゆるMCPクライアントで動作します。

あなたがAIアシスタントに話しかけるだけで、GitLabの作業はAIアシスタントが行います。プロジェクトID、APIエンドポイント、JSONを覚える必要はありません。

「マージリクエスト !15 をレビューして — マージしても安全？」 · 「最後のパイプラインはなぜ失敗した？」 · 「自分に割り当てられたオープンなイシューを一覧して」 · 「v1.0 から v2.0 のリリースノートを作成して」

🤖 AIアシスタントを利用中ですか？ このリポジトリURLを渡して、お使いのクライアントにサーバーをインストールするよう依頼してください。モデルがヘッドレスで実行するために必要なものすべて（クライアントごとの宣言的設定、claude mcp add のワンライナー、デフォルト値）は llms.txt にあります（対話型ウィザードは不要です）。

60秒でインストール

いずれか1つを選んでください。どの方法でも、最後にあなたがアシスタントへプロンプトを入力するところまで進みます。

ワンクリックインストール

各ボタンはDockerベースのサーバーを登録します（初回実行時にイメージを自動プルします。インストールにはDockerが必要です）。Claude Desktopの行は、代わりにネイティブの.mcpbデスクトップ拡張機能をダウンロードします（macOSユニバーサル + Windows、Docker不要）。Claude Desktopで開いて設定を入力してください。トークンが必要ですか？ api スコープで個人アクセストークンを作成してください。セルフマネージドGitLabの場合？ インストール後、お使いのクライアントのMCP設定にGITLAB_URL環境変数を追加してください。

Claude Code（claude mcp add）

Docker（インストール不要 — 初回実行時にイメージをプルします）：

claude mcp add gitlab --env GITLAB_TOKEN=glpat-xxxx --transport stdio \
  -- docker run -i --rm -e GITLAB_TOKEN ghcr.io/jmrplens/gitlab-mcp-server:latest --http=false

または、ネイティブバイナリを先にインストールしてから登録します：

# macOS/Linux (Homebrew)
brew install jmrplens/tap/gitlab-mcp-server
# Linux/macOS (script)
curl -fsSL https://raw.githubusercontent.com/jmrplens/gitlab-mcp-server/main/scripts/install.sh | sh
# Windows (winget)
winget install --id jmrplens.gitlab-mcp-server -e
# Windows (PowerShell)
irm https://raw.githubusercontent.com/jmrplens/gitlab-mcp-server/main/scripts/install.ps1 | iex

claude mcp add gitlab --env GITLAB_TOKEN=glpat-xxxx -- gitlab-mcp-server

セルフマネージドGitLabの場合？ --env GITLAB_URL=https://gitlab.example.com を追加してください（自己署名証明書の場合は --env GITLAB_SKIP_TLS_VERIFY=true も追加）。

ガイド付きセットアップ（どのクライアントでも、フラグを覚える必要なし）

バイナリにはセットアップウィザードが同梱されており、GitLabトークンを収集してMCPクライアントを設定してくれます。JSONを編集したくない場合に最適です：

gitlab-mcp-server --setup

VS Code、Claude Desktop、Claude Code、Cursor、Windsurfを自動検出して、正しい設定を書き込みます。Windowsでは、.exe をダブルクリックして起動します。

手動JSON（Claude Desktop、Cursor、VS Codeなど）

ネイティブバイナリ（Claude Desktopの mcpServers、Cursorなど）：

{
  "mcpServers": {
    "gitlab": {
      "command": "/path/to/gitlab-mcp-server",
      "env": { "GITLAB_TOKEN": "glpat-xxxxxxxxxxxxxxxxxxxx" }
    }
  }
}

VS Code（.vscode/mcp.json、servers + type に注意）：

{
  "servers": {
    "gitlab": {
      "type": "stdio",
      "command": "/path/to/gitlab-mcp-server",
      "env": { "GITLAB_TOKEN": "glpat-xxxxxxxxxxxxxxxxxxxx" }
    }
  }
}

Docker版 — "command"/"args" を次に置き換えます：

"command": "docker",
"args": ["run", "-i", "--rm", "-e", "GITLAB_TOKEN", "ghcr.io/jmrplens/gitlab-mcp-server:latest", "--http=false"]

Cline（VS Code）— Clineサイドバー → MCPサーバーアイコン → グローバルMCPを編集 を開くか、設定ファイルを直接編集します：

• macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

• Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

• Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

Clineは上記のネイティブバイナリ用の mcpServers 形式を使用します。

ユーザーごとのstdioではなく、共有の常時稼働HTTPデプロイメントについては、HTTPサーバーモードを参照してください。

何もインストールせずに試す（ホスト型エンドポイント）

公開インスタンスが https://mcp.jmrp.io/gitlab で稼働しています。インストール不要、必要なのは自分のGitLabトークンだけです。HTTP対応のMCPクライアントからこのURLに向けるだけです：

{
  "mcpServers": {
    "gitlab": {
      "type": "http",
      "url": "https://mcp.jmrp.io/gitlab",
      "headers": { "PRIVATE-TOKEN": "glpat-xxxxxxxxxxxx" }
    }
  }
}

PRIVATE-TOKEN は必須で、リクエストごとに送信されます。サーバーに保存されることはありません。GITLAB-URL はオプションで、デフォルトは https://gitlab.com です。別のインスタンスに接続するにはこれを設定してください（そのインスタンスはパブリックインターネットから到達可能である必要があります）。

これはサーバーを試す最も速い方法ですが、使い続けるための正しい方法は依然としてローカル（上記のいずれかのオプション）です。これは免責事項ではなく、具体的な理由があります：あなたのトークンとすべてのリクエストは、他人のマシンを経由します。 ローカルで実行すれば、認証情報とGitLabトラフィックが自分のコンピュータから出ることはありません。そのため、プライベートなセルフマネージドインスタンスでは唯一の合理的な選択肢でもあります。

このエンドポイントは、デフォルトの dynamic サーフェス上で動作するステートレスなストリーミングHTTPです。POST がトランスポートで、GET は設計上 405 を返します。また https://mcp.jmrp.io/gitlab/health は 200 と {"status":"ok",…} を返します。セルフホストのHTTPデプロイメントでは、--auth-mode=oauth --gitlab-url=https://gitlab.com --public-url=https://mcp.example.com を指定して実行することもできます（両方とも必須です。OAuthには固定インスタンスと、RFC 9728がリソースを識別するための外部から到達可能なオリジンが必要です）。その場合、クライアントはそのメタデータを介してGitLabを認可サーバーとして検出し、トークンをコピーする代わりにブラウザで認可します — OAuthアプリのセットアップ を参照してください。これは私が保守しているMCPサーバーのディレクトリである mcp.jmrp.io に掲載されているサーバーの1つで、それぞれが独自のエンドポイントでアクセスできます。https://mcp.jmrp.io/servers.json は、自動化クライアント向けの同じリストです。

あとは聞くだけ： AIクライアントを開いて 「自分のGitLabプロジェクトを一覧表示して」 と試してみてください。クライアント別の詳細はスタートガイドを、その他のプロンプト例はこちらを参照してください。

Related MCP server: mcp-gitlab-jira

なぜこのサーバーなのか

• 平易な言葉で使えるGitLab。 AI が「MR !15 はマージしても安全ですか?」を適切な API 呼び出しに変換します。エンドポイント、ID、JSON に触れる必要はありません。

• プラットフォーム全体 — 1000以上のツール。 GitLab REST v4 + GraphQL を広範にカバー: プロジェクト、ブランチ、タグ、リリース、マージリクエスト、イシュー、パイプライン、ジョブ、グループ、ユーザー、Wiki、環境、デプロイ、パッケージ、コンテナレジストリ、ランナー、フィーチャーフラグ、CI/CD 変数、セキュリティ、管理、トークンなど。

• デフォルトで低トークン。 デフォルトのダイナミックサーフェスは、全カタログに到達しつつ、ツールを2つだけ（find + execute）公開します — そのため、どのクライアントのコンテキストウィンドウにも収まります。（トークンフットプリント →）

• 実モデルで実証済み。 自動評価器が Anthropic、Google、OpenAI、Qwen を実際の GitLab インスタンスに対して実行します。数千のオペレーションにわたり総合成功率 99.5%。（結果 →）

• 設計による安全性。 読み取り専用モード、セーフモード（すべてのミューテーションをドライランでプレビュー）、セルフホスト型 GitLab 向けの TLS オプション、そして継続的な SonarCloud 品質/セキュリティゲート。

• どこでも実行可能。 単一の静的バイナリまたはコンテナ。Windows、Linux & macOS。amd64 & arm64。stdio（デスクトップ）と HTTP（リモート）。

• 45のMCPリソース（読み取り専用データ: プロジェクト、イシュー、パイプライン、MR、ブランチ、メンバー、サーフェス対応の gitlab://tools マニフェスト、ワークフローのベストプラクティスガイド）。26種類の単一オブジェクトもサブスクライブ可能です。

• 37のMCPプロンプト（コードレビュー、パイプラインステータス、リスク評価、リリースノート、スタンドアップ、アナリティクス、監査など）。

• 4つのエリシテーションウィザード（対話型のイシュー/MR/リリース/プロジェクト作成）。

• 4つのMCPキャパビリティ（コンプリーション、プログレス、エリシテーション、リソースサブスクリプション — ライブの resources/updated 通知（ポーリングで対応））と、MCPクライアントで視覚的に識別するための51のツールアイコン（50のドメインアイコンとプロジェクトマーク）。

• ページネーション — すべてのリストエンドポイントで、完全なメタデータ付き。

ツールサーフェス

サーバーは、TOOL_SURFACE によって制御される3つの形態で GitLab を提示できます。デフォルトでは設定は不要です。

ツール数は GitLab エディション（GITLAB_TIER）に応じて拡大します。上位ティアほど多くのアクションが公開されます。ランキングモデル、安全ガード、完全なカタログについては、ダイナミックツールセットとメタツールリファレンスを参照してください。リソースがコンテキストの大部分を占めるダイナミック実行では、CAPABILITY_SURFACE=minimal を設定してください。

トークンフットプリント

現在のカタログに対して、go run ./cmd/audit_tokens/ -footprint で測定しました。合計値は、MCP クライアントから見える起動時コンテキスト、つまり表示されるツールスキーマと共有リソース・プロンプトを、cl100k_base トークナイザー（GPT-4/GPT-3.5 エンコーディング）を使用して推定したものです。完全なマトリクス（メタサーフェスと個別サーフェス、すべての META_PARAM_SCHEMA モード）については、トークンフットプリントリファレンスを参照してください。

デフォルト設定: TOOL_SURFACE が未設定または TOOL_SURFACE=dynamic、CAPABILITY_SURFACE=full、META_TOOLS 未設定、META_PARAM_SCHEMA=opaque、GITLAB_TIER 未設定（自動検出、フォールバックは free）の場合、サーバーは**ダイナミック find/execute サーフェス

ドキュメント

完全なドキュメントは jmrp.io/docs/gitlab-mcp-server にあります。特定の領域に関する信頼できるリファレンスとして、このマップを使用してください:

FAQ

はい。GITLAB_URL にインスタンスのURLを設定してください。GITLAB_URL を省略した場合、stdioモードは https://gitlab.com を使用します。自己署名TLS証明書は GITLAB_SKIP_TLS_VERIFY=true でサポートされています。

自分で実行する場合 — ローカルでstdio経由、または自社インフラでHTTP経由 — すべてのAPI呼び出しはGitLabインスタンスに直接送信されます。他のどこかに送信される唯一のリクエストは、GitHub Releasesに対する更新チェックです。これはデフォルトで有効になっており、AUTO_UPDATE=false で無効にできます。

例外はホスト型エンドポイントです: https://mcp.jmrp.io/gitlab を使用すると、トークンとすべてのリクエストがそのマシンを経由します。そこには何も保存されませんが、他人のサーバーであるため、ホスト型セクションではローカルで使い続けるよう記載されています。

更新チェックが送信する正確な内容についてはPRIVACY.mdを、セキュリティモデルについてはSECURITY.mdを参照してください。

はい。GITLAB_READ_ONLY=true を設定すると、すべての変更系ツール(作成、更新、削除)が無効になります。読み取り操作のみが利用可能になります。

または、GITLAB_SAFE_MODE=true を設定するとドライランモードになります: 変更系ツールは表示されたままですが、実行せずに構造化されたJSONプレビューを返します。監査、トレーニング、AIアシスタントが行う操作のレビューに役立ちます。

Community Edition (CE) と Enterprise Edition (EE) の両方に対応しています。stdioモードで GITLAB_TIER=premium または GITLAB_TIER=ultimate を設定すると、Premium/Ultimate機能(DORAメトリクス、脆弱性、コンプライアンスなど)向けの追加ツールが有効になります。未設定の場合は、インスタンスのライセンスからティアを検出します(フォールバックは free)。HTTPモードでは、--tier でティアを強制できます。それ以外の場合は、ライセンスからトークン+URLプールのエントリごとに検出されます。

サーバーには、GitLab APIのレート制限に対するバックオフ付きリトライロジックが含まれています。エラーは一時的(再試行可能)または永続的に分類され、エラーメッセージには実行可能なヒントが含まれます。

MCP互換のクライアントであればすべて対応しています: VS Code + GitHub Copilot、Claude Desktop、Cursor、Claude Code、Windsurf、JetBrains IDEs、Zed、Kiro、その他。内蔵のセットアップウィザードは、ほとんどのクライアントを自動設定できます。

ソースからのビルド

git clone https://github.com/jmrplens/gitlab-mcp-server.git
cd gitlab-mcp-server
make build

公開されているコンテナイメージは ghcr.io/jmrplens/gitlab-mcp-server:latest です。クロスコンパイル、Docker Compose、コントリビューションガイドラインについては、開発ガイドを参照してください。

プライバシーポリシー

サーバーは完全にあなたのマシン上で動作し、テレメトリ、アナリティクス、独自のバックエンドは一切ありません。データは、設定したMCPクライアントとGitLabインスタンスの間でのみ流れます(さらに、GitHub Releasesに対するオプションの署名付きバイナリ更新チェックがあります)。トークンはGitLabリクエストの認証にのみ使用され、ログに記録されることはありません。詳細: PRIVACY.md。

コントリビューションとセキュリティ

• コントリビューション: 開発ガイドライン、ブランチ命名規則、コミット規約、PRプロセスについては CONTRIBUTING.md を参照してください。

• セキュリティ: セキュリティポリシーと脆弱性の報告については SECURITY.md を参照してください。

• 行動規範: CODE_OF_CONDUCT.md (Contributor Covenant v2.1) を参照してください。

リポジトリミラー: GitHubが正規のリポジトリです。見つけやすくするため、読み取り専用ミラーが GitLab.com にあります。コントリビューションはGitHubで行ってください。

ファイル数

関数

注目すべき比率

コードパターン

プロジェクト

殿堂入り

だって、いいじゃないか

José M. Requena Plens によってメンテナンスされています · プロジェクトページ · ホスト型インスタンス: mcp.jmrp.io/gitlab