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 Protocolo de Contexto do Modelo cliente) à web do mundo real.

Depois de conectado, seu assistente pode fazer scraping de 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á registrado oficialmente 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 gratuito disponível)	ferramentas da Web Scraper API
chave de API do AI Studio	Configurações do AI Studio (créditos gratuitos incluídos)	ferramentas do AI Studio

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

Ferramentas disponíveis

Ferramenta	O que ela faz	Requer
universal_scraper	Faz scraping de qualquer URL. Renderização JavaScript opcional, geo-targeting, saída em Markdown/HTML	Web Scraper API
Resultados da Pesquisa Google, opcionalmente analisados em JSON estruturado	Páginas de resultados de pesquisa da Amazon, opcionalmente analisadas	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 múltiplas páginas e coleta de dados guiados por prompt	AI Studio
ai_browser_agent	Controle de navegador guiado por prompt: navegar, clicar, preencher formulários	AI Studio
ai_search	Pesquisa na web com conteúdo Markdown opcional 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
Endpoint	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 conseguem 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 solicitação:

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

Observação: 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"

Omitir um --header se você não tiver essa credencial.

Claude Desktop

O editor de configuração integrado do Claude Desktop usa servidores locais (comando) servidores. Para o endpoint hospedado, use o 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 (apenas 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, depois confirme se o servidor está ativado em Personalizar → MCPs.

Observação: Usuário escreve em ~/.cursor/mcp.json. Espaço de trabalho 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 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 apenas as que você tiver):

Variável	Descrição
OXYLABS_USERNAME	nome de usuário da Web Scraper API
OXYLABS_PASSWORD	senha da 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 o Claude Code: ~/.config/claude/mcp.json (macOS/Linux) ou %USERPROFILE%\.config\claude\mcp.json (Windows). O formato JSON é igual ao do Claude Desktop.

Claude Desktop

1. Abra Claude → Configurações → Desenvolvedor → Editar configuração
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 (apenas 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, depois confirme se o servidor está ativado em Personalizar → MCPs.

Observação: Usuário escreve em ~/.cursor/mcp.json. Espaços de trabalho 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, “Faça scraping de https://ip.oxylabs.io e retorne o conteúdo em Markdown.”):

1

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

2

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

3

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

Solução de problemas

Erro	Solução
Servidor ausente no cliente	Reinicie o aplicativo após editar a configuração. Confirme se o JSON é válido.
Ferramentas listadas, mas as chamadas falham	Credenciais de placeholder, Base64 incorreto ou header/env 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 verifique se ele está no seu PATH.
O caminho da 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].