ConfigCat MCP Server

ConfigCat MCP Server

ConfigCat の Model Context Protocol（MCP）サーバーは、機能フラグと設定を管理するための ConfigCat の公開管理 API へのアクセスを提供します。また、コードエディターが機能フラグを認識し、プロジェクトに適切な ConfigCat SDK を統合したり、コードベース内に直接新しい機能フラグを作成したりできるようにします。

機能

• ツール：
  • ConfigCat の公開管理 API 操作一式。ConfigCat 内の機能フラグ、設定、環境、製品など、あらゆるエンティティの作成、読み取り、更新、削除ができます。
  • プロジェクトに機能フラグをスムーズに実装するための、包括的な SDK ドキュメントとコード例を取得できます。

セットアップ

以下の環境変数を使用して、MCP サーバーを設定できます。

環境変数	必須	デフォルト	説明
CONFIGCAT_API_USER	☑		ConfigCat Management API の基本認証ユーザー名。
CONFIGCAT_API_PASS	☑		ConfigCat Management API の基本認証パスワード。
CONFIGCAT_BASE_URL		https://api.configcat.com	ConfigCat Management API のホスト。

以下の手順では、クライアントを MCP サーバーに接続する方法を説明します。

Cursor

1. Preferences -> Cursor Settings -> MCP & Integrations を開きます
2. Add Custom MCP をクリックします
3. ConfigCat MCP サーバーの次のサーバー定義を追加します：

{
  "mcpServers": {
    "ConfigCat": {
      "command": "npx",
      "args": ["-y", "@configcat/mcp-server"],
      "env": {
        "CONFIGCAT_API_USER": "YOUR_API_USER",
        "CONFIGCAT_API_PASS": "YOUR_API_PASSWORD"
      }
    }
  }
}

4. 設定を保存します。

Visual Studio Code

1. プロジェクトのルートに .vscode/mcp.json ファイルを作成し、次の内容を記述します：

{
  "servers": {
    "ConfigCat": {
      "command": "npx",
      "args": ["-y", "@configcat/mcp-server"],
      "env": {
        "CONFIGCAT_API_USER": "YOUR_API_USER",
        "CONFIGCAT_API_PASS": "YOUR_API_PASSWORD"
      }
    }
  }
}

2. 設定ファイルを保存します。これで、VS Code で MCP サーバーを利用できるようになります。

Claude Desktop

1. Settings → Developer を開きます
2. Edit Config をクリックします
3. claude_desktop_config.json を開きます
4. ConfigCat MCP サーバーの次のサーバー定義を追加します：

{
  "mcpServers": {
    "ConfigCat": {
      "command": "npx",
      "args": ["-y", "@configcat/mcp-server"],
      "env": {
        "CONFIGCAT_API_USER": "YOUR_API_USER",
        "CONFIGCAT_API_PASS": "YOUR_API_PASSWORD"
      }
    }
  }
}

5. 保存して Claude を再起動します。

利用可能なツール

メンバーシップ管理

組織

• list-organizations - すべての組織を一覧表示

メンバー

• list-organization-members - 組織のメンバーを一覧表示
• list-pending-invitations - 保留中の招待を一覧表示
• list-pending-invitations-org - 組織の保留中の招待を一覧表示
• list-product-members - 製品のメンバーを一覧表示
• invite-member - 新しいメンバーを招待
• update-member-permissions - メンバーの権限を更新
• delete-organization-member - 組織のメンバーを削除
• delete-product-member - 製品のメンバーを削除
• delete-invitation - 招待を取り消し

権限グループ

• list-permission-groups - 権限グループを一覧表示
• create-permission-group - 新しい権限グループを作成
• get-permission-group - 権限グループの詳細を取得
• update-permission-group - 権限グループを更新
• delete-permission-group - 権限グループを削除

一般

製品

• list-products - すべての製品を一覧表示
• get-product - 特定の製品の詳細を取得
• update-product - 既存の製品を更新
• delete-product - 製品を削除
• get-product-preferences - 製品の設定を取得
• update-product-preferences - 製品の設定を更新
• create-product - 新しい製品を作成

設定

• list-configs - 製品の設定を一覧表示
• create-config - 新しい設定を作成
• get-config - 特定の設定の詳細を取得
• update-config - 既存の設定を更新
• delete-config - 設定を削除

環境

• list-environments - プロダクトの環境を一覧表示します
• create-environment - 新しい環境を作成します
• get-environment - 特定の環境の詳細を取得します
• update-environment - 既存の環境を更新します
• delete-environment - 環境を削除します

セグメント

• list-segments - ユーザーセグメントを一覧表示します
• create-segment - 新しいセグメントを作成します
• get-segment - 特定のセグメントの詳細を取得します
• update-segment - 既存のセグメントを更新します
• delete-segment - セグメントを削除します

