Integração com MCP

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

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

Visite o repositório da Oxylabs no GitHub para um exemplo completo e funcional de integração do MCP com o Oxylabs Unblocking 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 Unblocking Browser com o MCP, você pode aproveitar sistemas de IA para executar navegação na web, recuperação de dados e automação tarefas usando navegadores remotos com capacidades avançadas de furtividade e integração com Residential Proxy integração.

O host MCP (como Claude Desktop ou Cursor) já inclui um cliente MCP embutido. O Playwright-MCP atua como um servidor MCP e, em vez de usar um navegador local, ele se conecta ao Unblocking Browser via uma conexão WebSocket segura (WSS).

Primeiros passos

Antes de configurar a integração, certifique-se de que você tem:

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

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

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

• Windows: baixar e instalar a partir de nodejs.org

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

• Linux:

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

  • Fedora: sudo dnf install nodejs npm

  • Ou baixe a partir de nodejs.org

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

Configurar servidor MCP

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

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

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

1. Abra o Cursor

2. Abra as configurações do Cursor

3. Selecione MCP

4. Adicione a configuração de servidor MCP preparada

5. Reinicie o Cursor

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

1. Abra o Claude Desktop

2. Abra as configurações do Claude Desktop

3. Navegue até Developer

4. Pressione Edit Config

5. Edite o claude_desktop_config.json arquivo

6. Adicione a configuração de servidor MCP preparada

7. Reinicie o Claude Desktop

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

Seleção de país

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

"oxylabs_unblocking_browser": {
  "command": "npx",
  "args": [
    "@playwright/mcp@latest",
    "--cdp-endpoint",
    "wss://<username>:<password>@ubc.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á automaticamente um 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_unblocking_browser": {
  "command": "npx",
  "args": [
    "@playwright/mcp@latest",
    "--cdp-endpoint",
    "wss://<username>:<password>@ubc-us.oxylabs.io"
  ]
}

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

Argumentos do navegador (apenas Chrome)

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

"oxylabs_unblocking_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"
  ]
}

Argumentos suportados incluem:

• force-color-profile:<profile>: Força todos os monitores a serem tratados como se tivessem o perfil de cor especificado

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

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

• enable-features:<feature1>,<feature2>,<feature3>: Lista separada por vírgulas de nomes de recursos para habilitar

• disable-notifications: Desabilita as APIs de Notificação Web e Push

Solução de problemas

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

1. Problemas de conexão:

   • Verifique suas credenciais Oxylabs

   • Verifique sua conexão de rede

   • Garanta que firewalls não estejam bloqueando conexões WebSocket

2. Problemas de desempenho:

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

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

3. Navegador não carregando:

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

   • Verifique se o npx está devidamente instalado

   • Reinicie o aplicativo host MCP