DocumentaçãoFerramentas para desenvolvedoresScrapeless MCPAutenticação e transportes

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.

StdioStreamable HTTP
Onde é executadoLocalmente, iniciado pelo seu cliente via npxHospedado pela Scrapeless
Ideal paraClientes desktop (Claude Desktop, Cursor, Cline)Agentes remotos, serverless, plataformas hospedadas
AutenticaçãoVariável de ambiente SCRAPELESS_KEYCabeçalho x-api-token
Pré-requisitosNode.js + npx disponíveis localmenteAcesso 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.