Integração com MCP

O Headless Browser pode ser usado com MCP, permitindo que sistemas de IA controlem navegadores remotos. Saiba mais sobre essa integração.

Este guia explica como integrar Oxylabs Headless Browser com MCP (Model Context Protocol) para permitir que sistemas de IA interajam com e controlem navegadores remotos.

Visite o repositório GitHub da Oxylabs para um exemplo completo e funcional de integração do MCP com o Oxylabs Headless Browser.

Visão geral

O Model Control Protocol (MCP) permite que sistemas de IA como o Claude interajam com navegadores e executem tarefas baseadas na web. Ao integrar Oxylabs Headless Browser com MCP, você pode usar sistemas de IA para executar navegação na web, recuperação de dados e automação de tarefas usando navegadores remotos com recursos avançados de stealth e Residential Proxy integração.

O host MCP (como Claude Desktop ou Cursor) vem com um cliente MCP integrado. O Playwright-MCP atua como um servidor MCP e, em vez de usar um navegador local, ele se conecta ao Headless Browser por meio de uma conexão WebSocket segura (WSS).

Primeiros passos

Antes de configurar a integração, certifique-se de ter:

1. conta Oxylabs: obtenha seu nome de usuário e senha para o Oxylabs Headless Browser.

Por enquanto, você pode obter o Headless Browser com nossa equipe de vendas em [email protected].

1. Node.js: versão 18.0.0 ou superior (inclui npm/npx)

• Windows: baixe e instale em nodejs.org

• macOS: use o Homebrew (brew install node) ou baixe em nodejs.org

• Linux:

  • Ubuntu/Debian: sudo apt update && sudo apt install nodejs npm

  • Fedora: sudo dnf install nodejs npm

  • Ou baixe em nodejs.org

1. MCP Host: o Claude Desktop ou o Cursor instalado.

Configurar servidor MCP

Crie um bloco de configuração do servidor MCP com suas credenciais da Oxylabs. Substitua <username> e <password> pelas suas credenciais reais da Oxylabs:

"oxylabs_headless_browser": {
  "command": "npx",
  "args": [
    "@playwright/mcp@latest",
    "--cdp-endpoint",
    "wss://<username>:<password>@ubs.oxylabs.io"
  ]
}

Opção 1: integração com Cursor

1. Abrir o Cursor

2. Abrir as configurações do Cursor

3. Selecionar MCP

4. Adicionar a configuração preparada do servidor MCP

5. Reiniciar o Cursor

Opção 2: integração com o Claude Desktop

1. Abrir o Claude Desktop

2. Abrir as configurações do Claude Desktop

3. Acessar Developer

4. Pressionar Edit Config

5. Editar o arquivo claude_desktop_config.json arquivo

6. Adicionar a configuração preparada do servidor MCP

7. Reiniciar o Claude Desktop

Opções avançadas de configuração

Seleção de país

Você pode especificar um país para a sessão do navegador adicionando o ?p_cc parâmetro à sua URL de conexão:

"oxylabs_headless_browser": {
  "command": "npx",
  "args": [
    "@playwright/mcp@latest",
    "--cdp-endpoint",
    "wss://<username>:<password>@ubs.oxylabs.io?p_cc=US"
  ]
}

Substitua US pelo código de país SO-3166 desejado. Se nenhum país for especificado, o sistema atribuirá um automaticamente com base na disponibilidade.

Você pode encontrar a lista de códigos de país ISO-3166 aqui.

Infraestrutura baseada nos EUA

Para usuários que operam principalmente nos EUA, você pode se conectar diretamente à infraestrutura baseada nos EUA para tempos de carregamento mais rápidos:

"oxylabs_headless_browser": {
  "command": "npx",
  "args": [
    "@playwright/mcp@latest",
    "--cdp-endpoint",
    "wss://<username>:<password>@ubs-us.oxylabs.io"
  ]
}

Essa solução reduz principalmente o tempo de resposta para usuários baseados nos EUA e não deve ser confundida com a seleção de geolocalização de proxy.

Argumentos do navegador (somente Chrome)

Para o Headless Browser baseado em Chrome, você pode especificar argumentos adicionais do navegador usando o bargs parâmetro:

"oxylabs_headless_browser": {
  "command": "npx",
  "args": [
    "@playwright/mcp@latest",
    "--cdp-endpoint",
    "wss://<username>:<password>@ubc.oxylabs.io/?bargs=force-color-profile:srgb&bargs=window-position:100,100"
  ]
}

Os argumentos compatíveis incluem:

• force-color-profile:<profile>: força que todos os monitores sejam tratados como se tivessem o perfil de cores especificado

• window-position:X,Y: especifica a posição inicial da janela

• hide-scrollbars: impede a criação de barras de rolagem para conteúdo da web

• enable-features:<feature1>,<feature2>,<feature3>: lista de nomes de recursos a serem ativados, separados por vírgula

• disable-notifications: desativa as APIs Web Notification e Push

Solução de problemas

Se você encontrar problemas com a integração:

1. Problemas de conexão:

   • Verifique suas credenciais da Oxylabs

   • Verifique sua conexão de rede

   • Certifique-se de que os firewalls não estejam bloqueando conexões WebSocket

2. Problemas de desempenho:

   • Para usuários baseados nos EUA, tente os endpoints específicos dos EUA

   • Aumente os timeouts na sua configuração, se necessário

3. O navegador não está carregando:

   • Verifique a versão do Node.js (deve ser 18.0.0 ou superior)

   • Verifique se o npx está instalado corretamente

   • Reinicie o aplicativo host MCP