チュートリアル: Claude DesktopをGitLab MCPサーバーに接続する

このGitLab Model Context Protocol（MCP）サーバーを使用すると、外部AIツールとアプリケーションをGitLabのインスタンスに接続できます。このチュートリアルでは、GitLab MCPサーバーをClaude Desktopに接続するように設定します。Claude DesktopをMCPサーバーと正常に統合した後、ClaudeにGitLabのインスタンスにイシューを作成するよう指示します。

はじめる前

GitLab Duoとベータ版および実験的機能を有効にします。
オペレーティングシステム用のClaude Desktopをインストールします。
Node.jsバージョン20以降をインストールします。Node.jsがPATH環境変数にグローバルで利用可能であることを確認してください (which -a node)。
イシューを作成できるアクティブなプロジェクトが少なくとも1つあることを確認してください。

Claude DesktopをGitLab MCPサーバーに接続する

Claude Desktopを開きます。
設定ファイルを編集します。次のいずれかを実行します:
- Claude Desktopで、設定 > デベロッパー > Edit Configを選択します。
- お使いのファイルシステムで、claude_desktop_config.jsonに移動してファイルを開きます。例:
  - macOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json。
  - Windowsの場合: %APPDATA%\Claude\claude_desktop_config.json。
必要に応じて編集し、GitLab MCPサーバーに次のエントリを追加します:
- "command":パラメータの場合、npxがグローバルではなくローカルにインストールされている場合は、npxへのフルパスを指定してください。
- <gitlab.example.com>を以下に置き換えます:
  - GitLab Self-Managedでは、GitLabインスタンスのURL。
  - GitLab.comでは、GitLab.com。
```
{
  "mcpServers": {
    "GitLab": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://<gitlab.example.com>/api/v4/mcp"
      ]
    }
  }
}
```
設定を保存して、Claude Desktopを再起動します。
初回接続時、Claude DesktopはOAuth認証用のブラウザウィンドウを開きます。リクエストを確認して承認します。
Settings > Developerに移動し、新しいGitLab MCP設定を確認します。

ツール権限をカスタマイズする

MCPサーバーへの接続が正常に完了したら、GitLabのインスタンスとインタラクトする際にClaudeが使用できるツールをカスタマイズできます。たとえば、Claudeがイシューの作成やCI/CDパイプラインの管理のような特定のアクションを実行する前に、承認をリクエストするように設定できます。

Claudeでツール権限を表示するには:

左サイドバーで、Customize > Connectorsを選択します。
Desktopの下で、GitLabを選択します。
create_issueをNeeds approvalまたはAlways allowに設定します。

接続をテストする

Claude DesktopをMCPサーバーに正常に接続できたので、プロンプトで接続をテストします:

チャットのテキストボックスに次のように入力します:
```
Which MCP server version are you using?
```
Enterキーを押すか、送信を選択します。

Claudeは、インテグレーションの詳細とプロンプトに回答するために使用したツールとともに、サーバーのバージョンで応答するはずです。

プロジェクトにイシューを作成する

次に、Claudeにテストイシューを作成できる特定のプロジェクトを見つけるように依頼します。

チャットのテキストボックスに次のように入力します:
```
Can you find my project <project_name>?
```
<project_name>を自分のプロジェクトに置き換えます。
Enterキーを押すか、送信を選択します。
Claudeがプロジェクトを見つけたら、Claudeにプロジェクト内にイシューを作成するよう依頼します。チャットのテキストボックスに次のように入力します:
```
Can you create an issue in the project called "Test issue from MCP server", and give it the following description: "This is a test issue created by Claude Desktop and the GitLab MCP server."
```
Enterキーを押すか、送信を選択します。
create_issueをNeeds approvalに設定した場合、Claudeはイシューを作成する権限を求めます。Always allowを選択するか、ドロップダウンリストからAllow onceを選択します。

Claudeがイシューを作成すると、ブラウザでイシューにアクセスするためのURLを含む詳細情報が表示されます。