ConfigCat
官方與 ConfigCat 功能標誌平台互動。支援管理功能標誌、配置、環境、產品與組織。協助整合 ConfigCat SDK、實作功能標誌或移除殭屍(過時)標誌。
你可以用 ConfigCat MCP 做什麼?
- 管理功能旗標 — 在 ConfigCat 設定中建立、讀取、更新、取代或刪除功能旗標及其設定。
- 管理產品與環境 — 列出、建立、更新或刪除產品、設定、環境與區段。
- 處理變更請求 — 建立、列出、核准、套用、關閉或留言回覆設定與環境的變更請求。
- 取得 SDK 文件 — 取得 SDK 文件與程式碼範例,將 ConfigCat 功能旗標整合至專案中。
- 檢視診斷資訊 — 列出稽核記錄、取得過時功能旗標報告,並查看組織用量與配額。
- 管理成員與 Webhook — 邀請成員、更新權限群組,以及建立、更新或刪除 Webhook。
文件
ConfigCat MCP Server
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_URL | https://api.configcat.com | ConfigCat Management 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"
}
}
}
}
- 儲存設定檔。現在應該可以在 VS Code 中使用 MCP 伺服器。
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 金鑰
Webhook
list-webhooks- 列出 Webhookget-webhook- 取得 Webhook 詳細資料replace-webhook- 取代 Webhook 設定update-webhook- 更新現有 Webhookdelete-webhook- 刪除 Webhookget-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。
需要協助嗎?
參與貢獻
歡迎貢獻。如需更多資訊,請參閱貢獻指南。