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à Transport

Xác thực

Mọi yêu cầu tới 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 transport:

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

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

Transport

Server hỗ trợ hai chế độ transport. Cả hai đều cung cấp bộ công cụ giống hệt nhau — điểm khác biệt duy nhất là nơi server chạy và cách nó được kết nối tới.

StdioStreamable HTTP
Nơi chạyCục bộ, được khởi chạy bởi client của bạn 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_KEYHeader x-api-token
Yêu cầu tiên quyếtCó sẵn Node.js + npx cục bộTruy cập mạng tới api.scrapeless.com

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

Client sinh ra server 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_KEY": "YOUR_SCRAPELESS_KEY"
      }
    }
  }
}

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

Client kết nối tới 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_KEY"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Tôi nên dùng cái nào?

  • Chọn Stdio cho 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 từng phiên như profile và timeout, xem Cấu hình.