SDK キー

• get-sdk-keys - 設定／環境の SDK キーを取得します

Webhook

• list-webhooks - Webhook を一覧表示します
• get-webhook - Webhook の詳細を取得します
• replace-webhook - Webhook の設定を置き換えます
• update-webhook - 既存の Webhook を更新します
• delete-webhook - Webhook を削除します
• get-webhook-signing-keys - Webhook の署名キーを一覧表示します
• create-webhook - 新しい Webhook を作成します

インテグレーション

• list-integrations - インテグレーションを一覧表示します
• create-integration - 新しいインテグレーションを作成します
• get-integration - インテグレーションの詳細を取得します
• update-integration - 既存のインテグレーションを更新します
• delete-integration - インテグレーションを削除します

コード参照

• get-code-references - コード参照を取得します

診断

監査ログ

• list-auditlogs - プロダクトの監査ログを取得します
• list-organization-auditlogs - 組織の監査ログを取得します

ゾンビ（古い）フラグ

• list-staleflags - 古いフィーチャーフラグのレポートを取得します

使用状況とクォータ

• get-organization-usage-and-quota - 組織の現在の使用状況とクォータ情報を取得します

フィーチャーフラグのメタデータ

フィーチャーフラグと設定

• list-settings - 設定のフィーチャーフラグを一覧表示します
• create-setting - 新しいフィーチャーフラグを作成します
• list-predefined-variations - 定義済みのバリエーションを一覧表示します
• update-predefined-variations - 定義済みのバリエーションを更新します
• get-setting - 特定のフィーチャーフラグの詳細を取得します
• replace-setting - フィーチャーフラグの設定を置き換えます
• update-setting - 既存のフィーチャーフラグを更新します
• delete-setting - フィーチャーフラグを削除します

タグ

• list-tags - プロダクトのタグを一覧表示します
• create-tag - 新しいタグを作成します
• list-settings-by-tag - タグごとにフィーチャーフラグを取得します
• get-tag - 特定のタグの詳細を取得します
• update-tag - 既存のタグを更新します
• delete-tag - タグを削除します

フィーチャーフラグと設定の値（v1 および v2 API）

• get-setting-value - フィーチャーフラグの値を取得します
• update-setting-value - フィーチャーフラグの値を更新します
• replace-setting-value - フィーチャーフラグの値を置き換えます
• get-setting-values - 複数の設定値を取得します
• post-setting-values - 複数の設定値を更新します
• V2 バリアント：Config V2 向けの上記ツールの *-v2 バージョン

変更リクエスト

• get-change-request - 指定した変更リクエストの詳細を返します
• update-change-request - タイトル、メモ、スケジュールなど、変更リクエストのメタデータを更新します
• list-change-requests - 変更リクエストを一覧表示します
• get-change-request-proposed-changes - 変更リクエストに含まれる設定への変更案を返します
• update-change-request-proposed-change - 変更リクエストに含まれる設定への変更案を更新します
• add-change-request-comment - 変更リクエストに新しいコメントを追加します
• apply-change-request - 変更リクエストを適用します
• approve-change-request - 変更リクエストを承認します
• claim-change-request-ownership - 変更リクエストの所有権を取得します
• close-change-request - 適用せずに変更リクエストを閉じます
• create-change-request - 指定した設定と環境の新しい変更リクエストを作成します
• remove-change-request-approval - 変更リクエストに対する既存の承認を取り消します
• resolve-change-request-setting-conflicts - 同時に公開された変更による競合を解決するため、変更リクエストに含まれる設定への変更案を更新します
• update-change-request-comment - 既存の変更リクエストのコメントを更新します
• delete-change-request-comment - 変更リクエストのコメントを削除します
• delete-change-request-proposed-change - 変更リクエストから設定を削除します

SDK ドキュメント

• update-sdk-documentation - プロジェクトでフィーチャーフラグをスムーズに実装できるよう、包括的な SDK ドキュメントとコード例を取得します。

API レート制限

ConfigCat パブリック API にはレート制限があります。サーバーはこれらの制限を遵守し、制限を超えた場合は適切なエラーメッセージを返します。

セキュリティに関する注意

このサーバーは管理操作専用に設計されています。本番アプリケーションでフィーチャーフラグの値を評価するためには使用しないでください。代わりに ConfigCat SDKs または ConfigCat Proxy を使用してください。

お困りですか？

https://configcat.com/support

コントリビューション

コントリビューションを歓迎します。詳しくはコントリビューションガイドラインをご覧ください。

ConfigCat について

• ConfigCat MCP サーバーのドキュメント
• ドキュメント
• ブログ