ConfigCat

官方

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

你可以用 ConfigCat MCP 做什麼?

  • 管理功能旗標 — 請您的助理透過 create-setting、update-setting 或 delete-setting 來建立、更新或刪除功能旗標與設定。
  • 控制旗標值 — 使用 get-setting-value 或 update-setting-value 來跨環境讀取或變更功能旗標值。
  • 處理變更請求 — 使用 create-change-request 和 apply-change-request 等工具來建立、核准、套用或評論變更請求。
  • 取得 SDK 指引 — 請求 update-sdk-documentation 以取得您專案 SDK 的程式碼範例與實作指引。
  • 管理團隊存取權 — 使用 invite-member 和 list-organization-members 來邀請成員、更新權限或列出組織成員。
  • 追蹤旗標健康狀態 — 使用 list-staleflags 產生過時旗標報告,或透過 list-auditlogs 檢閱稽核日誌。

文件

ConfigCat MCP 伺服器

NPM License

ConfigCat 的模型上下文協定(MCP)伺服器提供對 ConfigCat 公開管理 API 的存取,用於功能旗標與組態管理。它也能讓你的程式碼編輯器理解你的功能旗標、將適當的 ConfigCat SDK 整合到你的專案中,甚至直接在程式碼庫中建立新的功能旗標。

功能

  • 工具:
    • 完整的 ConfigCat 公開管理 API 操作工具組。你可以對 ConfigCat 中的任何實體(如功能旗標、組態、環境或產品)進行建立、讀取、更新與刪除操作。
    • 取得完整的 SDK 文件與程式碼範例,以便在你的專案中無縫實作功能旗標。

設定

你可以使用下列環境變數來設定 MCP 伺服器。

環境變數必填預設值說明
CONFIGCAT_API_USER☑ConfigCat 管理 API 基本驗證使用者名稱。
CONFIGCAT_API_PASS☑ConfigCat 管理 API 基本驗證密碼。
CONFIGCAT_BASE_URLhttps://api.configcat.comConfigCat 管理 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"
      }
    }
  }
}
  1. 儲存設定。

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"
      }
    }
  }
}
  1. 儲存設定檔。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"
      }
    }
  }
}
  1. 儲存並重新啟動 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 變體:上述工具的 *-v2 版本,適用於 Config 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 SDK 或 ConfigCat Proxy。

需要協助嗎?

https://configcat.com/support

貢獻

歡迎貢獻。如需更多資訊,請閱讀 貢獻指南。

關於 ConfigCat