Autenticação e Transportes
Autenticação
Cada requisição ao Scrapeless MCP Server é autenticada com seu API Token do Scrapeless. Faça login no Scrapeless e copie o token do seu painel.
A forma como você passa o token depende do transporte:
- Stdio — defina-o como a variável de ambiente
SCRAPELESS_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 inclua no 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 pela Scrapeless |
| Ideal para | Clientes desktop (Claude Desktop, Cursor, Cline) | Agentes remotos, serverless, plataformas hospedadas |
| Autenticação | Variável de ambiente SCRAPELESS_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_KEY": "YOUR_SCRAPELESS_KEY"
}
}
}
}Streamable HTTP (modo 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_KEY"
},
"disabled": false,
"alwaysAllow": []
}
}
}Qual devo usar?
- Escolha Stdio para desenvolvimento local e clientes desktop onde executar
npxé fácil. - Escolha Streamable HTTP para agentes hospedados, CI ou qualquer ambiente onde você não pode (ou prefere não) executar um processo Node local.
Para ajustes por sessão, como perfis e timeouts, consulte Configuração.