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

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.

StdioStreamable HTTP
Onde é executadoLocalmente, iniciado pelo seu cliente via npxHospedado pelo Scrapeless
Ideal paraClientes de desktop (Claude Desktop, Cursor, Cline)Agentes remotos, serverless, plataformas hospedadas
AutenticaçãoVariável de ambiente SCRAPELESS_API_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_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.