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

# Usar com o Claude

Quando uma conexão SAP está pronta no app, a IA que você conecta ao Gateway pode ler aquele sistema. Veja [Conectar um sistema SAP](/sap/connect). O login é o mesmo do app: o seu e-mail e o código. Na tela de aprovação, escolha a **organização** da conexão SAP e um **nível de acesso** que lê o SAP (por exemplo **Analista**, que lê todos os serviços conectados).

Uma conexão SAP pertence a uma pessoa em uma organização. Aprove o Claude na organização em que o seu SAP está conectado.

#### Claude (web e desktop)

1. Abra **Configurações › Conectores**. Adicione um conector com o endereço `https://mcp.basement.chat/mcp`.
2. Entre com o seu e-mail e o código que chega por e-mail.
3. Na tela de aprovação, escolha a organização da conexão SAP e o nível de acesso com SAP. Dê um nome à conexão. Toque em **Aprovar**.
4. Numa conversa, ative o conector. Faça a pergunta.

#### Claude Code

O Claude Code entra com uma chave. Crie a chave em **Agentes › Conectar agente** (**Agente de IA**), com um nível de acesso que lê o SAP, por exemplo **Analista**. Toque em **Criar chave** e copie a chave. No terminal:

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

#### ChatGPT

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

## O que a IA pode fazer

Todas as ferramentas são só de leitura. Elas leem o sistema que você conectou:

| Grupo           | Ferramentas                                                                                                                                   | Exemplos de pergunta                                      |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
| **Código**      | Pesquisar objetos. Ler código-fonte. Encontrar onde um objeto é usado. Listar os objetos Z/Y do cliente. Mostrar como um programa é iniciado. | "Mostre o código do `Z_CALC_FRETE` e onde ele é chamado." |
| **Dados**       | Ler tabelas (no máximo 200 linhas, com filtro).                                                                                               | "Quais centros existem na T001W?"                         |
| **Dicionário**  | Mostrar a definição de uma tabela, estrutura, visão, elemento de dados ou domínio.                                                            | "Quais são os campos-chave da MARA?"                      |
| **Diagnóstico** | Listar dumps (ST22). Explicar um dump. Listar jobs (SM37). Ler o log do sistema (SM21).                                                       | "Quais dumps aconteceram hoje, e por quê?"                |
| **Sistema**     | Mostrar informações do sistema. Mostrar o estado da conexão por método.                                                                       | "Qual é o release deste sistema?"                         |
| **Transportes** | Listar requests (SE09). Mostrar o conteúdo de uma request.                                                                                    | "O que vai na request SBXK900002?"                        |

A lista completa, com o que cada ferramenta lê, está na página [Ferramentas](/mcp/tools).

## O que a IA não pode fazer

A IA não cria, não altera, não ativa, não executa e não apaga dados no SAP. Não existe ferramenta de escrita. O Gateway recusa esses pedidos. O Gateway nunca lê tabelas com senhas, chaves ou dados pessoais.

## Se a IA diz que o nível de acesso não inclui o SAP

O nível da conexão não lê o SAP (por exemplo **Pesquisador** ou **Operador**), ou a conexão foi feita antes de 5 de outubro de 2026 e não tem nível. Abra a conexão em **Agentes › Conectados**, escolha um nível que lê o SAP (por exemplo **Analista**) e reconecte o assistente. Ou remova o conector, conecte de novo e aprove com esse nível.

## Se a IA diz que o SAP não está disponível

As mensagens são as mesmas do app, com o que fazer: o computador do analista está offline, a VPN está desconectada, ou o SAP recusou o logon. Veja [Quando não conecta](/sap/troubleshooting).

Se o SAP não está conectado para você, a IA diz para abrir o app, ligar a VPN e conectar o sistema. Se você tem mais de um sistema SAP conectado, diga à IA qual sistema: ela escolhe a conexão pelo nome. O **registro de atividade** da organização guarda a ferramenta, o sistema e o resultado de cada chamada. Ele nunca guarda os dados lidos.