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ó.
| Stdio | Streamable HTTP | |
|---|---|---|
| Nơi chạy | Cụ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 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_API_KEY | Header x-api-token |
| Điều kiện tiên quyết | Node.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
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 phiên như hồ sơ và thời gian chờ, hãy xem Cấu hình.