ConfigCat

官方

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

你可以用 ConfigCat MCP 做什麼?

  • 管理功能旗標 — 在 ConfigCat 設定中建立、讀取、更新、取代或刪除功能旗標及其設定。
  • 管理產品與環境 — 列出、建立、更新或刪除產品、設定、環境與區段。
  • 處理變更請求 — 建立、列出、核准、套用、關閉或留言回覆設定與環境的變更請求。
  • 取得 SDK 文件 — 取得 SDK 文件與程式碼範例,將 ConfigCat 功能旗標整合至專案中。
  • 檢視診斷資訊 — 列出稽核記錄、取得過時功能旗標報告,並查看組織用量與配額。
  • 管理成員與 Webhook — 邀請成員、更新權限群組,以及建立、更新或刪除 Webhook。

文件

ConfigCat MCP Server

NPM License

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_URLhttps://api.configcat.comConfigCat 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"
      }
    }
  }
}
  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. 儲存設定檔。現在應該可以在 VS Code 中使用 MCP 伺服器。

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 - 取得過時功能旗標報告

使用量與配額

  • 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 版本:*-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 文件

  • get-sdk-documentation - 提供完整的 SDK 文件和程式碼範例,讓您能在專案中順利實作功能旗標。

API 速率限制

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

安全性注意事項

此伺服器僅供管理操作使用。請勿用於正式環境應用程式中的功能旗標值評估,請改用 ConfigCat SDK 或 ConfigCat Proxy。

需要協助嗎?

https://configcat.com/support

參與貢獻

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

關於 ConfigCat