> For the complete documentation index, see [llms.txt](https://docs.incogniton.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incogniton.com/documentation/pt-br-documentation/api-de-automacao-e-sdks/connect-ai-clients-mcp.md).

# Conectar clientes de IA com MCP

Gere um token MCP em Configurações → Automação e conecte Claude Desktop, Claude Code, Cursor, Windsurf, VS Code ou Codex CLI à sua conta Incogniton.

Abra **Configurações** no menu à esquerda, clique na aba **Automação** e clique em **Gerar Token MCP**. Em seguida, escolha seu cliente de IA em **Instalar no seu cliente de IA** e clique em **Copiar configuração**.

MCP (Protocolo de Contexto de Modelo) permite que um cliente de IA como Claude, Cursor ou VS Code trabalhe com sua conta Incogniton. Você pode pedir para encontrar, criar ou editar perfis, gerenciar proxies, grupos e tags, e iniciar ou parar perfis.

A conexão é feita através do pacote npm `@incogniton/mcp`. Seu cliente de IA o inicia com `npx`, então você precisa do [Node.js](https://nodejs.org/) 18 ou mais recente no computador onde o cliente de IA é executado.

### Gere seu token MCP

{% stepper %}
{% step %}

#### Abra a aba Automação

Clique em **Configurações** no menu à esquerda, depois clique na aba **Automação**. Role até a seção **Token MCP**.
{% endstep %}

{% step %}

#### Gere o token

Clique em **Gerar Token MCP**. O novo token aparece em um campo abaixo do botão.
{% endstep %}

{% step %}

#### Copie e armazene-o

Clique em **Copiar** ao lado do token e armazene-o em algum lugar seguro, por exemplo, em um gerenciador de senhas. O Incogniton mostra o token apenas uma vez: **Aviso: Você não poderá recuperar este token mais tarde — copie e armazene-o agora.**
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Trate o token MCP como uma senha. Qualquer pessoa que o possua pode gerenciar os perfis da sua conta. Nunca o compartilhe ou cole em um arquivo público.
{% endhint %}

### Substituir ou revogar seu token

Você tem um token MCP ativo por vez. Clicar em **Gerar Token MCP** novamente cria um novo token e faz com que o antigo pare de funcionar. Atualize o token em cada cliente de IA que você conectou.

Para interromper todo o acesso, clique em **Revogar** em **Tokens ativos**. Quando nenhum token está ativo, a seção mostra **Nenhum token ativo**.

### Adicionar Incogniton ao seu cliente de IA

Em **Instalar no seu cliente de IA**, abra o menu suspenso **Cliente de IA** e escolha seu cliente: Claude Desktop, Claude Code, Cursor, Windsurf, VS Code ou Codex CLI. O Incogniton mostra uma configuração pronta para colar com seu novo token já preenchido e informa onde colá-lo. Clique em **Copiar configuração**, cole onde o aplicativo indicar e reinicie o cliente de IA.

Gere o token primeiro. Se você abrir esta lista mais tarde, a configuração conterá `YOUR_MCP_TOKEN` em vez de um token: substitua-o pelo token que você armazenou.

Para configuração manual em outros clientes MCP, consulte a [documentação do servidor MCP](https://api-docs.incogniton.com/mcp).

### O que o cliente de IA pode fazer através do MCP

Depois de conectar, seu cliente de IA pode:

* **Perfis:** pesquisar, criar, editar e clonar perfis, e consultar os grupos, tags, proxies e idiomas de navegador que você pode usar para um novo perfil.
* **Grupos e tags:** pesquisar e criar grupos de perfis e tags.
* **Proxies:** pesquisar e adicionar proxies, e pesquisar e criar grupos de proxies.
* **Equipe:** consultar membros da equipe.
* **Iniciar e parar:** ver quais computadores podem iniciar um perfil, iniciar um perfil, verificar se um início ou parada funcionou, e parar um perfil.
* **Telefones na nuvem:** listar seus telefones na nuvem, criar um telefone na nuvem com um proxy da sua Biblioteca de Proxies, e iniciar ou parar telefones na nuvem. Telefones iniciados através do MCP começam sem tela.

A lista completa de ferramentas está na [documentação do servidor MCP](https://api-docs.incogniton.com/mcp).

### Como o lançamento funciona através do MCP

Um perfil sempre abre no aplicativo Incogniton em um dos seus computadores. Esse computador deve ter o aplicativo aberto e estar logado na sua conta.

* Se um computador estiver disponível, o perfil será iniciado lá. Se vários estiverem, o cliente de IA obtém a lista de computadores e você escolhe um.
* Uma solicitação de lançamento que nenhum computador atender em 5 minutos expira.
* O MCP só pode parar perfis que foram iniciados através do MCP. Feche um perfil que você mesmo abriu a partir do aplicativo Incogniton.

### Controlar o navegador após um lançamento do MCP

O MCP em si apenas abre e fecha perfis. Ele não pode clicar, digitar ou ler páginas dentro do navegador.

Após um lançamento, o cliente de IA pode obter um endereço local do DevTools (`cdp_url`) do navegador em execução. Um cliente de IA que pode executar código pode conectar Puppeteer, Playwright ou um navegador MCP a esse endereço.

{% hint style="info" %}
O `cdp_url` só funciona quando o cliente de IA é executado no **mesmo computador** que o aplicativo Incogniton que lançou o perfil. Não funciona de outro computador, ou de um cliente que não pode executar código, como o Claude Desktop. Também é necessário que **Permitir controle remoto do navegador** esteja ativado na aba Automação. Veja [Controle remoto do navegador](https://docs.incogniton.com/documentation/pt-br-documentation/api-de-automacao-e-sdks/browser-remote-control.md).
{% endhint %}

### O que o MCP não pode fazer

Essas ações não estão disponíveis através do MCP:

* Abrir uma URL, gerenciar abas ou ler páginas em um perfil em execução.
* Verificar se um proxy funciona.
* Excluir perfis.
* Restaurar um perfil de um backup.

Cas, o assistente de IA dentro do aplicativo Incogniton, pode fazer isso. Abra o Cas no aplicativo para usá-los.

### Solução de problemas

* **O cliente não mostra ferramentas do Incogniton:** reinicie o cliente de IA após colar a configuração e verifique se o Node.js 18 ou mais recente está instalado.
* **O log do MCP do cliente mostra "token de portador ausente":** o token está ausente na configuração. Cole seu token no lugar de `YOUR_MCP_TOKEN`.
* **Erros de autenticação:** o token foi substituído ou revogado. Gere um novo e atualize a configuração.

Para scripts que rodam no seu próprio computador, você também pode usar a [API REST local](https://docs.incogniton.com/documentation/pt-br-documentation/api-de-automacao-e-sdks/local-rest-api.md) ou o [SDK JavaScript e Python](https://docs.incogniton.com/documentation/pt-br-documentation/api-de-automacao-e-sdks/javascript-and-python-sdk.md).
