> 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/products/pt-br/web-scraper-api/solutions-for-ai-workflows/model-context-protocol-mcp.md).

# Model Context Protocol (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 modelos de linguagem grandes (LLM).

O MCP garante que o contexto, os metadados e as instruções estejam formatados corretamente, permitindo que LLMs, como o Claude da Anthropic, interpretem e utilizem os dados de forma eficaz.

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 completo e funcional 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 que você tenha [**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 instalados, 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 o 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.

Depois que a instalação for concluída, abra o Claude Desktop e configure o scraper 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 Protocolo de Contexto de Modelo**](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 do 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 que você tenha [**Claude Code**](https://docs.anthropic.com/en/docs/claude-code) instalado.
{% endhint %}

O Claude Code tem um comando integrado 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 você ainda não o tiver feito. 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 do usuário da API.

### Usando NPM / NPX

Instale [**Node.js e npm**](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) se você ainda não o tiver feito. 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 do usuário da API.

{% hint style="info" %}
**Observação:** Se você preferir editar os 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 Cursor Observação: Requer a versão 0.46+ do Cursor

Para configurar a Oxylabs no Cursor:<br>

1. Selecione Cursor → Configurações → Configurações do Cursor → 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` com seu 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á automaticamente a Oxylabs quando apropriado, mas você pode solicitá-la 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/products/pt-br/web-scraper-api/solutions-for-ai-workflows/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.