> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unbrella.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar a sua IA

> Adicione o Unbrella como servidor MCP no app de IA que você usa e entre com a conta do estúdio.

O Unbrella é um servidor MCP remoto, por HTTP. Não há nada para instalar: você adiciona o endereço abaixo no seu app de IA, entra com a conta do estúdio e permite o acesso.

```text Endereço do servidor theme={"dark"}
https://unbrella.com.br/api/mcp
```

> [!NOTE]
>
> Você precisa de uma conta no Unbrella. [Crie a sua](https://unbrella.com.br/criar-conta) e confirme o e-mail antes de conectar.

## Como a conexão funciona

**1. Adicione o endereço no app**

Nas configurações de conectores do app, ou pelo comando de adicionar servidor MCP, num app de terminal.

**2. Entre no Unbrella**

O app abre a página de entrar do estúdio. Entre com o seu e-mail e senha, ou com o Google.

**3. Permita o acesso**

A página Autorizar mostra o nome do app e de onde ele vem. Confira e permita. A partir daí, o app trabalha no seu estúdio, e só nele.

## Passo a passo por app

Os nomes dos menus mudam de uma versão para outra. Se algum não bater, procure pela seção de conectores ou de servidores MCP do app.

**Claude**

No Claude na web ou no app de computador:

1. Abra **Configurações** e vá em **Conectores**.
2. Clique em **Adicionar conector personalizado**.
3. Dê o nome **Unbrella** e cole o endereço `https://unbrella.com.br/api/mcp`.
4. Clique em **Adicionar** e depois em **Conectar**.
5. Entre no Unbrella e clique em **Permitir**.

Numa conversa, ligue o conector pelo botão **+** perto do campo de mensagem, se ele não aparecer ligado.

O conector da conta também vale nas conversas da aba Code do app de computador, e é por ele que os botões das telas funcionam ali.

> [!NOTE]
>
> Nos planos Team e Enterprise, quem administra a organização adiciona o conector nas configurações de administrador. Depois, cada pessoa conecta a própria conta em **Configurações** > **Conectores**.

**ChatGPT**

O ChatGPT aceita servidores MCP pelo modo de desenvolvedor, nos planos pagos:

1. Abra **Configurações** e vá em **Apps**.
2. Em **Configurações avançadas**, ligue o **Modo de desenvolvedor**.
3. Crie um app novo com o nome **Unbrella**, o endereço `https://unbrella.com.br/api/mcp` e autenticação **OAuth**.
4. Entre no Unbrella e clique em **Permitir**.

> [!NOTE]
>
> Em contas Business, Enterprise ou Edu, quem administra o espaço pode precisar liberar os apps antes.

**Claude Code**

No terminal:

```bash theme={"dark"}
claude mcp add --transport http unbrella https://unbrella.com.br/api/mcp
```

Depois, dentro do Claude Code, rode `/mcp`, escolha **unbrella** e entre no Unbrella pelo navegador.

> [!NOTE]
>
> Se você usa o Claude Code pelo app de computador, prefira o conector da conta (aba **Claude**): adicionado pelo terminal, o Unbrella não aparece nos conectores do app, e os botões das telas não levam o clique ao estúdio.

**Codex**

No terminal:

```bash theme={"dark"}
codex mcp add unbrella --url https://unbrella.com.br/api/mcp
```

Se o login não abrir sozinho, rode:

```bash theme={"dark"}
codex mcp login unbrella
```

**Cursor**

Adicione o servidor em `~/.cursor/mcp.json`, para todos os projetos, ou em `.cursor/mcp.json`, para um só:

```json mcp.json theme={"dark"}
{
  "mcpServers": {
    "unbrella": {
      "url": "https://unbrella.com.br/api/mcp"
    }
  }
}
```

Nas configurações de MCP do Cursor, clique para entrar no **unbrella** e permita o acesso.

**VS Code**

Adicione o servidor em `.vscode/mcp.json`, ou nas configurações de MCP do seu usuário:

```json mcp.json theme={"dark"}
{
  "servers": {
    "unbrella": {
      "type": "http",
      "url": "https://unbrella.com.br/api/mcp"
    }
  }
}
```

Inicie o servidor pela lista de servidores MCP e entre no Unbrella quando o editor pedir.

**Outro app**

Qualquer app que fale MCP por HTTP (Streamable HTTP) com login OAuth se conecta da mesma forma: adicione o endereço `https://unbrella.com.br/api/mcp` como servidor remoto.

Sem login, o servidor responde `401` e diz onde entrar. O app pode se registrar na hora (registro dinâmico) ou se apresentar pelo endereço da própria descrição (CIMD).

## Ver e desconectar os apps

Os apps que você permitiu ficam em **Mais** > **IA conectada**, no estúdio, com o nome de cada um e desde quando. Desconecte por ali: o app perde o acesso na próxima chamada.

Trocar a senha também desconecta todos os apps da conta.

## Depois de conectar

Peça à sua IA para atender o estúdio. Veja o que pedir em [Primeiros passos](https://docs.unbrella.com.br/primeiros-passos.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.