Protocolo de Contexto do Modelo (MCP)

Use o MCP da Oxylabs para fornecer a assistentes de IA ferramentas de scraping web, busca e extração em tempo real por meio do Web Scraper API e do AI Studio.

O servidor MCP da Oxylabs conecta assistentes de IA (Claude, Cursor, e qualquer outro Model Context Protocol cliente) à web do mundo real.

Depois de conectado, seu assistente pode raspar qualquer URL (inclui renderização JavaScript e segmentação geográfica), pesquisar na web, rastrear sites e extrair dados estruturados.

Código-fonte aberto e registro: Veja o código-fonte no GitHub. O servidor está oficialmente registrado no MCP Registry (io.oxylabs/oxylabs-mcp), PyPI, e Smithery.

Pré-requisitos

Você precisa de pelo menos um conjunto de credenciais para desbloquear suas ferramentas correspondentes. Fornecer ambos desbloqueia todas as ferramentas listadas abaixo.

Credenciais	Onde obter	Desbloqueia
Web Scraper API nome de usuário & senha	painel da Oxylabs (teste grátis disponível)	ferramentas do Web Scraper API
chave de API do AI Studio	Configurações do AI Studio (créditos grátis incluídos)	ferramentas do AI Studio

Configure apenas as credenciais que você realmente tiver. Valores placeholder expõem ferramentas que falharão quando chamadas.

Ferramentas disponíveis

Ferramenta	O que faz	Requer
universal_scraper	Raspa qualquer URL. Renderização JavaScript opcional, segmentação geográfica, saída em Markdown/HTML	Web Scraper API
google_search_scraper	Resultados da Pesquisa Google, opcionalmente analisados em JSON estruturado	Web Scraper API
amazon_search_scraper	Páginas de resultados de pesquisa da Amazon, opcionalmente analisadas	Web Scraper API
amazon_product_scraper	Páginas individuais de produto da Amazon	Web Scraper API
ai_scraper	Extração com IA de qualquer URL (JSON, CSV, Markdown, TOON)	AI Studio
ai_crawler	Rastreamento de várias páginas e coleta de dados guiados por prompt	AI Studio
ai_browser_agent	Controle do navegador guiado por prompt: navegar, clicar, preencher formulários	AI Studio
ai_search	Pesquisa na web com conteúdo opcional em Markdown de cada resultado	AI Studio
ai_map	Mapeia URLs de sites	AI Studio
generate_schema	Gera esquemas de extração personalizados para as ferramentas do AI Studio	AI Studio

Escolha como conectar

	Servidor hospedado (recomendado)	Servidor local
Instalar	Nenhum	uv + uvx oxylabs-mcp
Ponto de extremidade	https://mcp.oxylabs.io/mcp	Cursor/Claude iniciam o processo
Credenciais	Cabeçalhos HTTP	Variáveis de ambiente
Melhor para	Configuração mais rápida, sem gerenciamento	Controle offline, depuração local, clientes que não podem enviar cabeçalhos personalizados

Método 1: Servidor hospedado (recomendado)

Conecte-se ao servidor MCP hospedado da Oxylabs:

https://mcp.oxylabs.io/mcp

Passe as credenciais como cabeçalhos da requisição:

Credencial	Cabeçalho
Web Scraper API	Authorization: Basic <base64(username:password)>
AI Studio	X-Oxylabs-AI-Studio-Api-Key: <your API key>

Nota: Inclua apenas os cabeçalhos das credenciais que você tiver.

Claude Code

Instale diretamente na linha de comando:

claude mcp add --transport http oxylabs https://mcp.oxylabs.io/mcp \
  --header "Authorization: Basic $(echo -n 'YOUR_USERNAME:YOUR_PASSWORD' | base64)" \
  --header "X-Oxylabs-AI-Studio-Api-Key: YOUR_API_KEY"

Omita uma --header linha se você não tiver essa credencial.

Claude Desktop

O editor de configuração integrado do Claude Desktop usa servidores locais (command) . Para o endpoint hospedado, use Claude Code com o comando HTTP acima, ou execute o servidor localmente e aponte o Claude Desktop para essa configuração.

Cursor

1. Abra Configurações do Cursor → Personalizar na barra lateral → MCPs
2. Clique em + Novo
3. Escolha Usuário (todos os projetos) ou Projeto (somente no workspace)
4. Adicione o seguinte ao mcp.json:

   {
     "mcpServers": {
       "oxylabs": {
         "url": "https://mcp.oxylabs.io/mcp",
         "headers": {
           "Authorization": "Basic <base64 of username:password>",
           "X-Oxylabs-AI-Studio-Api-Key": "YOUR_API_KEY"
         }
       }
     }
   }

