MCP Server

SocialGO MCP server là gì?

SocialGO MCP server phơi bày panel dưới dạng một bộ công cụ cho các agent AI qua Model Context Protocol. Sau khi kết nối, một trợ lý có thể duyệt danh mục dịch vụ, đặt và theo dõi đơn hàng, yêu cầu bù đắp và quản lý số dư, mà không cần code kết nối tùy chỉnh. Đó là một lớp đọc-và-hành-động mỏng trên cùng API mà bảng điều khiển của bạn dùng, nên các agent luôn nằm trong giới hạn và giá cả của tài khoản bạn.

Nó hoạt động với bất kỳ client hỗ trợ MCP nào, bao gồm Claude Desktop, Claude Code, Cursor và các agent của riêng bạn xây trên một MCP SDK.

Thêm nó vào client của bạn

Server được phát hành dưới dạng gói @socialgo/mcp và chạy qua stdio bằng npx, nên không có gì để cài hay tự lưu trữ. Thêm mục sau vào cấu hình MCP client của bạn:

{
  "mcpServers": {
    "socialgo": {
      "command": "npx",
      "args": ["-y", "@socialgo/mcp"],
      "env": {
        "SOCIALGO_API_KEY": "your_api_key_here"
      }
    }
  }
}

Với Claude Code bạn có thể đăng ký nó bằng một lệnh duy nhất từ terminal của mình:

claude mcp add socialgo -- npx @socialgo/mcp

Sau khi thêm, hãy nhớ đặt SOCIALGO_API_KEY trong môi trường để lệnh ở trên có thể lấy được nó.

Xác thực

Server đọc một biến môi trường duy nhất, SOCIALGO_API_KEY. Tạo một key từ cài đặt tài khoản của bạn, giữ nó bí mật và không bao giờ commit nó vào kiểm soát mã nguồn. Mọi lệnh gọi công cụ đều được xác thực và cấp quyền bằng key này, và đơn hàng được tính phí vào số dư tài khoản tương ứng. Xoay key từ bảng điều khiển của bạn bất cứ lúc nào để thu hồi quyền truy cập.

Công cụ cốt lõi

Server giữ một giao diện công cụ nhỏ, ổn định bao trùm toàn bộ vòng đời đơn hàng:

• search_services — Tìm dịch vụ theo nền tảng, loại hoặc từ khóa. Đây là điểm khởi đầu cho mọi quy trình.
• get_service — Lấy chi tiết đầy đủ cho một dịch vụ: đơn giá, số lượng tối thiểu/tối đa và các tùy chọn được hỗ trợ.
• create_order — Đặt một đơn hàng cho một dịch vụ vào một liên kết hoặc tên người dùng đích.
• order_status — Kiểm tra trạng thái trực tiếp, tiến độ và số lượng còn lại của một đơn hàng.
• balance — Đọc số dư tài khoản hiện tại và tiền tệ.
• refill — Yêu cầu bù đắp cho một đơn hàng đủ điều kiện đã tụt xuống dưới lượng đã giao.
• cancel — Hủy một đơn hàng vẫn còn hủy được và thu hồi số tiền còn lại.
• list_orders — Xem qua các đơn hàng gần đây theo trang cùng trạng thái hiện tại của chúng.
• add_funds — Tạo một ý định nạp tiền để thêm số dư vào tài khoản.

Thiết kế "tìm-rồi-hành-động"

Một SMM panel điển hình mang hàng nghìn dịch vụ trên hàng chục nền tảng. Đăng ký một công cụ cho mỗi dịch vụ sẽ làm tràn danh sách công cụ của agent, làm nổ cửa sổ ngữ cảnh và khiến mô hình chậm hơn, kém chính xác hơn. SocialGO tránh điều này hoàn toàn.

Thay vào đó, danh mục nằm phía sau một công cụ khám phá duy nhất. Agent trước tiên gọi search_services để thu hẹp hàng nghìn lựa chọn xuống còn một nhúm kết quả phù hợp, xem xét một dịch vụ bằng get_service, và chỉ sau đó mới hành động với create_order. Cùng chín công cụ đó bao trùm toàn bộ danh mục dù nó lớn đến đâu, nên việc thêm dịch vụ mới ở backend không bao giờ thay đổi giao diện công cụ mà agent nhìn thấy.

Một luồng hoàn chỉnh trông như thế này:

1. search_services({ query: "instagram followers" })
   → returns a short list of matching services with ids + rates

2. get_service({ id: "<id>" })
   → confirms rate, min/max and options before spending

3. create_order({ id: "<id>", link: "<target>", quantity: 1000 })
   → returns an order id

4. order_status({ id: "<order_id>" })
   → poll until completed

Điều này giữ danh sách công cụ nhỏ gọn và dễ đoán, cho phép danh mục mở rộng đến hàng nghìn dịch vụ, và trao cho agent một bước xác-nhận-trước-khi-chi đáng tin cậy mỗi lần.