Model Context Protocol (MCP)

Carregue contexto sem interrupções para fluxos de trabalho de IA com o Oxylabs Model Context Protocol (MCP). Faça upload de dados, recupere chunks e integre com pipelines no estilo GPT via API.

O Protocolo de Contexto de Modelo (MCP) integração com Web Scraper API da Oxylabs permite a entrega de dados estruturados, prontos para IA, otimizados para fluxos de trabalho de grandes modelos de linguagem (LLM).

MCP garante que contexto, metadados e instruções estejam formatados corretamente, permitindo que LLMs, como o Claude da Anthropic, interpretem e utilizem os dados com eficácia.

Você pode usar facilmente a integração MCP da Web Scraper API com:

• Claude Desktop

• Claude Code

• Cursor

Visite o repositório GitHub da Oxylabs para um exemplo funcional completo de integração MCP com a Web Scraper API.

Configuração com Claude Desktop

Antes de começar, certifique-se de ter Claude Desktop instalado.

Usando Smithery.ai

Instale Node.js e o npm interface de linha de comando. Se você já os tiver instalado, execute o seguinte comando para atualizar o npm para a versão mais recente:

npm install -g npm

Para instalar automaticamente o servidor MCP da Oxylabs para Claude Desktop via Smithery, execute este comando:

npx -y @smithery/cli install @oxylabs/oxylabs-mcp --client claude

Durante o processo de instalação, você será solicitado a inserir seu nome de usuário e senha de usuário da API. Insira essas credenciais quando solicitado.

Assim que a instalação for concluída, abra o Claude Desktop e configure o raspador para começar a usar saídas aprimoradas pelo MCP.

Usando UV

Instale uv, como alternativa ao npm. Consulte o Guia de Início Rápido do Model Context Protocol para entender o processo de configuração.

Para integrar o servidor MCP com Claude Desktop, atualize o claude_desktop_config.json arquivo da seguinte forma:

{
  "mcpServers": {
    "oxylabs_mcp": {
      "command": "uvx",
      "args": ["oxylabs-mcp"],
      "env": {
        "OXYLABS_USERNAME": "your_username",
        "OXYLABS_PASSWORD": "your_password"
      }
    }
  }
}

Substitua your_username e your_password pelo nome de usuário e senha de usuário da API.

Salve as alterações no arquivo de configuração e reinicie o Claude Desktop para garantir que as configurações atualizadas entrem em vigor.

Configuração do CLI do Claude Code

Antes de começar, certifique-se de ter Claude Code instalado.

O Claude Code possui um comando nativo para adicionar servidores MCP diretamente do terminal. Dependendo do gerenciador de pacotes de sua preferência, siga um dos métodos de configuração abaixo.

Usando UV (recomendado)

Instale uv se ainda não o fez. Em seguida, execute o seguinte comando no seu terminal para adicionar o servidor MCP da Oxylabs ao Claude Code:

claude mcp add oxylabs -- command uvx args oxylabs-mcp --env OXYLABS_USERNAME=your_username --env OXYLABS_PASSWORD=your_password

Substitua your_username e your_password pelo nome de usuário e senha de usuário da API.

Usando NPM / NPX

Instale Node.js e npm se ainda não o fez. Se npm já estiver instalado, certifique-se de que esteja atualizado:

npm install -g npm

Em seguida, execute o seguinte comando no seu terminal para adicionar o servidor MCP da Oxylabs ao Claude Code:

claude mcp add oxylabs -- command npx args -y @oxylabs/oxylabs-mcp --env OXYLABS_USERNAME=your_username --env OXYLABS_PASSWORD=your_password

Substitua your_username e your_password pelo nome de usuário e senha de usuário da API.

Observação: Se preferir editar arquivos manualmente, o Claude Code procura seu arquivo de configuração em ~/.config/claude/mcp.json (no Mac/Linux) ou %USERPROFILE%.config\claude\mcp.json (no Windows). A estrutura JSON dentro desse arquivo corresponde ao formato exato usado para o Claude Desktop.

Executando no Cursor

Configurando o Cursor Observação: requer a versão 0.46+ do Cursor

Para configurar a Oxylabs no Cursor:

1. Selecione Cursor → Settings → Cursor Settings → MCP Tools

2. Clique em "Add Custom MCP"

3. Adicione a seguinte configuração:

{
  "mcpServers": {
    "oxylabs": {
      "command": "uvx",
      "args": ["oxylabs-mcp"],
      "env": {
        "OXYLABS_USERNAME": "your_username",
        "OXYLABS_PASSWORD": "your_password",
        "OXYLABS_AI_STUDIO_API_KEY": "your_ai_studio_api_key"
      }
    }
  }
}

Substitua your_username e your_password pelo nome de usuário e senha de usuário da API. Substitua também your_ai_studio_api_key pela sua chave de API do Oxylabs AI Studio.

Depois de adicionar a configuração, atualize a lista de servidores MCP para ver as novas ferramentas. O Composer Agent usará Oxylabs automaticamente quando apropriado, mas você pode solicitá-lo explicitamente descrevendo suas necessidades de web scraping. Acesse o Composer via Command+L (Mac), selecione "Agent" ao lado do botão de envio e insira sua consulta.