Autenticação e Transportes
Autenticação
Cada solicitação ao Scrapeless MCP Server é autenticada com seu Token de API do Scrapeless. Faça login no Scrapeless e copie o token no seu painel.
A forma como você envia o token depende do transporte:
- Stdio — defina-o como a variável de ambiente
SCRAPELESS_API_KEY. - Streamable HTTP — envie-o como o cabeçalho de requisição
x-api-token.
Mantenha o token em segredo: trate-o como uma senha, armazene-o em variáveis de ambiente ou em um gerenciador de segredos e nunca o envie para o controle de versão.
Transportes
O servidor suporta dois modos de transporte. Ambos expõem o mesmo conjunto de ferramentas — a única diferença é onde o servidor é executado e como ele é acessado.
| Stdio | Streamable HTTP | |
|---|---|---|
| Onde é executado | Localmente, iniciado pelo seu cliente via npx | Hospedado pelo Scrapeless |
| Ideal para | Clientes de desktop (Claude Desktop, Cursor, Cline) | Agentes remotos, serverless, plataformas hospedadas |
| Autenticação | Variável de ambiente SCRAPELESS_API_KEY | Cabeçalho x-api-token |
| Pré-requisitos | Node.js + npx disponíveis localmente | Acesso de rede a api.scrapeless.com |
Stdio (execução local)
O cliente inicia o servidor como um subprocesso local:
{
"mcpServers": {
"Scrapeless MCP Server": {
"command": "npx",
"args": ["-y", "scrapeless-mcp-server"],
"env": {
"SCRAPELESS_API_KEY": "YOUR_SCRAPELESS_API_KEY"
}
}
}
}Streamable HTTP (modo de API hospedada)
O cliente se conecta ao endpoint hospedado — nada é executado localmente:
{
"mcpServers": {
"Scrapeless MCP Server": {
"type": "streamable-http",
"url": "https://api.scrapeless.com/mcp",
"headers": {
"x-api-token": "YOUR_SCRAPELESS_API_KEY"
},
"disabled": false,
"alwaysAllow": []
}
}
}Qual devo usar?
- Escolha Stdio para desenvolvimento local e clientes de desktop onde executar
npxé simples. - Escolha Streamable HTTP para agentes hospedados, CI ou qualquer ambiente onde você não possa (ou prefira não) executar um processo Node local.
Para ajustes por sessão, como perfis e tempos limite, consulte Configuração.