Configuração

Além do token da API, você pode personalizar como o Scrapeless MCP executa cada sessão. As opções são fornecidas como variáveis de ambiente (Stdio) ou cabeçalhos HTTP (Streamable HTTP) — as duas formas possuem correspondência direta.

Opções de sessão

Stdio (Var. de Ambiente)	Streamable HTTP (Cabeçalho)	Descrição
`SCRAPELESS_API_KEY`	`x-api-token`	Obrigatório. Seu token da API Scrapeless.
`BROWSER_PROFILE_ID`	`x-browser-profile-id`	ID de perfil de navegador reutilizável para manter a continuidade da sessão entre execuções.
`BROWSER_PROFILE_PERSIST`	`x-browser-profile-persist`	Habilita o armazenamento persistente para cookies, armazenamento local e outros estados do navegador.
`BROWSER_SESSION_TTL`	`x-browser-session-ttl`	Tempo limite máximo da sessão em segundos. A sessão expira após esse período de inatividade.

Exemplos

Stdio — perfil persistente com TTL de 5 minutos

{
  "mcpServers": {
    "Scrapeless MCP Server": {
      "command": "npx",
      "args": ["-y", "scrapeless-mcp-server"],
      "env": {
        "SCRAPELESS_API_KEY": "YOUR_SCRAPELESS_API_KEY",
        "BROWSER_PROFILE_ID": "my-profile",
        "BROWSER_PROFILE_PERSIST": "true",
        "BROWSER_SESSION_TTL": "300"
      }
    }
  }
}

Streamable HTTP — mesmas opções como cabeçalhos

{
  "mcpServers": {
    "Scrapeless MCP Server": {
      "type": "streamable-http",
      "url": "https://api.scrapeless.com/mcp",
      "headers": {
        "x-api-token": "YOUR_SCRAPELESS_API_KEY",
        "x-browser-profile-id": "my-profile",
        "x-browser-profile-persist": "true",
        "x-browser-session-ttl": "300"
      }
    }
  }
}

Dicas

Perfis permitem que um agente mantenha uma sessão com login ativo entre várias execuções — defina o mesmo BROWSER_PROFILE_ID a cada vez e habilite a persistência.
TTL equilibra custo e continuidade: TTLs mais curtos liberam recursos de nuvem mais rapidamente; TTLs mais longos mantêm uma sessão ativa disponível para solicitações subsequentes.
As opções omitidas retornam aos padrões do Scrapeless, portanto, você só precisa definir o que deseja alterar.

Para um guia completo sobre transportes e autenticação, consulte Autenticação e Transportes.

Autenticação e transportes Claude Desktop / Claude Code