ConfigCat

Máy chủ MCP ConfigCat

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 của bạn, tích hợp SDK ConfigCat phù hợp vào dự án của bạn hoặc thậm chí tạo cờ tính năng mới trực tiếp trong mã nguồn 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 API quản lý ConfigCat.
CONFIGCAT_API_PASS	☑		Mật khẩu xác thực cơ bản API quản lý ConfigCat.
CONFIGCAT_BASE_URL		https://api.configcat.com	Máy chủ API quản lý ConfigCat.

Các hướng dẫn dưới đây cho thấy cách kết nối máy khách với máy chủ MCP.

Cursor

1. Mở Preferences -> Cursor Settings -> MCP & Integrations
2. Nhấp vào Add Custom MCP
3. Thêm định nghĩa máy chủ sau cho máy chủ MCP ConfigCat:

{
  "mcpServers": {
    "ConfigCat": {
      "command": "npx",
      "args": ["-y", "@configcat/mcp-server"],
      "env": {
        "CONFIGCAT_API_USER": "YOUR_API_USER",
        "CONFIGCAT_API_PASS": "YOUR_API_PASSWORD"
      }
    }
  }
}

4. Lưu cài đặt.

Visual Studio Code

1. Tạo tệp .vscode/mcp.json trong 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"
      }
    }
  }
}

2. Lưu tệp cài đặt. Máy chủ MCP bây giờ sẽ có sẵn trong VS Code.

Claude Desktop

1. Mở Cài đặt → Nhà phát triển
2. Nhấp vào Chỉnh sửa cấu hình
3. Mở claude_desktop_config.json
4. Thêm định nghĩa máy chủ sau cho máy chủ MCP ConfigCat:

{
  "mcpServers": {
    "ConfigCat": {
      "command": "npx",
      "args": ["-y", "@configcat/mcp-server"],
      "env": {
        "CONFIGCAT_API_USER": "YOUR_API_USER",
        "CONFIGCAT_API_PASS": "YOUR_API_PASSWORD"
      }
    }
  }
}

5. Lưu và khởi động lại Claude.

Công cụ khả dụng

Quản lý tư cách thành viên

Tổ chức

• list-organizations - Liệt kê tất cả các tổ chức

Thành viên

• list-organization-members - Liệt kê thành viên tổ chức
• list-pending-invitations - Liệt kê lời mời đang chờ xử lý
• list-pending-invitations-org - Liệt kê lời mời đang chờ xử lý của tổ chức
• list-product-members - Liệt kê thành viên sản phẩm
• invite-member - Mời thành viên mới
• update-member-permissions - Cập nhật quyền của thành viên
• delete-organization-member - Xóa thành viên tổ chức
• delete-product-member - Xóa thành viên sản phẩm
• delete-invitation - Hủy lời mời

Nhóm quyền

• list-permission-groups - Liệt kê nhóm quyền
• create-permission-group - Tạo nhóm quyền mới
• get-permission-group - Lấy chi tiết nhóm quyền
• update-permission-group - Cập nhật nhóm quyền
• delete-permission-group - Xóa nhóm quyền

Chung

Sản phẩm

• list-products - Liệt kê tất cả các sản phẩm
• get-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ẩm
• get-product-preferences - Lấy tùy chọn sản phẩm
• update-product-preferences - Cập nhật tùy chọn sản phẩm
• create-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ẩm
• create-config - Tạo cấu hình mới
• get-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ẩm
• create-environment - Tạo môi trường mới
• get-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ùng
• create-segment - Tạo phân đoạn mới
• get-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

Webhook

• list-webhooks - Liệt kê webhook
• get-webhook - Lấy chi tiết webhook
• replace-webhook - Thay thế cấu hình webhook
• update-webhook - Cập nhật webhook hiện có
• delete-webhook - Xóa webhook
• get-webhook-signing-keys - Liệt kê khóa ký webhook
• create-webhook - Tạo webhook mới

Tích hợp

• list-integrations - Liệt kê tích hợp
• create-integration - Tạo tích hợp mới
• get-integration - Lấy chi tiết tích hợp
• update-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ẩm
• list-organization-auditlogs - Lấy nhật ký kiểm toán tổ chức

Cờ zombie (lỗi thời)

• list-staleflags - Lấy báo cáo cờ tính năng lỗi thời

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ình
• create-setting - Tạo cờ tính năng mới
• list-predefined-variations - Liệt kê các biến thể được xác định trước
• update-predefined-variations - Cập nhật các biến thể được xác định trước
• get-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ăng
• update-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ẩm
• create-tag - Tạo thẻ mới
• list-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ăng
• update-setting-value - Cập nhật giá trị cờ tính năng
• replace-setting-value - Thay thế giá trị cờ tính năng
• get-setting-values - Lấy nhiều giá trị cài đặt
• post-setting-values - Cập nhật nhiều giá trị cài đặt
• Biến thể V2: phiên bản *-v2 của các công cụ trên cho Config V2

Yêu cầu thay đổi

• get-change-request - Trả về chi tiết của một Yêu cầu thay đổi cụ thể
• update-change-request - Cập nhật siêu dữ liệu của Yêu cầu thay đổi, chẳng hạn như tiêu đề, ghi chú, lịch trình, v.v.
• list-change-requests - Liệt kê Yêu cầu thay đổi
• get-change-request-proposed-changes - Trả về các thay đổi được đề xuất cho Cài đặt có trong Yêu cầu thay đổi
• update-change-request-proposed-change - Cập nhật các thay đổi được đề xuất cho Cài đặt có trong Yêu cầu thay đổi
• add-change-request-comment - Thêm bình luận mới vào Yêu cầu thay đổi
• apply-change-request - Áp dụng Yêu cầu thay đổi
• approve-change-request - Thêm phê duyệt của bạn vào Yêu cầu thay đổi
• claim-change-request-ownership - Nhận quyền sở hữu Yêu cầu thay đổi
• close-change-request - Đóng Yêu cầu thay đổi mà không áp dụng
• create-change-request - Tạo Yêu cầu thay đổi mới cho Cấu hình và Môi trường được chỉ định
• remove-change-request-approval - Xóa phê duyệt hiện có của bạn khỏi Yêu cầu thay đổi
• resolve-change-request-setting-conflicts - Cập nhật các thay đổi được đề xuất cho một Cài đặt có trong Yêu cầu thay đổi để giải quyết xung đột do các thay đổi được xuất bản đồng thời gây ra
• update-change-request-comment - Cập nhật bình luận Yêu cầu thay đổi hiện có
• delete-change-request-comment - Xóa bình luận Yêu cầu thay đổi
• delete-change-request-proposed-change - Xóa một cài đặt khỏi Yêu cầu thay đổi

Tài liệu SDK

• update-sdk-documentation - Lấy 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?

https://configcat.com/support

Đóng góp

Rất 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.

Về ConfigCat

• Tài liệu máy chủ MCP ConfigCat
• Tài liệu
• Blog