> 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/ai-workflows/pt-br/mcp.md).

# Model Context Protocol (MCP)

Use o Oxylabs MCP para dar a assistentes de IA ferramentas em tempo real de web scraping, busca e extração por meio dos produtos da Oxylabs.

O Model Context Protocol (MCP) é um padrão aberto para conectar assistentes de IA a ferramentas e dados externos. Com as integrações MCP da Oxylabs, assistentes como [Claude](https://claude.ai/) e [Cursor](https://www.cursor.com/) podem acessar dados da web em tempo real – raspar páginas, pesquisar na web, rastrear sites e controlar navegadores remotos.

A Oxylabs oferece integrações MCP para dois produtos:

<table><thead><tr><th width="136">Produto</th><th width="183">servidor MCP</th><th>Configuração</th></tr></thead><tbody><tr><td><a href="#web-api">Web API</a></td><td><code>oxylabs-web-api-mcp</code></td><td>Remoto (hospedado pela Oxylabs) ou auto-hospedado (executado por você)</td></tr><tr><td><a href="#agent-browser">Agent Browser</a></td><td><code>hb-mcp</code></td><td>Auto-hospedado</td></tr></tbody></table>

{% hint style="info" %}
**Observação:** Cada produto tem seu próprio servidor MCP e credenciais. Configure apenas os que você precisa – eles também podem ser combinados.
{% endhint %}

## Web API

Conecte a Web API ao seu agente de IA para pesquisar na web, raspar páginas no formato de sua escolha, extrair campos como JSON e chamar raspadores dedicados – tudo por meio de uma única conexão MCP. Você pode encontrar todos os detalhes no [repositório GitHub do Web API MCP](https://github.com/oxylabs/web-api-mcp).

Você pode se conectar de duas maneiras:

* [**MCP remoto**](#option-1-remote-mcp) – conecte-se ao servidor hospedado e mantido pela Oxylabs. Não há nada para instalar ou atualizar.
* [**MCP auto-hospedado**](#option-2-self-hosted-mcp) – implante e gerencie o servidor no seu próprio ambiente para ter mais controle.

<table><thead><tr><th width="160"></th><th width="288">MCP remoto</th><th>MCP auto-hospedado</th></tr></thead><tbody><tr><td><strong>O servidor é executado em</strong></td><td>infraestrutura da Oxylabs</td><td>sua máquina ou infraestrutura</td></tr><tr><td><strong>Configuração</strong></td><td>Adicione a URL do servidor e sua chave de API ao seu cliente</td><td>Instale <code>uv</code>, Python e o servidor, depois configure seu cliente</td></tr><tr><td><strong>Atualizações e manutenção</strong></td><td>Gerenciado pela Oxylabs</td><td>Gerenciado por você</td></tr><tr><td><strong>Configurações do servidor</strong></td><td>Gerenciado pela Oxylabs</td><td>Configurável com variáveis de ambiente</td></tr><tr><td><strong>Melhor para</strong></td><td>A maneira mais rápida de dar a um agente compatível acesso à Web API</td><td>Controle total sobre o ambiente, ou clientes que não conseguem se conectar a servidores remotos com um cabeçalho personalizado</td></tr></tbody></table>

### Requisitos

* **Chave da Web API:** no [painel da Oxylabs](https://dashboard.oxylabs.io/), crie uma instância do produto Web API, abra-a e copie a chave de API exibida no topo da página da instância.
* **Para MCP remoto:** Um cliente MCP que oferece suporte a servidores MCP remotos (HTTP) com cabeçalhos personalizados, como Claude Code, Codex, Cursor etc.
* **Para MCP auto-hospedado:** [**`uv`**](https://docs.astral.sh/uv/getting-started/installation/) e Python 3.10 ou superior.

### Ferramentas disponíveis

<table><thead><tr><th width="188.30078125">Ferramenta</th><th>O que faz</th></tr></thead><tbody><tr><td><code>search</code></td><td>Pesquisar na web em tempo real – <code>query</code>, <code>max_results</code>, <code>location</code></td></tr><tr><td><code>scrape</code></td><td>Ler uma URL, Markdown por padrão, ou retornar campos nomeados como JSON – <code>url</code>, <code>format</code>, <code>location</code>, <code>device</code>, <code>run_js</code>, <code>json_prompt</code>, <code>json_schema</code></td></tr><tr><td><code>scrape_target</code></td><td>Chamar um raspador específico do destino – <code>endpoint</code>, <code>params</code>, <code>structured</code>, <code>parser</code>, <code>json_prompt</code>, <code>json_schema</code></td></tr><tr><td><code>list_scrapers</code></td><td>Listar endpoints de raspagem disponíveis, ou descrever um – <code>endpoint</code></td></tr><tr><td><code>check_scrape</code></td><td>Coletar um trabalho enfileirado, como uma raspagem com renderização de JavaScript – <code>request_id</code></td></tr><tr><td><code>read_scraped</code></td><td>Ler uma página grande que foi descarregada para o disco, em partes – somente quando o servidor é executado localmente (stdio)</td></tr></tbody></table>

{% hint style="info" %}
**Observação:** Todas as ferramentas são somente leitura, então muitos clientes podem executá-las sem pedir aprovação.
{% endhint %}

### Opção 1: MCP remoto

Conecte seu cliente ao servidor hospedado pela Oxylabs:

```
https://mcp.oxylabs.io/web-api-mcp
```

O servidor autentica cada solicitação com sua chave de Web API, enviada como um `Authorization: Bearer` cabeçalho.

Defina sua chave de API como uma variável de ambiente no terminal em que você executará seu cliente:

```bash
export OXYLABS_WEB_API_KEY="your_api_key_here"
```

Depois adicione o servidor ao seu cliente:

{% tabs %}
{% tab title="Claude Code" icon="claude" %}

```bash
claude mcp add --transport http --scope user oxylabs-web-api \
  https://mcp.oxylabs.io/web-api-mcp \
  --header "Authorization: Bearer ${OXYLABS_WEB_API_KEY}"
```

`--scope user` torna o servidor disponível em todos os seus projetos. Certifique-se de que `OXYLABS_WEB_API_KEY` esteja definida no ambiente em que você iniciar o Claude Code.
{% endtab %}

{% tab title="ChatGPT/Codex" icon="openai" %}

```bash
codex mcp add oxylabs-web-api \
  --url https://mcp.oxylabs.io/web-api-mcp \
  --bearer-token-env-var OXYLABS_WEB_API_KEY
```

Codex lê a chave da `OXYLABS_WEB_API_KEY` variável de ambiente, então ela precisa estar definida no ambiente em que você iniciar o Codex.
{% endtab %}

{% tab title="Cursor (+ outros)" icon="cursor" %}
Para qualquer cliente que ofereça suporte a servidores MCP remotos com cabeçalhos personalizados, adicione a URL do servidor e um `Authorization` cabeçalho à configuração MCP do cliente. Por exemplo, no `mcp.json`:

```json
{
  "mcpServers": {
    "oxylabs-web-api": {
      "url": "https://mcp.oxylabs.io/web-api-mcp",
      "headers": {
        "Authorization": "Bearer ${env:OXYLABS_WEB_API_KEY}"
      }
    }
  }
}
```

Os nomes dos campos podem variar entre clientes – consulte a documentação do seu cliente para saber como adicionar um servidor MCP remoto com cabeçalhos.
{% endtab %}
{% endtabs %}

{% hint style="warning" %}
**Importante:** Sua chave de API concede acesso ao uso da sua Web API. Não faça commit de arquivos de configuração que a incluam e use variáveis de ambiente onde seu cliente oferecer suporte.
{% endhint %}

{% hint style="info" %}
**Observação:** Clientes que oferecem suporte apenas a login OAuth para servidores remotos, como conectores personalizados na interface web do claude.ai, não podem enviar cabeçalhos personalizados nem se conectar ao servidor MCP remoto. Use a opção auto-hospedada com esses clientes.
{% endhint %}

### Opção 2: MCP auto-hospedado

{% hint style="info" %}
**Observação:** Os comandos remoto e auto-hospedado nesta página usam o mesmo nome de servidor, `oxylabs-web-api`. Se você alternar de uma opção para a outra, remova primeiro o servidor existente do seu cliente.
{% endhint %}

Hospede seu servidor MCP da Web API como **Local (stdio)** processo ou um **Servidor compartilhado (HTTP)**:

{% tabs %}
{% tab title="Local (stdio)" %}

```bash
uv tool install git+https://github.com/oxylabs/web-api-mcp
```

Depois aponte seu cliente para o `oxylabs-web-api-mcp` comando. O código-fonte está disponível no [repositório GitHub do Web API MCP](https://github.com/oxylabs/web-api-mcp).

<details>

<summary><strong>Claude Code</strong></summary>

```bash
claude mcp add oxylabs-web-api \
  --env OXYLABS_WEB_API_KEY='${OXYLABS_WEB_API_KEY}' \
  -- oxylabs-web-api-mcp
```

</details>

<details>

<summary><strong>Claude Desktop</strong></summary>

```json
{
  "mcpServers": {
    "oxylabs-web-api": {
      "command": "oxylabs-web-api-mcp",
      "env": { "OXYLABS_ENV_FILE": "/absolute/path/to/.env" }
    }
  }
}
```

</details>

<details>

<summary><strong>Cursor</strong></summary>

{% code overflow="wrap" expandable="true" %}

```json
{
  "mcpServers": {
    "oxylabs-web-api": {
      "command": "oxylabs-web-api-mcp",
      "env": { "OXYLABS_WEB_API_KEY": "${env:OXYLABS_WEB_API_KEY}" }
    }
  }
}
```

{% endcode %}

</details>

A habilidade do agente já está incorporada ao servidor. Se você preferir gerenciar skills separadamente, o Claude Code pode, em vez disso, usar o [skills](https://github.com/oxylabs/web-api-skills) repositório de skills como um plugin, que conecta este servidor e as skills juntos:

```bash
/plugin marketplace add oxylabs/web-api-skills
/plugin install oxylabs-web-api
```

{% endtab %}

{% tab title="Servidor compartilhado (HTTP)" %}
Execute um servidor compartilhado para uma equipe, ou para agentes que não conseguem iniciar processos locais:

```bash
export OXYLABS_WEB_API_KEY=WEB_API_KEY
export MCP_ALLOWED_HOSTS='mcp.internal.example.com,localhost:*'
oxylabs-web-api-mcp --transport http --host 0.0.0.0 --port 8080
```

{% hint style="warning" %}
**Importante:** `MCP_ALLOWED_HOSTS` é obrigatório – liste o hostname ao qual os clientes se conectam, ou cada solicitação é rejeitada com `421 Misdirected Request`. O servidor não tem autenticação própria, então qualquer pessoa que consiga acessá-lo pode usar a chave definida em seu ambiente: mantenha-o atrás de uma VPN ou de um ingress autenticado, nunca na internet pública.
{% endhint %}

O endpoint é `http://<host>:8080/mcp`. Os chamadores podem enviar sua própria chave em um `Authorization: Bearer` cabeçalho. Caso contrário, o servidor usa `OXYLABS_WEB_API_KEY`.

Um `Dockerfile` também está disponível no [repositório](https://github.com/oxylabs/web-api-mcp). Para executar o servidor com Docker:

{% code overflow="wrap" expandable="true" %}

```bash
docker build -t oxylabs-web-api-mcp .
docker run --rm -p 8080:8080 \
  -e OXYLABS_WEB_API_KEY \
  -e MCP_ALLOWED_HOSTS='localhost:*,mcp.internal.example.com' \
  oxylabs-web-api-mcp
```

{% endcode %}
{% endtab %}
{% endtabs %}

### Configuração do MCP auto-hospedado

<details>

<summary><strong>Tabela de variáveis de configuração</strong></summary>

<table><thead><tr><th width="231.22265625">Variável</th><th width="413.6328125">Descrição</th><th>Valor padrão</th></tr></thead><tbody><tr><td><code>OXYLABS_WEB_API_KEY</code></td><td>Chave da Web API, enviada como <code>Authorization: Bearer &#x3C;key></code>. Obrigatória em stdio. Via HTTP, um <code>Authorization</code> cabeçalho por solicitação tem precedência.</td><td>–</td></tr><tr><td><code>OXYLABS_BASE_URL</code></td><td>Substitui a URL base da API, por exemplo para passar por um proxy.</td><td><code>https://webapi.oxylabs.io</code></td></tr><tr><td><code>OXYLABS_RETRIES</code></td><td>Repetições em caso de erros temporários (<code>429</code>, <code>500</code>, <code>502</code>, <code>503</code>, <code>504</code>).</td><td>2</td></tr><tr><td><code>OXYLABS_RATE_LIMIT</code></td><td>Limita o gasto do servidor, por exemplo <code>100/1h</code> ou <code>50/30m</code>.</td><td>Desligado</td></tr><tr><td><code>OXYLABS_MAX_INLINE_TOKENS</code></td><td>Conteúdo acima desse tamanho, em tokens, é salvo em disco (stdio) ou truncado (HTTP).</td><td>10000</td></tr><tr><td><code>OXYLABS_SPILL_DIR</code></td><td>Onde as páginas salvas são gravadas (somente stdio).</td><td>Diretório temporário do sistema</td></tr><tr><td><code>OXYLABS_SPILL</code></td><td>Defina como <code>0</code> para manter todo o conteúdo inline, mesmo em stdio.</td><td>1</td></tr><tr><td><code>MCP_TRANSPORT</code></td><td><code>stdio</code> ou <code>http</code>.</td><td><code>stdio</code></td></tr><tr><td><code>HOST</code> / <code>PORT</code></td><td>Endereço de bind HTTP.</td><td><code>127.0.0.1</code> / <code>8080</code></td></tr><tr><td><code>MCP_ALLOWED_HOSTS</code></td><td>Separado por vírgulas <code>Host</code> lista de hosts permitidos (somente HTTP).</td><td><code>localhost:*,127.0.0.1:*</code></td></tr><tr><td><code>MCP_ALLOWED_ORIGINS</code></td><td>Separado por vírgulas <code>Origem</code> lista de origens permitidas para clientes de navegador (somente HTTP).</td><td>Vazio</td></tr></tbody></table>

{% hint style="info" %}
Ligado `stdio`, o servidor também lê `OXYLABS_*` variáveis de `.env` arquivo no seu diretório de trabalho, ou do arquivo definido em `OXYLABS_ENV_FILE`. Variáveis já definidas no ambiente têm precedência. A chave de API é lida no momento da solicitação e nunca é gravada em disco nem registrada em logs.
{% endhint %}

</details>

## Agent Browser

Conecte o Agent Browser por meio de seu servidor MCP `hb-mcp`, para permitir que seu assistente abra navegadores remotos, navegue por páginas, interaja com elementos e colete conteúdo usando recursos avançados de navegação autônoma e [**Residential Proxy**](https://oxylabs.io/products/residential-proxy-pool) integração. Você pode encontrar todos os detalhes no [repositório GitHub do Agent Browser MCP](https://github.com/oxylabs/oxylabs-ab-mcp).

### Ferramentas disponíveis

`hb_connect` retorna um rótulo de sessão que você passa para as outras ferramentas, para que possa executar várias sessões em paralelo. As sessões duram até 1 hora e contam para o seu limite de sessões simultâneas até serem encerradas.

<table><thead><tr><th width="227">Ferramenta</th><th>O que faz</th></tr></thead><tbody><tr><td><code>hb_connect</code></td><td>Abra uma sessão – aceita parâmetros do Agent Browser como <code>p_cc</code>, <code>p_device</code>, <code>p_src</code>, <code>p_fp_tag</code>, <code>session_name</code>, <code>o_profile</code>, <code>record</code>, <code>page_handler</code></td></tr><tr><td><code>hb_disconnect</code></td><td>Feche uma sessão, ou todas as sessões</td></tr><tr><td><code>hb_session_info</code></td><td>Liste as sessões abertas, ou mostre os detalhes de uma</td></tr><tr><td><code>hb_page_status</code>,<br><code>hb_page_handle</code>,<br><code>hb_classify_page</code></td><td>Trabalhe com o Page Handler: leia o status da página, lide com um desafio que apareceu após o carregamento da página (<code>hb_page_handle</code> requer <code>page_handler=true</code>), classifique a página atual</td></tr><tr><td><code>hb_sessions_list</code>,<br><code>hb_session_stop</code></td><td>Liste e encerre sessões ativas na sua conta</td></tr><tr><td><code>hb_recordings_list</code>,<br><code>hb_recording_url</code>,<br><code>hb_recording_delete</code></td><td>Gerencie gravações de sessão</td></tr><tr><td><code>hb_profiles_list</code>,<br><code>hb_profile_delete</code></td><td>Gerencie perfis persistentes</td></tr><tr><td><code>hb_reference</code></td><td>Retorne a referência de parâmetros e erros</td></tr><tr><td><code>browser_navigate</code></td><td>Abra uma URL</td></tr><tr><td><code>browser_snapshot</code></td><td>Leia o conteúdo da página</td></tr><tr><td><code>browser_click</code></td><td>Clique em um elemento do snapshot</td></tr><tr><td><code>browser_type</code>,<br><code>browser_fill_form</code></td><td>Digite em um campo ou preencha vários campos de formulário</td></tr><tr><td><code>browser_take_screenshot</code></td><td>Capture uma screenshot</td></tr><tr><td><code>browser_close</code></td><td>Feche a sessão</td></tr><tr><td>Outros <code>browser_*</code> ferramentas</td><td>Abas, passar o mouse, pressionamentos de tecla, espera, envio de arquivos, exportação de PDF e mais</td></tr></tbody></table>

### Pré-requisitos

* Agent Browser `username` e `password` do [painel da Oxylabs](https://dashboard.oxylabs.io/).
* [Node.js](https://nodejs.org/) 20.0.0 ou superior e `git`.

### Instalação

Instale o servidor do GitHub, pois ele não é publicado no `npm` registry:

{% code expandable="true" %}

```
npm install -g github:oxylabs/oxylabs-ab-mcp
```

{% endcode %}

Depois aponte seu cliente para o `hb-mcp` binário:

<details>

<summary><strong>Claude Code</strong></summary>

```bash
claude mcp add oxylabs-agent-browser \
  -e OXY_HB_USERNAME="USERNAME" \
  -e OXY_HB_PASSWORD="PASSWORD" \
  -- hb-mcp
```

</details>

<details>

<summary><strong>Claude Desktop ou Cursor</strong></summary>

Adicione isto ao seu `claude_desktop_config.json` ou `.mcp.json` arquivo:

```json
{
  "mcpServers": {
    "oxylabs-agent-browser": {
      "command": "hb-mcp",
      "env": {
        "OXY_HB_USERNAME": "USERNAME",
        "OXY_HB_PASSWORD": "PASSWORD"
      }
    }
  }
}
```

</details>

Para pular a instalação global, use `npx -y github:oxylabs/oxylabs-ab-mcp` como comando em vez de `hb-mcp`. A inicialização é mais lenta.

#### Seleção de localização

Peça ao seu assistente para abrir o navegador em um país específico com `p_cc` parâmetro, ou defina um padrão para cada sessão com o `--default-params` argumento:

```json
"oxylabs-agent-browser": {
  "command": "hb-mcp",
  "args": ["--default-params", "p_cc=US"],
  "env": {
    "OXY_HB_USERNAME": "USERNAME",
    "OXY_HB_PASSWORD": "PASSWORD"
  }
}
```

Para escolher as opções de localização do navegador, visite a [Seleção de Geolocalização e Proxy](/products/agent-browser/geolocation-and-proxy-selection.md) página. Se você não especificar uma localização, uma será atribuída automaticamente com base na disponibilidade.

## Use vários produtos juntos

Você pode executar ambos os servidores no mesmo cliente. Combine as entradas deles em um único `mcpServers` objeto.

<details>

<summary>Exemplo</summary>

```json
{
  "mcpServers": {
    "oxylabs-web-api": {
      "command": "oxylabs-web-api-mcp",
      "env": { "OXYLABS_WEB_API_KEY": "${env:OXYLABS_WEB_API_KEY}" }
    },
    "oxylabs-agent-browser": {
      "command": "hb-mcp",
      "env": {
        "OXY_HB_USERNAME": "${env:OXY_HB_USERNAME}",
        "OXY_HB_PASSWORD": "${env:OXY_HB_PASSWORD}"
      }
    }
  }
}
```

Para usar o servidor Remote MCP para Web API em vez disso, substitua a `oxylabs-web-api` entrada pela entrada remota de [Opção 1](#option-1-remote-mcp), em um cliente que oferece suporte a servidores remotos com cabeçalhos.

</details>

## Verifique a configuração

1. Verifique se seus servidores aparecem como habilitados na lista MCP do seu cliente (no Claude Code, execute `/mcp`, ou no Codex, execute `codex mcp list`).
2. Envie um prompt de teste para cada produto que você configurou e aprove a chamada da ferramenta, se solicitado (por exemplo, `Pesquise na web por "oxylabs" e mostre os 3 principais resultados.`).

{% hint style="success" %}
**Observação:** Um servidor pode aparecer conectado e listar suas ferramentas mesmo quando a chave de API está ausente ou incorreta. A chave é verificada quando uma ferramenta é executada, então apenas um prompt de teste confirma que sua configuração funciona.
{% endhint %}

## Solução de problemas

<table><thead><tr><th width="341.37109375">Problema</th><th>Solução</th></tr></thead><tbody><tr><td>O servidor não aparece no cliente</td><td>Certifique-se de que o JSON é válido e então reinicie o aplicativo. Se você usou um comando, execute-o novamente e verifique a lista de servidores.</td></tr><tr><td>O servidor está conectado e as ferramentas aparecem na lista, mas as chamadas de ferramenta falham</td><td>A chave de API é verificada apenas quando uma ferramenta é executada. Verifique se a chave está correta e se você está usando credenciais para o produto correto: Web API usa uma chave de API, e Agent Browser usa um nome de usuário e senha.</td></tr><tr><td><code>Falha na autenticação (401)</code></td><td>A chave de API do Web API é inválida. Copie-a novamente do topo da sua instância Web API no <a href="https://dashboard.oxylabs.io/">painel</a>.</td></tr><tr><td rowspan="2">Mensagem informando que nenhuma chave de API do Web API foi fornecida</td><td>Remote MCP: o <code>Authorization</code> cabeçalho está ausente, ou <code>OXYLABS_WEB_API_KEY</code> está vazio no ambiente em que você iniciou o cliente – defina-o e depois reinicie o cliente. </td></tr><tr><td>Auto-hospedado: a chave não está definida no ambiente do servidor.</td></tr><tr><td>O servidor Remote MCP não vai se conectar, ou seu cliente não tem como definir um cabeçalho</td><td>Seu cliente pode oferecer suporte apenas ao login OAuth para servidores remotos ou não oferecer suporte a cabeçalhos personalizados. Use a <a href="#option-2-self-hosted-mcp">auto-hospedada</a> opção em vez disso.</td></tr><tr><td>O conteúdo da página é truncado</td><td>As páginas acima do limite de tokens são truncadas quando o servidor é executado via HTTP, o que inclui o Remote MCP. Solicite apenas os dados de que você precisa com <code>json_prompt</code>, ou execute o servidor auto-hospedado localmente (<code>stdio</code>), o que salva páginas grandes em disco para que o agente possa lê-las em partes.</td></tr><tr><td><code>oxylabs-web-api-mcp</code>: comando não encontrado (auto-hospedado)</td><td>Instale <code>uv</code> e Python 3.10 ou superior, instale o servidor e certifique-se de que o <code>uv</code> diretório da ferramenta esteja no seu <code>PATH</code> (<code>uv tool update-shell</code>).</td></tr><tr><td><code>421 Misdirected Request</code> (servidor HTTP auto-hospedado)</td><td>Adicione o nome do host ao qual os clientes se conectam em <code>MCP_ALLOWED_HOSTS</code>.</td></tr><tr><td><code>hb-mcp</code> ou <code>npx</code>: comando não encontrado</td><td>Instale <a href="https://nodejs.org/">Node.js</a> 20.0.0 ou superior e <code>git</code>, e certifique-se de que eles estejam no seu <code>PATH</code>.</td></tr><tr><td>O Agent Browser não vai se conectar</td><td>Verifique suas credenciais e certifique-se de que seu firewall não esteja interferindo nas conexões WebSocket.</td></tr><tr><td>Os menus do Cursor parecem diferentes</td><td>Editar <code>mcp.json</code> diretamente – os rótulos dos menus podem mudar entre versões do Cursor. Verifique os logs em <strong>Output → MCP Logs</strong>.</td></tr></tbody></table>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developers.oxylabs.io/ai-workflows/pt-br/mcp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.