ConfigCat
官方与ConfigCat功能标志平台交互。支持管理功能标志、配置、环境、产品和组织。帮助集成ConfigCat SDK、实现功能标志或移除僵尸(过期)标志。
你可以用 ConfigCat MCP 做什么?
- 管理功能标志 — 在 ConfigCat 配置中创建、读取、更新、替换或删除功能标志及其设置。
- 管理产品和环境 — 列出、创建、更新或删除产品、配置、环境和分段。
- 处理变更请求 — 为配置和环境创建、列出、批准、应用、关闭或评论变更请求。
- 获取 SDK 文档 — 获取 SDK 文档和代码示例,以便将 ConfigCat 功能标志集成到项目中。
- 查看诊断信息 — 列出审计日志、获取过期功能标志报告,并检查组织用量和配额。
- 管理成员和 Webhook — 邀请成员、更新权限组,以及创建、更新或删除 Webhook。
文档
ConfigCat MCP Server
ConfigCat 的模型上下文协议 (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"
}
}
}
}
- 保存设置文件。现在,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- 获取过时功能标志报告
用量与配额
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 SDKs 或 ConfigCat Proxy。
需要帮助?
贡献
欢迎贡献。更多信息请阅读贡献指南。