ConfigCat MCP Server

官方

與 ConfigCat 功能標誌平台互動。支援管理功能標誌、配置、環境、產品與組織。協助整合 ConfigCat SDK、實作功能標誌或移除殭屍（過時）標誌。

文件

ConfigCat MCP 伺服器

ConfigCat 的模型上下文協定 (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

開啟 Preferences -> Cursor Settings -> MCP & Integrations
點擊 Add Custom MCP
為 ConfigCat MCP 伺服器新增下列伺服器定義：

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

儲存設定。

Visual Studio Code

在您的專案根目錄中建立一個 .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"
      }
    }
  }
}

儲存設定檔。MCP 伺服器現在應該可以在 VS Code 中使用了。

Claude Desktop

開啟設定 → 開發者
點擊 編輯設定
開啟 claude_desktop_config.json
為 ConfigCat MCP 伺服器新增下列伺服器定義：

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

儲存並重新啟動 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 金鑰

Webhooks

list-webhooks - 列出 webhooks
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 - 刪除功能旗標

功能旗標與設定值（v1 與 v2 API）

get-setting-value - 取得功能旗標值
update-setting-value - 更新功能旗標值
replace-setting-value - 取代功能旗標值
get-setting-values - 取得多個設定值
post-setting-values - 更新多個設定值
V2 變體：上述工具的 *-v2 版本，用於設定 V2

SDK 文件

update-sdk-documentation - 取得全面的 SDK 文件與程式碼範例，以便在您的專案中無縫實作功能旗標。

API 速率限制

ConfigCat 公開 API 有速率限制。伺服器將遵守這些限制，並在超出限制時返回適當的錯誤訊息。

安全性注意事項

此伺服器僅設計用於管理操作。請勿將其用於在正式環境應用程式中評估功能旗標值 - 請改用 ConfigCat SDK 或 ConfigCat Proxy。