MCP Server

🚀 ConfigCat MCP 服務器

ConfigCat 的模型上下文協議（MCP）服務器提供對 ConfigCat 公共管理 API 的訪問，用於進行功能開關和配置管理。它還能讓你的代碼編輯器理解你的功能開關，將合適的 ConfigCat SDK 集成到你的項目中，甚至可以直接在你的代碼庫中創建新的功能開關。

✨ 主要特性

• 工具集：
  • 具備用於 ConfigCat 公共管理 API 操作的全套工具。你可以在 ConfigCat 中創建、讀取、更新和刪除任何實體，如功能開關、配置、環境或產品。
  • 獲取全面的 SDK 文檔和代碼示例，以便在你的項目中無縫實現功能開關。

📦 安裝指南

你可以使用以下環境變量來配置 MCP 服務器。

以下說明展示瞭如何將客戶端連接到 MCP 服務器。

Cursor

1. 打開 偏好設置 -> Cursor 設置 -> MCP 與集成
2. 點擊 添加自定義 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"
      }
    }
  }
}

4. 保存設置。

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"
      }
    }
  }
}

2. 保存設置文件。此時 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"
      }
    }
  }
}

5. 保存並重啟 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 - 創建新的功能開關
  • 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

SDK 文檔

• update-sdk-documentation - 獲取全面的 SDK 文檔和代碼示例，以便在你的項目中無縫實現功能開關。

API 速率限制

ConfigCat 公共 API 有速率限制。服務器將遵守這些限制，如果超出限制，將返回相應的錯誤消息。

安全注意事項

此服務器僅用於管理操作。請勿在生產應用程序中使用它來評估功能開關的值，而是使用 ConfigCat SDK 或 ConfigCat 代理。

📄 許可證

暫未提及相關許可證信息。

需要幫助？

點擊獲取支持

貢獻代碼

歡迎貢獻代碼。更多信息請閱讀 貢獻指南。

關於 ConfigCat

• ConfigCat MCP 服務器文檔
• 文檔
• 博客