SnapDeploy MCP

@snapdeploy/mcp

Triển khai và quản lý các container SnapDeploy từ trợ lý AI của bạn — Claude Code, Claude Desktop, Cursor, Windsurf, Codex CLI, Gemini CLI, hoặc bất kỳ client nào hỗ trợ Model Context Protocol qua stdio.

Nói "triển khai repo này lên SnapDeploy" và nhận về một URL trực tiếp. Build, log, biến môi trường, cơ sở dữ liệu được quản lý và tên miền tùy chỉnh — mà không cần rời khỏi cuộc trò chuyện.

Thiết lập

1. Đăng nhập tại snapdeploy.dev, mở API Keys và tạo một token với phạm vi deploy (trang sẽ tạo các đoạn mã bên dưới với token của bạn đã được điền sẵn).
2. Thêm server vào client của bạn:

Claude Code

claude mcp add --scope user snapdeploy -e SNAPDEPLOY_API_KEY=sd_pat_your_token -- npx -y @snapdeploy/mcp

Cursor (~/.cursor/mcp.json), Windsurf (~/.codeium/windsurf/mcp_config.json), Gemini CLI (~/.gemini/settings.json), Claude Desktop và các client cấu hình JSON khác:

{
  "mcpServers": {
    "snapdeploy": {
      "command": "npx",
      "args": ["-y", "@snapdeploy/mcp"],
      "env": { "SNAPDEPLOY_API_KEY": "sd_pat_your_token" }
    }
  }
}

Codex CLI (~/.codex/config.toml):

[mcp_servers.snapdeploy]
command = "npx"
args = ["-y", "@snapdeploy/mcp"]
env = { SNAPDEPLOY_API_KEY = "sd_pat_your_token" }

Plugin Claude Code (token được lưu trong bộ nhớ an toàn thay vì tệp cấu hình):

/plugin marketplace add AAR-Labs/snapdeploy-mcp
/plugin install snapdeploy@snapdeploy

Khởi động lại phiên; các công cụ snapdeploy sẽ xuất hiện. Kho lưu trữ của bạn phải nằm trên GitHub và GitHub phải được kết nối với SnapDeploy một lần (trình kết nối sẽ trả về liên kết nếu chưa kết nối).

Công cụ

Phạm vi	Công cụ
read	list_apps get_status get_logs get_deployments check_quota list_repos detect_env_vars
deploy	deploy deploy_image set_env start_container stop_container wake_container
manage	create_database add_domain assign_always_on

Các phạm vi lồng nhau (read ⊂ deploy ⊂ manage); server thực thi chúng trước khi bất kỳ công cụ nào chạy. Không có công cụ xóa, và server từ chối các thao tác xóa, hủy đăng ký và thay đổi mật khẩu cho mọi token — những thao tác đó cần một người đăng nhập vào bảng điều khiển hoặc ứng dụng di động.

Hình ảnh dựng sẵn. deploy build từ một kho GitHub đã kết nối; không có công cụ hình ảnh. Để chạy một Docker image công khai, hãy sử dụng bảng điều khiển (Deploy Your Application → Docker Image) hoặc POST /api/mobile/containers với name, image, imageTag, port, sau đó là POST /api/mobile/containers/{containerId}/start. Hình ảnh phải đến từ Docker Hub, ghcr.io, quay.io hoặc public.ecr.aws, xuất bản linux/amd64 hoặc linux/arm64, và vượt qua kiểm tra chính sách lúc tạo của SnapDeploy; một 400 Security policy violation là quyết định cuối cùng và không được thử lại. Quy tắc đầy đủ: https://snapdeploy.dev/llms-full.md

Mô hình an toàn

• Không có gì phá hoại, bao giờ. Ngay cả một agent leo thang lên lệnh gọi API thô với cùng token cũng nhận được 403 INTERACTIVE_SESSION_REQUIRED.
• Bí mật không bao giờ đến được mô hình. Giá trị biến môi trường trả về dưới dạng (set) và thông tin xác thực được che — trên server, không chỉ trong trình kết nối này.
• Token có phạm vi, hết hạn, thu hồi được với giới hạn tốc độ riêng. Thu hồi trên trang API Keys và mọi yêu cầu sẽ trả về 401 kể từ thời điểm đó.
• Triển khai an toàn khi thử lại. Các yêu cầu giống hệt nhau trong vòng mười phút trả về bản triển khai ban đầu thay vì bắt đầu một build mới.
• Giới hạn gói được chuyển tiếp, không thử lại. Các phản hồi 402/429 mang thông điệp riêng của SnapDeploy và liên kết nâng cấp, và trợ lý được yêu cầu không thử lại.

Biến môi trường

Biến	Bắt buộc	Ý nghĩa
SNAPDEPLOY_API_KEY	có	Token có phạm vi (sd_pat_…) hoặc API key kế thừa
SNAPDEPLOY_READ_ONLY	không	1 chỉ hiển thị các công cụ đọc
SNAPDEPLOY_BASE_URL	không	Mặc định là https://snapdeploy.dev

Liên kết

• Hướng dẫn: Claude Code · Cursor · Codex / Gemini CLI · Xuất từ Lovable
• Tài liệu tham khảo: snapdeploy.dev/docs/mcp · API
• Bài viết thiết kế: vì sao một agent có thể triển khai thì không được phép xóa

MIT © AAR Labs