ConfigCat MCP Server

ConfigCat MCP 服务

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

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

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. 保存设置文件。现在应该可以在 VS Code 中使用 MCP 服务了。

Claude Desktop

1. 打开 Settings → Developer
2. 点击 Edit Config
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 - 获取过期功能标志报告

用量与配额

• 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 - 为指定的 Config 和 Environment 创建新的变更请求
• 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 SDKs 或 ConfigCat Proxy。

需要帮助？

https://configcat.com/support

参与贡献

欢迎贡献。更多信息请阅读贡献指南。

关于 ConfigCat

• ConfigCat MCP 服务文档
• 文档
• 博客