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.
| Stdio | Streamable HTTP | |
|---|---|---|
| Nơi chạy | Cụ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 cho | Client 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ực | Biến môi trường SCRAPELESS_KEY | Header x-api-token |
| Yêu cầu tiên quyết | Có 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
npxdễ 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.