5. Salve e, em seguida, confirme que o servidor está ativado em Personalizar → MCPs.

Nota: Usuário escreve em ~/.cursor/mcp.json. Workspace escreve em .cursor/mcp.json no workspace escolhido. Se ambos definirem o mesmo nome de servidor, a configuração do workspace tem prioridade.

Método 2: Servidor local

O servidor está disponível em nosso repositório PyPI.

Se ainda não estiver instalado, instale o pacote uv de acordo com o sistema operacional escolhido:

macOS / Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

As credenciais são passadas como variáveis de ambiente (defina somente as que você tiver):

Variável	Descrição
OXYLABS_USERNAME	nome de usuário do Web Scraper API
OXYLABS_PASSWORD	senha do Web Scraper API
OXYLABS_AI_STUDIO_API_KEY	chave de API do AI Studio

Claude Code

claude mcp add oxylabs -- command uvx args oxylabs-mcp \
  --env OXYLABS_USERNAME=YOUR_USERNAME \
  --env OXYLABS_PASSWORD=YOUR_PASSWORD \
  --env OXYLABS_AI_STUDIO_API_KEY=YOUR_API_KEY

Caminho de configuração manual para Claude Code: ~/.config/claude/mcp.json (macOS/Linux) ou %USERPROFILE%\.config\claude\mcp.json (Windows). A estrutura JSON corresponde ao Claude Desktop.

Claude Desktop

1. Abra Claude → Configurações → Desenvolvedor → Editar Config
2. Adicione o seguinte a claude_desktop_config.json:

   {
     "mcpServers": {
       "oxylabs": {
         "command": "uvx",
         "args": ["oxylabs-mcp"],
         "env": {
           "OXYLABS_USERNAME": "YOUR_USERNAME",
           "OXYLABS_PASSWORD": "YOUR_PASSWORD",
           "OXYLABS_AI_STUDIO_API_KEY": "YOUR_API_KEY"
         }
       }
     }
   }

3. Reinicie o Claude Desktop

Cursor

1. Abra Configurações do Cursor → Personalizar na barra lateral → MCPs
2. Clique em + Novo
3. Escolha Usuário (todos os projetos) ou Projeto (somente no workspace)
4. Adicione o seguinte ao mcp.json:

   {
     "mcpServers": {
       "oxylabs": {
         "command": "uvx",
         "args": ["oxylabs-mcp"],
         "env": {
           "OXYLABS_USERNAME": "YOUR_USERNAME",
           "OXYLABS_PASSWORD": "YOUR_PASSWORD",
           "OXYLABS_AI_STUDIO_API_KEY": "YOUR_API_KEY"
         }
       }
     }
   }

5. Salve e, em seguida, confirme que o servidor está ativado em Personalizar → MCPs.

Nota: Usuário escreve em ~/.cursor/mcp.json. Workspaces escreve em .cursor/mcp.json no workspace escolhido. Se ambos definirem o mesmo nome de servidor, a configuração do workspace tem prioridade.

Verifique a configuração

Depois de conectar, peça ao seu assistente algo que exija dados da web em tempo real (por exemplo, “Raspe https://ip.oxylabs.io e retorne o conteúdo como Markdown.”):

1

Confirme que o oxylabs servidor aparece e está ativado na lista MCP do seu cliente.

2

Aprove a chamada da ferramenta quando solicitado (os clientes pedem confirmação antes de executar ferramentas MCP por padrão).

3

Se a chamada falhar, verifique as credenciais e os logs do cliente (Cursor: Saída → MCP Logs).

Solução de problemas

Erro	Solução
Servidor ausente no cliente	Reinicie o app após editar a configuração. Confirme que o JSON é válido.
Ferramentas listadas, mas as chamadas falham	Credenciais placeholder, Base64 incorreto ou cabeçalho/variável de ambiente ausente para essa ferramenta.
A URL hospedada não conecta	O cliente pode não suportar cabeçalhos personalizados; use a configuração local.
uvx comando não encontrado	Instalar uv e certifique-se de que ele esteja no seu PATH.
O caminho na interface do Cursor parece diferente	Ignore a interface e edite mcp.json diretamente (os rótulos podem mudar entre versões do Cursor).

Para problemas ou solicitações de recurso, abra um issue no GitHub ou contate o suporte 24/7 da Oxylabs em [e-mail].