Configuração

Além do token de 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 se mapeiam uma para a outra.

Opções de sessão

Stdio (Variável de Ambiente)	Streamable HTTP (Cabeçalho)	Descrição
`SCRAPELESS_KEY`	`x-api-token`	Obrigatório. Seu token de API do Scrapeless.
`BROWSER_PROFILE_ID`	`x-browser-profile-id`	ID de perfil de navegador reutilizável para continuidade de sessão entre execuções.
`BROWSER_PROFILE_PERSIST`	`x-browser-profile-persist`	Habilita o armazenamento persistente de cookies, local storage 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_KEY": "YOUR_SCRAPELESS_KEY",
        "BROWSER_PROFILE_ID": "my-profile",
        "BROWSER_PROFILE_PERSIST": "true",
        "BROWSER_SESSION_TTL": "300"
      }
    }
  }
}

Streamable HTTP — as 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_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 autenticada 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 na nuvem mais cedo; TTLs mais longos mantêm uma sessão aquecida disponível para solicitações subsequentes.
Opções omitidas voltam aos padrões do Scrapeless, então você só precisa definir o que deseja alterar.

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

Autenticação e transportes Claude Desktop / Claude Code