Tài liệuCông cụ dành cho nhà phát triểnScrapeless MCPXác thực và phương thức truyền tải

Xác thực và Phương thức truyền tải

Xác thực

Mọi yêu cầu gửi đến Scrapeless MCP Server đều được xác thực bằng API Token của Scrapeless. Đăng nhập vào Scrapeless và sao chép token từ bảng điều khiển của bạn.

Cách bạn truyền token phụ thuộc vào phương thức truyền tải:

  • Stdio — thiết lập nó dưới dạng biến môi trường SCRAPELESS_API_KEY.
  • Streamable HTTP — gửi nó dưới dạng header yêu cầu x-api-token.

Giữ bí mật token: coi nó như mật khẩu, lưu trữ trong biến môi trường hoặc trình quản lý secret, và không bao giờ commit nó vào hệ thống kiểm soát mã nguồn.

Phương thức truyền tải

Máy chủ hỗ trợ hai chế độ truyền tải. Cả hai đều cung cấp bộ công cụ giống hệt nhau — sự khác biệt duy nhất nằm ở nơi máy chủ chạy và cách truy cập đến nó.

StdioStreamable HTTP
Nơi chạyCục bộ, được khởi chạy bởi client của bạn thông qua npxĐược lưu trữ bởi Scrapeless
Phù hợp nhất choClient máy tính để bàn (Claude Desktop, Cursor, Cline)Agent từ xa, serverless, nền tảng được lưu trữ
Xác thựcBiến môi trường SCRAPELESS_API_KEYHeader x-api-token
Điều kiện tiên quyếtNode.js + npx khả dụng cục bộQuyền truy cập mạng đến api.scrapeless.com

Stdio (thực thi cục bộ)

Client sẽ khởi chạy máy chủ dưới dạng một tiến trình con cục bộ:

{
  "mcpServers": {
    "Scrapeless MCP Server": {
      "command": "npx",
      "args": ["-y", "scrapeless-mcp-server"],
      "env": {
        "SCRAPELESS_API_KEY": "YOUR_SCRAPELESS_API_KEY"
      }
    }
  }
}

Streamable HTTP (chế độ API được lưu trữ)

Client kết nối đến endpoint được lưu trữ — không có gì chạy cục bộ:

{
  "mcpServers": {
    "Scrapeless MCP Server": {
      "type": "streamable-http",
      "url": "https://api.scrapeless.com/mcp",
      "headers": {
        "x-api-token": "YOUR_SCRAPELESS_API_KEY"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Tôi nên sử dụng cái nào?

  • Chọn Stdio cho việc phát triển cục bộ và các client máy tính để bàn nơi việc chạy npx dễ dàng.
  • Chọn Streamable HTTP cho các agent được lưu trữ, CI, hoặc bất kỳ môi trường nào mà bạn không thể (hoặc không muốn) chạy một tiến trình Node cục bộ.

Để tinh chỉnh theo phiên như hồ sơ và thời gian chờ, hãy xem Cấu hình.