LaunchDarklyのMCPサーバーをClaude Codeで使う手順
LaunchDarklyのMCPサーバーをClaude Codeに接続する手順です。claude mcp addでの登録、OAuth権限、hostedとlocalサーバーの違いを扱います。
LaunchDarklyのMCPサーバーとは
LaunchDarklyのMCP(Model Context Protocol)サーバーは、フィーチャーフラグの操作を自然言語でAIクライアントから行うための公式サーバーです。Claude CodeやCursorなどMCP対応クライアントから接続すると、フラグの作成・更新・削除をチャットの指示だけで実行できます。
提供範囲はフィーチャーフラグ管理だけではありません。AgentControlの設定管理と、ログ・トレース・エラー・ダッシュボードを扱うobservability(可観測性)データへのアクセスも、同じMCPサーバー経由でカバーします。LaunchDarklyはこのサーバーをhosted(ホスト型)で提供しており、通常の商用アカウントはインストール作業なしでURLに接続するだけで使えます。
利用には、MCPに対応したAIクライアントが必要です。LaunchDarklyが公式に例として挙げているのは、Claude Code・Cursor・GitHub Copilotを組み込んだVS Code・Windsurfの4つで、いずれもストリーミング対応のHTTPトランスポート(streamableHttp)でサーバーに接続します。
接続後は「defaultプロジェクトにexample featureというフラグを作成して」「example featureフラグを全環境でONにして」のような指示がそのまま通ります。ターゲティングルールの変更や、直近24時間のエラーグループの確認も同様に自然言語で依頼できます。
Claude Codeへの接続手順
LaunchDarklyのMCPサーバーは、Claude CodeのCLIコマンド1つで登録できます。設定ファイルを手書きする必要はありません。
claude mcp add --transport http "launchdarkly" \
"https://mcp.launchdarkly.com/mcp/launchdarkly"このコマンドはHTTPトランスポートでサーバーを登録するだけで、認証はまだ完了していません。Claude Codeのセッション内で /mcp を実行し、LaunchDarklyのOAuth同意画面を通じて認証を完了させます。
CLI以外の経路として、LaunchDarklyはインストールページも用意しています。対応するAIクライアントを選ぶとプロンプトに従って接続できる仕組みで、CLIでの手動設定を避けたい場合の代替手段です。ページ上で選択できるクライアントの一覧は、LaunchDarkly側の実装に依存します。
過去にnpxベースのローカルサーバー(@launchdarkly/mcp-server)を--api-key付きで設定していた場合は、hostedサーバーへの移行が必要です。既存の設定を削除し、上記のURL登録に置き換えると、認証はAPIキーからOAuthへ切り替わります。
OAuth認証に必要な権限
OAuth認証を完了させても、権限不足だと操作は失敗します。MCPサーバーはフラグとAgentControl設定の作成・読み取り・更新・削除にアクセスするため、認証に使うLaunchDarklyアカウントには十分な権限が必要です。
LaunchDarklyが推奨するのは、Writerのbase role(基本ロール)、LaunchDarkly Developerのpreset role(プリセットロール)、またはこれらと同等のアクセス権を持つロールです。カスタムロールを使っている場合は、接続先のプロジェクトと環境へのアクセスがロールに含まれているかを確認します。
OAuth同意画面を通過した直後に403エラーが出るケースは、OAuth自体の失敗ではなく権限不足が原因であることがほとんどです。解決手順は次の順です。
- 認証に使ったアカウントの権限を確認する(Writer / LaunchDarkly Developer / 同等のカスタムロール)
- カスタムロールなら対象のプロジェクト・環境へのアクセスが含まれるか確認する
- サーバーを一度切断し、OAuthフローをやり直す
- Claude Codeでは追加操作は不要(Cursorなど一部クライアントは再接続ボタンの操作が必要)
これらを確認しても403が解消しない場合は、LaunchDarklyサポートへの問い合わせが必要になります。
使えるツールとエージェントスキル
hostedサーバーが公開するMCPツールは、フィーチャーフラグ管理・AgentControl・observability・メトリクスの4領域に絞り込まれています。個々のツール名を含む完全な一覧は、MCPサーバーのページの「Available Tools」セクションか、接続先クライアントのツール一覧画面(Claude Codeなら/mcp)で確認できます。
単発のツール呼び出しでは対応しきれない複雑な手順には、LaunchDarklyが公開するagent skillsを組み合わせます。これはagentskills.ioが定めるオープン標準に沿ったスキル集で、Claude Code・Cursor・VS Code・Windsurf・Codexなど、標準に対応するエディタで共通に動きます。
npx skills add launchdarkly/agent-skillsスキルとMCPツールの役割は異なります。MCPツールはLaunchDarklyのリソースを直接操作する手段そのもので、スキルは複数のツール呼び出しを正しい順番で実行させるための手順書です。例えば「old-checkoutフラグを片付けて」と指示すると、launchdarkly-flag-cleanupスキルは次の順でエージェントを導きます。
- 全環境でのフラグの状態をMCPツールで確認する
- 削除の安全性を
safe・caution・not-readyのいずれかで判定する - コード内でそのフラグが参照されている箇所を確認する
- 安全と判定された場合のみ、コードを固定してプルリクエストを作成する
スキルを使わない場合、エージェントは正しいツールを呼べても順序を誤ったり、コード参照の確認を飛ばしたりする可能性があります。スキルはこの手順を毎回同じ形で踏ませるための土台です。エージェント自体の実行環境をどう組むかについては、Agent Skillsとは何かで全体像を扱っています。
hostedサーバーとlocalサーバーの使い分け
LaunchDarklyのMCPサーバーには2種類あり、選ぶべきものはアカウントが所属する環境で決まります。federal(連邦)環境とEU環境のアカウントはhostedサーバーを使えないため、自己管理型のlocalサーバーが唯一の選択肢です。
| 項目 | hostedサーバー | localサーバー(自己管理) |
|---|---|---|
| 対象環境 | hostedサーバーcommercial(デフォルト) | localサーバー(自己管理)federal / EU |
| 認証方式 | hostedサーバーOAuth | localサーバー(自己管理)APIキー(--api-key) |
| 提供範囲 | hostedサーバーフラグ管理・AgentControl・observability | localサーバー(自己管理)フラグ管理・AiConfigs・監査ログ・コード参照・環境一覧 |
| 導入方法 | hostedサーバーURL登録のみ | localサーバー(自己管理)npx / バイナリ / Docker / ローカルクローン |
| 更新頻度 | hostedサーバー高い(LaunchDarkly推奨) | localサーバー(自己管理)hostedより低い |
localサーバーはnpx --package @launchdarkly/mcp-serverで起動するほか、スタンドアロンバイナリやDockerイメージ、ローカルクローンからの起動にも対応しています。スタンドアロンバイナリはGitHub Releasesから対象プラットフォーム向けの実行ファイルを直接取得する方式で、Dockerの場合はAWS Marketplaceで配布されるイメージをコンテナとして起動します。
localサーバーが公開する操作の範囲は表の「提供範囲」よりもう少し細かく分かれています。フィーチャーフラグ本体の一覧取得・作成・更新・削除に加えて、AiConfigs(LLM向けプロンプト設定のターゲティング管理)のターゲティング取得・更新・作成・削除、監査ログの一覧取得、コードでフラグが参照されているリポジトリの一覧取得、プロジェクトに紐づく環境の一覧取得までが操作対象です。commercial環境のアカウントでも、LaunchDarklyはhostedサーバーが利用可能な場合は常にそちらを使うよう案内しています。
よくあるつまずき
federal・EUアカウントでhostedのURLに接続しようとすると、そもそも接続対象が存在しません。この場合は--server-url引数でlocalサーバーに環境ごとのURL(federalならhttps://app.launchdarkly.us、EUならhttps://app.eu.launchdarkly.com)を指定して起動します。
localサーバーをnpxで起動する構成では、--api-keyにAPIキーを直書きする設定例がドキュメントに載っています。共有リポジトリにコミットする設定ファイルへの直書きは避け、環境変数経由での参照に切り替えるのが安全です。一部のAIクライアントは設定ファイル内での環境変数展開に対応していないため、対応状況をクライアント側のドキュメントで確認します。
hostedサーバーへの移行時に古いローカル設定を消し忘れると、同名のサーバーが2つ登録された状態になり、どちらが呼ばれているか分かりにくくなります。移行時は古いnpxベースの設定を削除してから新しいURL登録を追加する順序を守ります。
まとめ
LaunchDarklyのMCPサーバーは、commercial環境ならhostedサーバーへのURL登録とOAuth認証だけで使い始められます。Claude Codeでの登録はclaude mcp add --transport httpコマンド1つで完結し、認証には最低でもWriterのbase roleに相当する権限が必要です。
federal・EU環境や、旧来のAPIキー方式を使い続ける事情がある場合は、自己管理型のlocalサーバーが選択肢になります。複雑なフラグ操作の手順を安定させたい場合は、MCPツールに加えてagent skillsを組み合わせる構成が有効です。MCPサーバーをゼロから自作する場合の手順はMCPサーバー自作ガイド、CursorでのMCP設定の詳細はCursor MCP設定ガイド、同様のSaaS連携パターンはFigma MCPサーバーの使い方で扱っています。