> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.basement.chat/pt-br/start/connect-claude/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.basement.chat/_mcp/server.

# Conectar o Claude

O Gateway é um conector MCP. Você adiciona o endereço no seu assistente, entra com o seu e-mail e aprova a conexão. Depois disso, o assistente lê os documentos, as tarefas e os serviços da organização que você escolheu, dentro do nível de acesso que você escolheu.

|                          |                                                                         |
| ------------------------ | ----------------------------------------------------------------------- |
| **Endereço do conector** | `https://mcp.basement.chat/mcp` (o endereço sem `/mcp` também funciona) |
| **Login**                | O seu e-mail e o código (ou a passkey), como no site                    |
| **Aprovação**            | A organização, o nível de acesso e um nome para a conexão               |

#### Claude (web e desktop)

1. Abra **Configurações › Conectores** e toque em **Adicionar conector personalizado**.
2. Informe o endereço `https://mcp.basement.chat/mcp` e toque em **Adicionar**.
3. Toque em **Conectar** e entre com o seu e-mail e o código.
4. Na tela de aprovação, escolha a **Organização a conectar**, o **Nível de acesso** e um **Nome da conexão**. Toque em **Aprovar**.
5. Numa conversa, ative o conector e faça a pergunta.

#### ChatGPT

Abra **Configurações › Conectores**. Adicione um conector MCP com o endereço `https://mcp.basement.chat/mcp`. Entre e aprove do mesmo jeito.

#### Claude Code

O Claude Code entra com uma chave, não com o login do site. Crie a chave em **Agentes › Conectar agente**: deixe **Agente de IA**, dê um nome, escolha o nível de acesso e toque em **Criar chave**. Copie a chave. Depois, no terminal:

```bash
claude mcp add --transport http basement https://mcp.basement.chat/mcp \
  --header "Authorization: Bearer bsmt_sua_chave"
```

## O nível de acesso

A tela de aprovação lista os níveis de acesso da organização, com o que cada um dá no **Basement** e nos **Serviços conectados**. O nível **Analista** vem marcado.

A caixa **Com este nível, o agente alcança** mostra o Basement e cada serviço que você conectou nesta organização. Cada um mostra **leitura**, **leitura e escrita** ou **fora deste nível**. Se um serviço seu está conectado em outra organização, a caixa diz qual: troque a organização antes de aprovar. Escolha o nível e toque em **Aprovar**.

Toda organização tem quatro níveis prontos:

* **Pesquisador**: lê documentos, arquivos, skills e tarefas. Não escreve. Não usa serviços.
* **Analista**: lê o Basement e todos os serviços conectados (SAP, Jira, GLPI, MultiDados, outro servidor MCP). Não escreve.
* **Operador**: lê e escreve documentos, skills, arquivos e tarefas. Não usa serviços.
* **Acesso completo**: lê e escreve o Basement e todos os serviços conectados.

Um administrador pode criar outros níveis, por exemplo um nível que lê só o SAP. Veja [Entrar e conhecer a organização](/start/sign-in) para os níveis, e [Serviços](/services/overview) para o que cada serviço dá.

O assistente vê sempre as mesmas ferramentas. O nível decide quais chamadas são aceitas. Quando uma chamada é recusada, o assistente diz o motivo e o que fazer.

## Para trocar o nível

No site, abra **Agentes › Conectados**. Abra a conexão e escolha outro nível em **Nível de acesso**. Depois, remova o conector no assistente e conecte de novo: o assistente só carrega a mudança quando conecta.

Você muda o nível das suas próprias conexões. Um administrador muda o nível de qualquer conexão e cria novos níveis.

> **Note**
>
> Uma conexão feita antes de 5 de outubro de 2026 não tem nível de acesso, e as chamadas a serviços são recusadas. Remova o conector no assistente, conecte de novo e aprove com um nível. Ou defina o nível em **Agentes › Conectados** e reconecte o assistente.

## Para trocar a organização ou parar

* Para trocar a organização, remova o conector no assistente e conecte de novo.
* Para parar um agente, abra **Agentes › Conectados** no site e toque em **Revogar**. O agente para na hora. As chamadas antigas ficam no registro de atividade.

## Exemplos de pergunta

* "Quais tarefas estão travadas esta semana?"
* "Resuma o documento de onboarding de clientes."
* "Quais chamados do GLPI estão abertos no meu nome?"
* "Quais dumps aconteceram hoje no SBX?"

> Conecte o Claude, o ChatGPT ou o Claude Code ao Gateway. Escolha a organização e o nível de acesso.