LaunchDarkly's Model Context Protocol (MCP) Server について
AI クライアントを LaunchDarkly に接続するセルフ管理型 MCP サーバーです。ホスト型サーバーに未対応の EU および Federal インスタンス向けに、フラグ、AI Config、実験、監査ログなどの操作を提供します。
主な機能
- 01フラグとターゲティングの管理
- 02AI Config の作成と更新
- 03実験の作成と確認
- 04メトリクスと環境の管理
- 05監査ログとリポジトリの参照
活用シーン
- 01環境ごとのフラグ状態の確認
- 02AI Config のターゲティング調整
- 03実験と監査データの確認
MCP 対応
MCP 対応 AI クライアントに LaunchDarkly のリソースと操作を公開します。ローカル導入と Docker 実行に対応し、API キーで認証します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
LaunchDarkly ローカル MCP サーバー
LaunchDarkly の連邦政府向け環境および欧州連合(EU)環境で利用できる、ローカルの Model Context Protocol(MCP) サーバーです。
重要
利用可能な場合は、LaunchDarkly の ホスト型 MCP サーバーを使用してください
LaunchDarkly は、利用可能な場合は ホスト型 MCP サーバーを使用することを強く推奨しています。ホスト型サーバーは、このセルフマネージドサーバーよりも機能が充実しており、更新頻度も高くなっています。
LaunchDarkly は、ホスト型 MCP にまだ対応していない LaunchDarkly の EU または Federal インスタンス向けに、このセルフマネージド MCP サーバーを提供しています。
目次
インストール
この MCP サーバーは、MCP プロトコルに対応した任意の AI クライアントにインストールできます。ここに記載されていない場合は、お使いの AI クライアントの手順を参照してください。
ランタイム要件
重要
eMudhra の一部の中間認証局が 2026 年 10 月に侵害されました(アドバイザリー)。ネットワーク上でそれらの鍵を持つ人物は、LaunchDarkly へのサーバー接続を傍受し、API アクセストークンを読み取る可能性があります。
- npx とローカルインストール: Node.js 22.23.4、24.22.1、26.12.1 以降を使用してください。これらのリリースでは、侵害された中間証明書が拒否されます。サーバーもそれらを拒否し、ランタイムが対応していない場合は起動時に警告を表示します。
- Docker: イメージ 0.7.1 以降を使用してください。これらは Node.js 24.22.1 で実行されます。0.7.0 以前は Node.js 24.2.0 で実行されます。
- スタンドアロンバイナリ: リリース v0.6.1 以前に添付されている
mcp-server-bun-*バイナリの使用を中止してください。侵害された中間証明書を拒否しない Bun ランタイムが組み込まれており、現在は公開されていません。修正済み Node.js を使った npx、または Docker に切り替えてください。
Cursor のインストール手順
プロジェクトのルートに .cursor/mcp.json ファイルを作成し、次の内容を記述します。
{
"mcpServers": {
"LaunchDarkly": {
"command": "npx",
"args": [
"-y", "--package", "@launchdarkly/mcp-server", "--", "mcp", "start",
"--api-key", "api-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
]
}
}
}
LaunchDarkly の Authorization ページに記載されている API キーを指定してください。
Claude のインストール手順
次のサーバー定義を claude_desktop_config.json ファイルに追加します。
{
"mcpServers": {
"LaunchDarkly": {
"command": "npx",
"args": [
"-y", "--package", "@launchdarkly/mcp-server", "--", "mcp", "start",
"--api-key", "api-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
]
}
}
}
LaunchDarkly の Authorization ページに記載されている API キーを指定してください。
Qodo Gen のインストール手順
- VSCode または IntelliJ で Qodo Gen のチャットパネルを開きます。
Connect more toolsをクリックします。+ Add new MCPをクリックします。- 次の設定を追加します。
{
"mcpServers": {
"LaunchDarkly": {
"command": "npx",
"args": [
"-y", "--package", "@launchdarkly/mcp-server", "--", "mcp", "start",
"--api-key", "api-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
]
}
}
}
LaunchDarkly の Authorization ページに記載されている API キーを指定してください。
Saveをクリックします。
GitHub Copilot CLI のインストール手順
Copilot CLI を使って、対話形式で MCP サーバーを追加します。
/mcp add
または、次の内容で ~/.copilot/mcp-config.json を作成/編集します。
{
"mcpServers": {
"LaunchDarkly": {
"command": "npx",
"args": [
"-y", "--package", "@launchdarkly/mcp-server", "--", "mcp", "start",
"--api-key", "api-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
]
}
}
}
LaunchDarkly の Authorization ページに記載されている API キーを指定してください。
詳細については、GitHub Copilot CLI のドキュメントを参照してください。
ローカルクローンからのインストール手順
このリポジトリをクローンして、MCP サーバーをローカルで実行することもできます。クローンしたら、依存関係をインストール(npm install)し、サーバーをビルド(npm run build)する必要があります。
その後、ローカルクローンを参照するようにサーバー定義を設定します。例:
{
"mcpServers": {
"launchdarkly": {
"command": "node",
"args": [
"/path/to/mcp-server/bin/mcp-server.js", "start",
"--api-key", "api-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
]
}
}
}
環境変数を使用したインストール手順
一部の AI クライアントでは、MCP の設定内で環境変数にアクセスできます。これに対応している AI クライアントでは、次のように MCP_LD_TOKEN などの環境変数から読み込むように MCP サーバーを設定できます。
{
"mcpServers": {
"launchdarkly": {
"command": "npx",
"args": [
"-y", "--package", "@launchdarkly/mcp-server", "--", "mcp", "start",
"--api-key", "$LD_ACCESS_TOKEN"
],
"env": {
"LD_ACCESS_TOKEN": "MCP_LD_TOKEN"
}
}
}
}
Docker を使用したインストール手順
AWS Markeplace から MCP サーバーをインストールする場合は、マーケットプレイスの掲載ページに記載されている手順に従い、認証済みのロールを使用してイメージをプルしてください。
コンテナを実行するには、次のようにします。
docker run --rm -p 127.0.0.1:8080:8080 709825985650.dkr.ecr.us-east-1.amazonaws.com/launchdarkly/mcp --api-key api-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --auth-token "$MCP_AUTH_TOKEN"
コンテナは 0.0.0.0 でリッスンするため、--auth-token(16 文字以上)が必要です。クライアントは /sse と /message で Authorization: Bearer <token> を送信する必要があります。Docker 外では、SSE トランスポートはデフォルトで 127.0.0.1 をリッスンします。変更するには --host を渡してください。ループバック以外のホストでは、その場合も --auth-token が必要です。
次に、実行中のコンテナを指すようにサーバー定義を設定します。例:
{
"mcpServers": {
"launchdarkly": {
"url": "http://localhost:8080/sse",
"headers": {
"Authorization": "Bearer <your --auth-token value>"
}
}
}
}
これは、MCP の設定内から環境変数に直接アクセスできない AI クライアント(Cursor など)では機能しません。回避策として、MCP の設定からローカルスクリプトを呼び出すことができます。例についてはこちらをご覧ください。
要件
サポートされている JavaScript ランタイムについては、RUNTIMES.md を参照してください。
利用可能なリソースと操作
利用可能なメソッド
AiConfigs
- getTargeting - AI Config のターゲティングを表示
- updateTargeting - AI Config のターゲティングを更新
- list - AI Config の一覧を取得
- create - AI Config を新規作成
- delete - AI Config を削除
- get - AI Config を取得
- update - AI Config を更新
- createVariation - AI Config のバリエーションを作成
- deleteVariation - AI Config のバリエーションを削除
- getVariation - AI Config のバリエーションを取得
- updateVariation - AI Config のバリエーションを更新
AuditLog
- listEntries - 監査ログエントリの一覧を取得
CodeReferences
- listRepositories - リポジトリの一覧を取得
Environments
- listByProject - 環境の一覧を取得
Experiments
- list - 実験を取得
- create - 実験を作成
- get - 実験を取得
- patch - 実験にパッチを適用
createIteration- イテレーションを作成 :warning: 非推奨- getExperimentsAnyEnv - 任意の環境の実験を取得
FeatureFlags
- getStatus - 環境全体のフラグのステータスを取得
- list - フィーチャーフラグの一覧を取得
- create - フィーチャーフラグを作成
- get - フィーチャーフラグを取得
- patch - フィーチャーフラグを更新
- delete - フィーチャーフラグを削除
メトリクス
利用可能な環境
ほとんどの顧客アカウントは、LaunchDarkly の商用(デフォルト)環境で稼働しています。ほかの環境をご利用のお客様は、--server-url 引数を指定して適切な環境に接続できます。たとえば、LaunchDarkly の Federal 環境をご利用のお客様は、MCP サーバーの起動時に --server-url https://app.launchdarkly.us 引数を指定してください。
| 環境 | サーバー URL |
|---|---|
| 商用(デフォルト) | https://app.launchdarkly.com |
| Federal | https://app.launchdarkly.us |
| EU | https://app.eu.launchdarkly.com |
コントリビューション
この SDK へのオープンソースのコントリビューションを歓迎していますが、このライブラリはプログラムによって生成されます。内部ファイルに手動で加えた変更は、次回の生成時に上書きされます。 ご意見をお待ちしています。概念実証を添えて PR または issue をお気軽に作成してください。今後のリリースに含められるよう、最善を尽くします。
LaunchDarkly について
- LaunchDarkly は、機能フラグをサービスとして提供し、開発者が迅速かつ安全に反復開発できるようにする継続的デリバリープラットフォームです。機能に簡単にフラグを設定し、LaunchDarkly のダッシュボードから管理できます。LaunchDarkly を使うと、次のことができます。
- 新機能を一部のユーザー(ベータテスターグループへの参加を希望したユーザーなど)に公開し、実際の利用状況からフィードバックやバグ報告を収集できます。
- 機能を利用するユーザーの割合を段階的に増やし、その機能が重要なメトリクスに与える影響を追跡できます(たとえば、機能 A と機能 B のどちらを使うと、ユーザーが購入を完了する可能性が高くなるかなど)。
- 本番環境でパフォーマンスの問題を引き起こしていると判明した機能を、再デプロイや、設定ファイルを変更してアプリケーションを再起動することなく無効にできます。
- 支払いプランなどのユーザー属性に基づいて特定の機能へのアクセスを許可できます(例:「gold」プランのユーザーには「silver」プランのユーザーより多くの機能へのアクセスを許可する)。
- アプリケーション全体を停止することなく、メンテナンスを行うためにアプリケーションの一部を無効にできます。
- LaunchDarkly は、多様な言語やテクノロジー向けの機能フラグ SDK を提供しています。全一覧についてはドキュメントをご覧ください。
- LaunchDarkly を詳しく見る
- LaunchDarkly の無料アカウントに登録
- 詳細については launchdarkly.com
- ドキュメントと SDK リファレンスガイドについては launchdarkly.com/docs
- API ドキュメントについては launchdarkly.com/docs/api
- 最新の製品アップデートについては blog.launchdarkly.com
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。