> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Claude, Cursor e outros assistentes de IA

## Visão geral

Você pode trabalhar nos seus agentes fora do painel da ElevenLabs, em assistentes como Claude, Claude Code, ChatGPT e Cursor. Todos eles se conectam da mesma forma: pelo [servidor MCP hospedado](/docs/pt/eleven-agents/operate/hosted-mcp) da ElevenLabs, um servidor remoto do [Model Context Protocol](https://modelcontextprotocol.io/) em `https://api.elevenlabs.io/v1/mcp`. O servidor disponibiliza ferramentas de gerenciamento de agentes e faz seu login com OAuth, para que nenhuma chave de API seja copiada para o cliente.

Assistentes de programação também podem instalar o **plugin da ElevenLabs**, que reúne o servidor MCP e as próprias habilidades do ElevenAgents Architect: os workflows que o Architect usa no painel para explorar um agente, editar sua configuração, workflow e ferramentas, escrever testes e trabalhar na fila de triagem.

## Configure seu assistente

#### Claude

O conector da ElevenLabs está listado no diretório de conectores do Claude. No Claude, acesse **Settings** > **Connectors**, pesquise por **ElevenLabs**, selecione **Connect** e conclua o login com OAuth.

Para ambientes de residência de dados, adicione um conector personalizado usando a URL da sua região. Consulte [Servidor MCP hospedado](/docs/pt/eleven-agents/operate/hosted-mcp#data-residency-regions).

#### Claude Code

Instale o plugin da ElevenLabs, que inclui o servidor MCP e as habilidades do Architect:

```bash
/plugin marketplace add elevenlabs/plugin
/plugin install elevenlabs@elevenlabs
```

Para adicionar somente o servidor MCP, sem as habilidades:

```bash
claude mcp add --transport http elevenlabs https://api.elevenlabs.io/v1/mcp
```

Em seguida, execute `/mcp` no Claude Code e conclua o login com OAuth.

#### Cursor

Instale o plugin da ElevenLabs pelo [marketplace do Cursor](https://cursor.com/marketplace). Ele inclui o servidor MCP e as habilidades do Architect.

Para adicionar somente o servidor MCP, inclua-o no seu `mcp.json`:

```json
{
  "mcpServers": {
    "elevenlabs": {
      "url": "https://api.elevenlabs.io/v1/mcp"
    }
  }
}
```

O Cursor solicitará que você faça login com OAuth na primeira vez que se conectar.

#### ChatGPT

Adicione a ElevenLabs como um conector personalizado no ChatGPT, usando a URL do servidor `https://api.elevenlabs.io/v1/mcp`, e conclua o login com OAuth. Talvez seja necessário que o administrador do seu workspace do ChatGPT habilite conectores personalizados.

#### Outros clientes

Qualquer cliente MCP compatível com servidores remotos com OAuth pode se conectar. Direcione o cliente para `https://api.elevenlabs.io/v1/mcp`, ou para a URL da sua região, e conclua o login. Clientes compatíveis com metadados de cliente hospedados (CIMD) não precisam de um registro de cliente separado.

O código-fonte do plugin, incluindo as habilidades do Architect, está em [github.com/elevenlabs/plugin](https://github.com/elevenlabs/plugin/tree/main/architect).

## No painel em comparação com um assistente externo

O Architect no app e o servidor MCP chamam as mesmas APIs do ElevenAgents na sua conta. Portanto, ambos são limitados pelas suas permissões, e os resultados aparecem nos mesmos lugares. Eles diferem na forma como as alterações são preparadas e aprovadas.

|                            | Architect no painel                                                                                                      | Assistente externo via MCP                                                                                                                                                                                                                                         |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Identidade                 | Você, pela sessão do navegador                                                                                           | Você, pela concessão de OAuth que aprovou                                                                                                                                                                                                                          |
| Alterações de configuração | Preparadas em um rascunho. Você sempre publica.                                                                          | Aplicadas diretamente. Atualizar um agente publica uma nova versão na ramificação de destino ou em `main` se nenhuma ramificação for informada. Peça ao assistente para trabalhar em uma ramificação ou criar um rascunho para alterações que precisem de revisão. |
| Aprovações                 | [Modos de aprovação](/docs/pt/eleven-agents/operate/architect/authentication#approval-modes) do Architect                | Configurações de ferramentas do seu cliente. O servidor marca cada ferramenta como somente leitura ou destrutiva, e clientes como o Claude permitem escolher quais ferramentas são executadas automaticamente e quais perguntam primeiro.                          |
| Propostas de merge         | Pode abrir propostas e solicitar revisores. Não pode revisá-las nem fazer merge.                                         | Pode abrir, revisar, comentar e fazer merge de propostas, dentro das suas permissões. Você ainda não pode aprovar sua própria proposta.                                                                                                                            |
| Contexto                   | A página em que você está, o resumo do agente, o contexto do agente, suas preferências e o que o ponto de entrada passou | Apenas o que você informa ao assistente, além do que ele lê com ferramentas. O contexto do agente e suas preferências não são enviados automaticamente.                                                                                                            |
| Extras                     | Modo de planejamento, painéis no chat, execução de código, repasses do Spotlight e da triagem, orientação pelo painel    | Sua própria base de código e outras ferramentas no cliente. Algumas ações de gerenciamento que não estão no Architect, como gerenciar servidores MCP e excluir documentos da base de conhecimento.                                                                 |

Ramificações, versões, propostas de merge, testes e tickets de triagem criados por um assistente externo aparecem no painel nos mesmos lugares que os criados no ElevenAgents. Por exemplo, uma proposta de merge aparece em **Version Control** > **Proposals**, com você como autor.

> **Warning**
>
> Como as atualizações via MCP são publicadas diretamente, alterar `main` usando um assistente externo pode afetar imediatamente
> as chamadas em produção. Configure as ferramentas de atualização e merge de agentes para exigir confirmação no seu cliente e
> proteja `main` se todas as alterações precisarem ser revisadas.

## Escolha onde trabalhar

* **Use o Architect no painel** para melhorar um agente em produção. Ele parte de descobertas do Spotlight, testes com falha e tickets de triagem, prepara cada alteração em um rascunho e deixa a publicação para você.
* **Use um assistente de chat como Claude ou ChatGPT** para perguntas e alterações rápidas entre agentes quando você já estiver trabalhando nele, por exemplo: "Quais dos meus agentes ainda usam a primeira mensagem padrão?"
* **Use um assistente de programação com o plugin** quando seus agentes forem gerenciados como código junto com seu aplicativo. O assistente pode alterar um agente e o código que o chama na mesma sessão. Consulte também a [CLI da ElevenLabs](/docs/pt/eleven-agents/operate/cli).