> 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)

A URL **Protocolo de Contexto de Modelo (MCP)** integração com [**Oxylabs Web Scraper API**](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 de grande porte (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 do 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 em funcionamento de [Integração MCP com o 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ê tem [**Claude Desktop**](https://claude.ai/download) instalado.
{% endhint %}

### Usando UV

Instalação [**uv**](https://docs.astral.sh/uv/getting-started/installation/), como alternativa ao npm. Consulte o [**Guia 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` com o nome de usuário e a senha do seu 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 da CLI do Claude Code

{% hint style="warning" %}
Antes de começar, certifique-se de que você tem [**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 seu gerenciador de pacotes preferido, siga um dos métodos de configuração abaixo.

### Usando UV (recomendado)

Instalação [**uv**](https://docs.astral.sh/uv/getting-started/installation/) se você ainda não tiver feito isso. 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` com o nome de usuário e a senha do seu usuário da API.

### Usando NPM / NPX

Instalação [**Node.js e npm**](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) se você ainda não tiver. 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` com o nome de usuário e a senha do seu 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 o 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 → Ferramentas MCP
2. Clique em "Adicionar MCP personalizado"
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 o nome de usuário e a senha do seu usuário da API. Também substitua `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 Agente do Composer usará a Oxylabs automaticamente quando apropriado, mas você pode solicitá-la explicitamente descrevendo suas necessidades de web scraping. Acesse o Composer via Command+L (Mac), selecione "Agente" 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, and the optional `goal` query parameter:

```
GET https://developers.oxylabs.io/products/pt-br/web-scraper-api/solutions-for-ai-workflows/model-context-protocol-mcp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.