# Integração com MCP
Este guia explica como integrar [**Oxylabs Headless Browser**](https://oxylabs.io/products/headless-browser) com MCP (Model Context Protocol) para permitir que sistemas de IA interajam com e controlem navegadores remotos.
{% hint style="success" %}
Visite o repositório GitHub da Oxylabs para um exemplo completo e funcional de [**integração do MCP com o Oxylabs Headless Browser**](https://github.com/oxylabs/oxylabs-hb-mcp)**.**
{% endhint %}
## 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**](https://oxylabs.io/products/unblocking-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**](https://oxylabs.io/products/residential-proxy-pool) integração.
O host MCP (como [**Claude Desktop**](https://claude.ai/download) ou [**Cursor**](https://www.cursor.com/)) 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.
{% hint style="info" %}
Por enquanto, você pode obter o Headless Browser com nossa equipe de vendas em [**hello@oxylabs.io**](mailto:hello@oxylabs.io)**.**
{% endhint %}
2. **Node.js**: versão 18.0.0 ou superior (inclui npm/npx)
* **Windows**: baixe e instale em [**nodejs.org**](https://nodejs.org/)
* **macOS**: use o Homebrew (`brew install node`) ou baixe em [**nodejs.org**](https://nodejs.org/)
* **Linux**:
* Ubuntu/Debian: `sudo apt update && sudo apt install nodejs npm`
* Fedora: `sudo dnf install nodejs npm`
* Ou baixe em [**nodejs.org**](https://nodejs.org/)
3. **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 `` e `` pelas suas credenciais reais da Oxylabs:
```json
"oxylabs_headless_browser": {
"command": "npx",
"args": [
"@playwright/mcp@latest",
"--cdp-endpoint",
"wss://:@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:
```json
"oxylabs_headless_browser": {
"command": "npx",
"args": [
"@playwright/mcp@latest",
"--cdp-endpoint",
"wss://:@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.
{% hint style="success" %}
Você pode encontrar a lista de **códigos de país ISO-3166** [**aqui**](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes).
{% endhint %}
### 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:
```json
"oxylabs_headless_browser": {
"command": "npx",
"args": [
"@playwright/mcp@latest",
"--cdp-endpoint",
"wss://:@ubs-us.oxylabs.io"
]
}
```
{% hint style="warning" %}
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.
{% endhint %}
### Argumentos do navegador (somente Chrome)
Para o Headless Browser baseado em Chrome, você pode especificar argumentos adicionais do navegador usando o `bargs` parâmetro:
```json
"oxylabs_headless_browser": {
"command": "npx",
"args": [
"@playwright/mcp@latest",
"--cdp-endpoint",
"wss://:@ubc.oxylabs.io/?bargs=force-color-profile:srgb&bargs=window-position:100,100"
]
}
```
Os argumentos compatíveis incluem:
* `force-color-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:,,`: 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
