ConfigCat MCP Server

ConfigCat MCP サーバー

ConfigCat の Model Context Protocol (MCP) サーバーは、フィーチャーフラグと構成管理のための ConfigCat パブリック管理 API へのアクセスを提供します。また、コードエディタがフィーチャーフラグを理解し、適切な ConfigCat SDK をプロジェクトに統合したり、コードベース内で直接新しいフィーチャーフラグを作成したりすることも可能にします。

機能

• ツール:
  • ConfigCat パブリック管理 API 操作のための完全なツールセット。ConfigCat 内のフィーチャーフラグ、構成、環境、製品などのエンティティを作成、読み取り、更新、削除できます。
  • プロジェクトにフィーチャーフラグをシームレスに実装するための包括的な SDK ドキュメントとコード例を取得します。

セットアップ

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

環境変数	必須	デフォルト	説明
CONFIGCAT_API_USER	☑		ConfigCat 管理 API 基本認証ユーザー名。
CONFIGCAT_API_PASS	☑		ConfigCat 管理 API 基本認証パスワード。
CONFIGCAT_BASE_URL		https://api.configcat.com	ConfigCat 管理 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. 設定ファイルを保存します。これで MCP サーバーが VS Code で利用可能になります。

Claude Desktop

1. 設定 → 開発者 を開きます
2. 設定を編集 をクリックします
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 - 古いフィーチャーフラグレポートを取得

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

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

• 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 バージョン

SDK ドキュメント

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

API レート制限

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

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

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

ヘルプが必要ですか？

https://configcat.com/support

貢献

貢献を歓迎します。詳細については、貢献ガイドライン をお読みください。

ConfigCat について

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