> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/integrations/pt-br/integracoes-da-web-scraper-api/model-context-protocol-mcp.md).

# Protocolo de Contexto de Modelo (MCP)

O **Protocolo de Contexto de Modelo (MCP)** integração com [**Web Scraper API da Oxylabs**](https://oxylabs.io/products/scraper-api/web) 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**](#setup-with-claude-desktop)
* [**Claude Code**](#claude-code-cli-setup)
* [**Cursor**](#running-on-cursor)

{% hint style="success" %}
Visite o repositório GitHub da Oxylabs para um exemplo funcional completo de [integração MCP com a Web Scraper API](https://github.com/oxylabs/oxylabs-mcp).
{% endhint %}

## Configuração com Claude Desktop

{% hint style="warning" %}
Antes de começar, certifique-se de ter [**Claude Desktop**](https://claude.ai/download) instalado. 
{% endhint %}

### Usando Smithery.ai

Instale [**Node.js e o npm**](https://docs.npmjs.com/downloading-and-installing-node-js-and-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](https://smithery.ai/server/@oxylabs/oxylabs-mcp), 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**](https://docs.astral.sh/uv/getting-started/installation/), como alternativa ao npm. Consulte o [**Guia de Início Rápido do Model Context Protocol**](https://modelcontextprotocol.io/quickstart/user) 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:

```json
{
  "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

{% hint style="warning" %}
Antes de começar, certifique-se de ter [**Claude Code**](https://docs.anthropic.com/en/docs/claude-code) instalado.
{% endhint %}

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**](https://docs.astral.sh/uv/getting-started/installation/) 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:

```bash
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**](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) se ainda não o fez. Se `npm` já estiver instalado, certifique-se de que esteja atualizado:

```bash
npm install -g npm
```

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

```bash
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.

{% hint style="info" %}
**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.
{% endhint %}

## Executando no Cursor

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

Para configurar a Oxylabs no Cursor:<br>

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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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/integrations/pt-br/integracoes-da-web-scraper-api/model-context-protocol-mcp.md?ask=<question>
```

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.