MCP Server

🚀 ConfigCat MCP Server

ConfigCat のモデルコンテキストプロトコル (MCP) サーバーは、機能フラグと設定管理のために ConfigCat の公開管理 API にアクセスできるようにします。また、コードエディタが機能フラグを理解し、適切な ConfigCat SDK をプロジェクトに統合し、コードベース内で直接新しい機能フラグを作成することも可能にします。

✨ 主な機能

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

📦 インストール

MCP サーバーを構成するには、以下の環境変数を使用できます。

以下の手順で、クライアントを 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 - 古い機能フラグのレポートを取得します。

機能フラグメタデータ

機能フラグと設定

• list-settings - 設定の機能フラグをリストします。
• create-setting - 新しい機能フラグを作成します。
• 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 SDKs または ConfigCat Proxy を使用してください。

📚 詳細ドキュメント

ヘルプが必要ですか？

https://configcat.com/support

コントリビューション

コントリビューションは歓迎されます。詳細については Contribution Guideline を読んでください。

ConfigCat について

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