# 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 em funcionamento de [**Integração 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 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 implementar sistemas de IA para executar **navegação na web, recuperação de dados e automação** 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).
## Começando
Antes de configurar a integração, verifique se você tem:
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 por meio do nosso setor 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. **Host MCP**: instalado com Claude Desktop ou Cursor.
## 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. Abra o Cursor
2. Abra as configurações do Cursor
3. Selecione MCP
4. Adicione a configuração preparada do servidor MCP
5. Reinicie o Cursor
### Opção 2: integração com Claude Desktop
1. Abra o Claude Desktop
2. Abra as configurações do Claude Desktop
3. Vá para Developer
4. Pressione Edit Config
5. Edite o `claude_desktop_config.json` arquivo
6. Adicione a configuração preparada do servidor MCP
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:
```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á automaticamente um 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 suportados incluem:
* `force-color-profile:`: Força que todos os monitores sejam 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 conteúdo da web
* `enable-features:,,`: Lista separada por vírgulas de nomes de recursos a serem habilitados
* `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 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. **Navegador não carregando**:
* Verifique a versão do Node.js (deve ser 18.0.0 ou superior)
* Verifique se o npx está instalado corretamente
* Reinicie a aplicação host MCP
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://developers.oxylabs.io/products/pt-br/headless-browser/integration-with-mcp.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.