ConfigCat MCP Server
chính thứctương tác với nền tảng cờ tính năng ConfigCat. Hỗ trợ quản lý cờ tính năng, cấu hình, môi trường, sản phẩm và tổ chức. Giúp tích hợp SDK ConfigCat, triển khai cờ tính năng hoặc loại bỏ các cờ cũ (zombie).
Tài liệu
ConfigCat MCP Server
Máy chủ Model Context Protocol (MCP) của ConfigCat cung cấp quyền truy cập vào API quản lý công khai của ConfigCat để quản lý cờ tính năng và cấu hình. Nó cũng cho phép trình soạn thảo mã của bạn hiểu các cờ tính năng, tích hợp SDK ConfigCat phù hợp vào dự án hoặc thậm chí tạo cờ tính năng mới trực tiếp trong cơ sở mã của bạn.
Tính năng
- Công cụ:
- Bộ công cụ đầy đủ cho các thao tác API quản lý công khai của ConfigCat. Bạn có thể Tạo, Đọc, Cập nhật và Xóa bất kỳ thực thể nào như Cờ tính năng, Cấu hình, Môi trường hoặc Sản phẩm trong ConfigCat.
- Nhận tài liệu SDK toàn diện và ví dụ mã để triển khai cờ tính năng liền mạch trong dự án của bạn.
Thiết lập
Bạn có thể sử dụng các biến môi trường sau để cấu hình máy chủ MCP.
| Biến môi trường | Bắt buộc | Mặc định | Mô tả |
|---|---|---|---|
| CONFIGCAT_API_USER | ☑ | Tên người dùng xác thực cơ bản của API quản lý ConfigCat. | |
| CONFIGCAT_API_PASS | ☑ | Mật khẩu xác thực cơ bản của API quản lý ConfigCat. | |
| CONFIGCAT_BASE_URL | https://api.configcat.com | Máy chủ API quản lý ConfigCat. |
Hướng dẫn bên dưới chỉ cách kết nối một máy khách với máy chủ MCP.
Cursor
- Mở
Preferences->Cursor Settings->MCP & Integrations - Nhấp
Add Custom MCP - Thêm định nghĩa máy chủ sau cho máy chủ ConfigCat MCP:
{
"mcpServers": {
"ConfigCat": {
"command": "npx",
"args": ["-y", "@configcat/mcp-server"],
"env": {
"CONFIGCAT_API_USER": "YOUR_API_USER",
"CONFIGCAT_API_PASS": "YOUR_API_PASSWORD"
}
}
}
}
- Lưu cài đặt.
Visual Studio Code
- Tạo một tệp
.vscode/mcp.jsontrong thư mục gốc dự án của bạn với nội dung sau:
{
"servers": {
"ConfigCat": {
"command": "npx",
"args": ["-y", "@configcat/mcp-server"],
"env": {
"CONFIGCAT_API_USER": "YOUR_API_USER",
"CONFIGCAT_API_PASS": "YOUR_API_PASSWORD"
}
}
}
}
- Lưu tệp cài đặt. Máy chủ MCP bây giờ sẽ khả dụng trong VS Code.
Claude Desktop
- Mở Cài đặt → Nhà phát triển
- Nhấp Chỉnh sửa Cấu hình
- Mở
claude_desktop_config.json - Thêm định nghĩa máy chủ sau cho máy chủ ConfigCat MCP:
{
"mcpServers": {
"ConfigCat": {
"command": "npx",
"args": ["-y", "@configcat/mcp-server"],
"env": {
"CONFIGCAT_API_USER": "YOUR_API_USER",
"CONFIGCAT_API_PASS": "YOUR_API_PASSWORD"
}
}
}
}
- Lưu và khởi động lại Claude.
Công cụ khả dụng
Quản lý thành viên
Tổ chức
list-organizations- Liệt kê tất cả tổ chức
Thành viên
list-organization-members- Liệt kê thành viên tổ chứclist-pending-invitations- Liệt kê lời mời đang chờlist-pending-invitations-org- Liệt kê lời mời đang chờ của tổ chứclist-product-members- Liệt kê thành viên sản phẩminvite-member- Mời thành viên mớiupdate-member-permissions- Cập nhật quyền của thành viêndelete-organization-member- Xóa thành viên tổ chứcdelete-product-member- Xóa thành viên sản phẩmdelete-invitation- Hủy lời mời
Nhóm quyền
list-permission-groups- Liệt kê nhóm quyềncreate-permission-group- Tạo nhóm quyền mớiget-permission-group- Lấy chi tiết nhóm quyềnupdate-permission-group- Cập nhật nhóm quyềndelete-permission-group- Xóa nhóm quyền
Chung
Sản phẩm
list-products- Liệt kê tất cả sản phẩmget-product- Lấy chi tiết sản phẩm cụ thểupdate-product- Cập nhật sản phẩm hiện códelete-product- Xóa sản phẩmget-product-preferences- Lấy tùy chọn sản phẩmupdate-product-preferences- Cập nhật tùy chọn sản phẩmcreate-product- Tạo sản phẩm mới
Cấu hình
list-configs- Liệt kê cấu hình cho một sản phẩmcreate-config- Tạo cấu hình mớiget-config- Lấy chi tiết cấu hình cụ thểupdate-config- Cập nhật cấu hình hiện códelete-config- Xóa cấu hình
Môi trường
list-environments- Liệt kê môi trường cho một sản phẩmcreate-environment- Tạo môi trường mớiget-environment- Lấy chi tiết môi trường cụ thểupdate-environment- Cập nhật môi trường hiện códelete-environment- Xóa môi trường
Phân đoạn
list-segments- Liệt kê phân đoạn người dùngcreate-segment- Tạo phân đoạn mớiget-segment- Lấy chi tiết phân đoạn cụ thểupdate-segment- Cập nhật phân đoạn hiện códelete-segment- Xóa phân đoạn
Khóa SDK
get-sdk-keys- Lấy khóa SDK cho cấu hình/môi trường
Webhooks
list-webhooks- Liệt kê webhooksget-webhook- Lấy chi tiết webhookreplace-webhook- Thay thế cấu hình webhookupdate-webhook- Cập nhật webhook hiện códelete-webhook- Xóa webhookget-webhook-signing-keys- Liệt kê khóa ký webhookcreate-webhook- Tạo webhook mới
Tích hợp
list-integrations- Liệt kê tích hợpcreate-integration- Tạo tích hợp mớiget-integration- Lấy chi tiết tích hợpupdate-integration- Cập nhật tích hợp hiện códelete-integration- Xóa tích hợp
Tham chiếu mã
get-code-references- Lấy tham chiếu mã
Chẩn đoán
Nhật ký kiểm toán
list-auditlogs- Lấy nhật ký kiểm toán sản phẩmlist-organization-auditlogs- Lấy nhật ký kiểm toán tổ chức
Cờ zombie (cũ)
list-staleflags- Lấy báo cáo cờ tính năng cũ
Siêu dữ liệu cờ tính năng
Cờ tính năng & Cài đặt
list-settings- Liệt kê cờ tính năng cho một cấu hìnhcreate-setting- Tạo cờ tính năng mớilist-predefined-variations- Liệt kê các biến thể được xác định trướcupdate-predefined-variations- Cập nhật các biến thể được xác định trướcget-setting- Lấy chi tiết cờ tính năng cụ thểreplace-setting- Thay thế cấu hình cờ tính năngupdate-setting- Cập nhật cờ tính năng hiện códelete-setting- Xóa cờ tính năng
Thẻ
list-tags- Liệt kê thẻ cho một sản phẩmcreate-tag- Tạo thẻ mớilist-settings-by-tag- Lấy cờ tính năng theo thẻget-tag- Lấy chi tiết thẻ cụ thểupdate-tag- Cập nhật thẻ hiện códelete-tag- Xóa thẻ
Giá trị cờ tính năng & cài đặt (API v1 & v2)
get-setting-value- Lấy giá trị cờ tính năngupdate-setting-value- Cập nhật giá trị cờ tính năngreplace-setting-value- Thay thế giá trị cờ tính năngget-setting-values- Lấy nhiều giá trị cài đặtpost-setting-values- Cập nhật nhiều giá trị cài đặt- Biến thể V2:
*-v2phiên bản của các công cụ trên cho Cấu hình V2
Tài liệu SDK
update-sdk-documentation- Nhận tài liệu SDK toàn diện và ví dụ mã để triển khai cờ tính năng liền mạch trong dự án của bạn.
Giới hạn tốc độ API
API công khai của ConfigCat có giới hạn tốc độ. Máy chủ sẽ tôn trọng các giới hạn này và trả về thông báo lỗi thích hợp nếu vượt quá giới hạn.
Lưu ý bảo mật
Máy chủ này chỉ được thiết kế cho các hoạt động quản lý. Không sử dụng nó để đánh giá giá trị cờ tính năng trong các ứng dụng sản xuất - thay vào đó hãy sử dụng SDK ConfigCat hoặc ConfigCat Proxy.
Cần trợ giúp?
Đóng góp
Hoan nghênh các đóng góp. Để biết thêm thông tin, vui lòng đọc Hướng dẫn đóng góp.