ConfigCat MCP Server

chính thức

tươ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

NPM License

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ườngBắt buộcMặc địnhMô tả
CONFIGCAT_API_USERTên người dùng xác thực cơ bản của API quản lý ConfigCat.
CONFIGCAT_API_PASSMật khẩu xác thực cơ bản của API quản lý ConfigCat.
CONFIGCAT_BASE_URLhttps://api.configcat.comMá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

  1. Mở Preferences -> Cursor Settings -> MCP & Integrations
  2. Nhấp Add Custom MCP
  3. 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"
      }
    }
  }
}
  1. Lưu cài đặt.

Visual Studio Code

  1. Tạo một 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"
      }
    }
  }
}
  1. Lưu tệp cài đặt. Máy chủ MCP bây giờ sẽ khả dụng trong VS Code.

Claude Desktop

  1. Mở Cài đặtNhà phát triển
  2. Nhấp 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ủ ConfigCat MCP:
{
  "mcpServers": {
    "ConfigCat": {
      "command": "npx",
      "args": ["-y", "@configcat/mcp-server"],
      "env": {
        "CONFIGCAT_API_USER": "YOUR_API_USER",
        "CONFIGCAT_API_PASS": "YOUR_API_PASSWORD"
      }
    }
  }
}
  1. 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ức
  • list-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ứ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ả 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

Webhooks

  • list-webhooks - Liệt kê webhooks
  • 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 (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ì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: *-v2 phiê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?

https://configcat.com/support

Đó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.

Về ConfigCat