# Model Context Protocol (MCP)

A **Model Context Protocol (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 grande (LLM).

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

{% hint style="success" %}
Visite o repositório GitHub da Oxylabs para um exemplo completo em funcionamento de [Integração do 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, verifique se você tem [**Claude Desktop**](https://claude.ai/download) instalado. 
{% endhint %}

### Usando Smithery.ai

Instale [**Node.js e a interface de linha de comando do npm.**](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) Se você já os tiver instalados, execute o comando a seguir 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 informar seu nome de usuário e senha de usuário da API. Insira essas credenciais quando solicitado.

Quando a instalação estiver concluída, abra o Claude Desktop e configure o scraper para começar a usar saídas aprimoradas com MCP.

###  **Usando UV**

Instale [**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 seu 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.

## **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` 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 AI Studio da Oxylabs.

Depois de adicionar a configuração, atualize a lista de servidores MCP para ver as novas ferramentas. O Composer Agent usará a 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: 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.