Unleash
chính thứcMáy chủ MCP để quản lý các cờ tính năng Unleash và tự động hóa các phương pháp tốt nhất.
Bạn có thể làm gì với Unleash MCP?
- Tìm cờ và tài nguyên liên quan — Hỏi những cờ nào trong một dự án được gắn thẻ theo cách nhất định, hoặc tra cứu phân khúc, trường ngữ cảnh, thẻ và môi trường theo tên bằng
search. - Kiểm tra cờ hoặc dự án — Đọc đầy đủ thông tin về dự án, cờ, trường ngữ cảnh hoặc phân khúc, bao gồm cả chỉ số mức độ tiếp cận của cờ trong một môi trường, bằng
inspect. - Kiểm tra kết quả đánh giá cờ — Hỏi xem một cờ được bật, tắt hay chưa xác định đối với một ngữ cảnh nhất định trong một môi trường bằng
evaluate. - Triển khai hoặc tắt cờ — Bật cờ cho các nhóm đối tượng, phân chia theo tỷ lệ phần trăm hoặc mẫu, hoặc tắt cờ bằng
release, thao tác này sẽ mở một yêu cầu thay đổi khi cần. - Chạy thử nghiệm A/B — Gán giá trị đối chứng và thử nghiệm cho các nhóm đối tượng theo tỷ lệ chia sẻ hoặc mỗi nhóm một giá trị, hoặc dừng thử nghiệm bằng
experiment. - Xem lại các thay đổi gần đây — Hỏi điều gì đã thay đổi, ai đã thay đổi và khi nào trong 31 ngày qua bằng
audit.
Tài liệu
Máy chủ MCP Unleash
Máy chủ MCP cho phép các tác nhân AI làm việc với Unleash theo cách bạn vẫn làm trên giao diện Unleash: tìm cờ, triển khai chúng, kiểm tra ai nhận được chúng và xem những gì đã thay đổi. Máy chủ đang ở giai đoạn alpha và chưa được phát hành lên npm, vì vậy bạn chạy máy chủ từ mã nguồn.
Công cụ
| Công cụ | Mô tả | Câu lệnh mẫu |
|---|---|---|
search | Tìm dự án, cờ, phân đoạn, trường ngữ cảnh, thẻ, loại thẻ, người tạo cờ, mẫu phát hành, loại sự kiện và môi trường theo tên. | "Những cờ nào trong dự án checkout được gắn thẻ team:payments?" |
inspect | Đọc đầy đủ một dự án, cờ, trường ngữ cảnh hoặc phân đoạn, hoặc chỉ số mức độ tiếp xúc của một cờ trong môi trường. | "Cho tôi xem mọi thông tin về cờ new-checkout." |
evaluate | Cho biết một cờ được bật, tắt hay chưa xác định đối với một ngữ cảnh trong môi trường. | "Người dùng 42 có nhận được new-checkout trong production không?" |
release | Bật cờ cho các nhóm đối tượng, phân chia theo giá trị hoặc thông qua mẫu phát hành, hoặc tắt cờ. Tạo cờ nếu cờ chưa tồn tại. Mở yêu cầu thay đổi nếu môi trường yêu cầu. | "Triển khai new-checkout cho 10% người dùng trong production." |
kill_switch | Bật hoặc tắt công tắc ngắt vĩnh viễn cho tất cả mọi người hoặc các nhóm đối tượng được chọn. Tạo công tắc nếu công tắc chưa tồn tại. Mở yêu cầu thay đổi nếu môi trường yêu cầu. | "Tắt payments trong production." |
experiment | Chạy thử nghiệm A/B: gán cho các nhóm đối tượng những giá trị như control và treatment theo tỷ lệ hoặc mỗi nhóm một giá trị, hoặc dừng thử nghiệm. Tạo cờ nếu cờ chưa tồn tại. Mở yêu cầu thay đổi nếu môi trường yêu cầu. | "Chia checkout 50/50 giữa control và luồng mới." |
manage_flag | Định nghĩa cờ, đặt quan hệ phụ thuộc cha, đánh dấu cờ là hoàn tất, lưu trữ và khôi phục chúng. Không xóa cờ. | "Lưu trữ cờ old-banner." |
configure | Thay đổi trường ngữ cảnh và các giá trị hợp lệ của chúng, phân đoạn, loại thẻ và thẻ, mẫu phát hành và dự án. | "Tạo phân đoạn beta-testers cho userId 1, 2 và 3." |
audit | Đọc nội dung đã thay đổi, người thực hiện thay đổi và thời điểm thay đổi, trong khoảng thời gian tối đa 31 ngày. | "Hôm qua có gì thay đổi trong production?" |
docs | Trả lời câu hỏi về các phương pháp sử dụng cờ tính năng và chính Unleash dựa trên tài liệu Unleash hiện hành. | "Tôi nên dọn dẹp các cờ cũ như thế nào?" |
send_feedback | Báo cho Unleash biết máy chủ đã không đáp ứng được yêu cầu ở đâu. Trước tiên sẽ hỏi bạn, trừ khi UNLEASH_MCP_SEND_FEEDBACK quyết định. | Không có: tác nhân tự gọi công cụ này. |
Cài đặt cục bộ
Bạn cần Node 24 trở lên và pnpm.
-
Sao chép kho lưu trữ và chuyển sang nhánh
v2:git clone https://github.com/Unleash/unleash-mcp.git cd unleash-mcp git checkout v2Thao tác này lấy mã nguồn v2.
-
Cài đặt các phần phụ thuộc:
pnpm installNode chạy trực tiếp mã nguồn TypeScript, nên không cần bước build.
-
Trong Unleash, tạo mã thông báo truy cập cá nhân tại Profile > Personal API tokens. Máy chủ hoạt động với quyền của người dùng đó.
-
Đăng ký máy chủ với ứng dụng khách MCP của bạn. Với Claude Code:
claude mcp add unleash \ -e UNLEASH_BASE_URL=https://your-instance.getunleash.io \ -e UNLEASH_PAT=user:your-personal-access-token \ -- node /absolute/path/to/unleash-mcp/src/index.tsThao tác này thêm một máy chủ stdio có tên
unleashvào Claude Code. Với các ứng dụng khách được cấu hình bằng JSON, chẳng hạn như Claude Desktop, Cursor hoặc VS Code, hãy thêm nội dung sau vào danh sách máy chủ MCP của chúng:{ "mcpServers": { "unleash": { "command": "node", "args": ["/absolute/path/to/unleash-mcp/src/index.ts"], "env": { "UNLEASH_BASE_URL": "https://your-instance.getunleash.io", "UNLEASH_PAT": "user:your-personal-access-token" } } } } -
Yêu cầu tác nhân "Liệt kê các dự án Unleash của tôi". Nếu tác nhân trả lời bằng các dự án của bạn, máy chủ đang chạy.
Cấu hình máy chủ cục bộ
| Biến | Bắt buộc | Mô tả |
|---|---|---|
UNLEASH_BASE_URL | Có | URL của phiên bản Unleash của bạn, chẳng hạn như https://sandbox.getunleash.io/enterprise. |
UNLEASH_PAT | Có | Mã thông báo truy cập cá nhân mà máy chủ dùng để gọi Unleash. |
UNLEASH_MCP_SEND_FEEDBACK | Không | true gửi báo cáo mà không hỏi, false không đưa send_feedback vào. Nếu không đặt, bạn sẽ được hỏi khi gửi báo cáo lần đầu. |
UNLEASH_FEEDBACK_URL | Không | Phiên bản Unleash nhận báo cáo send_feedback. Nếu không đặt, dùng phiên bản của Unleash (https://eu.app.unleash-hosted.com/hosted/). |
UNLEASH_MCP_CONFIG_DIR | Không | Thư mục lưu câu trả lời của bạn, feedback_consent.json. Mặc định là thư mục cấu hình của nền tảng. |
send_feedback gửi báo cáo ẩn danh đến Unleash khi máy chủ không đáp ứng được yêu cầu: lỗi công cụ, yêu cầu mà không công cụ nào hỗ trợ hoặc kết quả sai. Báo cáo nêu tên công cụ, lỗi và ứng dụng khách MCP mà tác nhân đang chạy trong đó. Hãy đồng ý để giúp chúng tôi khắc phục những vấn đề bạn gặp phải.
Không có dữ liệu nào được gửi cho đến khi bạn đồng ý. Báo cáo đầu tiên sẽ hỏi bạn thông qua ứng dụng khách MCP, và câu trả lời của bạn được lưu trong feedback_consent.json, nên bạn chỉ được hỏi một lần. Tệp nằm trong thư mục unleash-mcp bên dưới $XDG_CONFIG_HOME nếu biến này được đặt; nếu không, tệp nằm trong ~/Library/Application Support trên macOS, %APPDATA% trên Windows và ~/.config trên Linux. Xóa tệp để được hỏi lại.
Nếu bạn bỏ qua câu hỏi hoặc ứng dụng khách không thể hiển thị câu hỏi, tính năng phản hồi sẽ tắt cho đến phiên tiếp theo. OpenCode, Gemini và Antigravity không bao giờ hiển thị câu hỏi này, vì vậy tính năng phản hồi sẽ tắt trong các ứng dụng đó trừ khi UNLEASH_MCP_SEND_FEEDBACK là true.
Để giữ bí mật khỏi cấu hình ứng dụng khách, hãy sao chép .env.example thành .env, điền thông tin vào đó rồi khởi động máy chủ bằng node --env-file=.env /absolute/path/to/unleash-mcp/src/index.ts.
Kết nối với máy chủ từ xa
Unleash Enterprise lưu trữ máy chủ này qua Streamable HTTP, nên không có gì chạy trên máy của bạn. Quản trị viên bật máy chủ tại Admin > Remote MCP Server; báo cáo send_feedback sẽ được gửi trừ khi quản trị viên tắt tính năng này tại đó.
Đăng ký máy chủ với ứng dụng khách MCP của bạn. Với Claude Code:
claude mcp add unleash https://your-instance.getunleash.io/api/admin/mcp --transport http
Với Codex, hãy thêm máy chủ rồi đăng nhập:
codex mcp add unleash --url https://your-instance.getunleash.io/api/admin/mcp
codex mcp login unleash
Quá trình đăng nhập mở trình duyệt để bạn đăng nhập vào Unleash; Claude Code cũng làm tương tự trong lần sử dụng đầu tiên. Sau đó, Unleash tạo mã thông báo truy cập cá nhân cho ứng dụng khách, có hiệu lực trong 24 giờ, và máy chủ hoạt động với quyền của bạn.
Khi không thể đăng nhập bằng trình duyệt, chẳng hạn trong CI, hãy gửi mã thông báo truy cập cá nhân của riêng bạn thay thế; khi đó sẽ không diễn ra quá trình đăng nhập:
claude mcp add unleash https://your-instance.getunleash.io/api/admin/mcp \
--transport http \
--header "Authorization: Bearer user:your-personal-access-token"
Codex lấy mã thông báo từ một biến môi trường được đặt tên trong config.toml của nó, dưới dạng bearer_token_env_var trong [mcp_servers.unleash].
Phát triển
- Thiết lập môi trường phát triển: chạy kiểm thử và máy chủ phát triển trong Claude Code.
- Các quyết định: lý do máy chủ hoạt động theo cách hiện tại.