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 伺服器
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 金鑰
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- 取得過時功能旗標報告
功能旗標中繼資料
功能旗標與設定
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。
需要協助嗎?
貢獻
歡迎貢獻。如需更多資訊,請閱讀 貢獻指南。