MCP Gateway

Manual do usuário

Do pedido de acesso ao primeiro "entre no SAP®", numa página só.

← Voltar ao painel
  1. Como isto funciona
  2. A sua conta
  3. Pedir acesso ao seu cliente
  4. Onde achar o host e a porta do SAP®
  5. Instalar
  6. Na sua IA: Claude, Codex, Antigravity e as outras
  7. Entrar no SAP®
  8. Se der problema
  9. MCP do Windows
  10. A inteligência que vem junto

1 · Como isto funciona

As ferramentas e todo o controle ficam no servidor. Na sua máquina fica apenas um túnel de saída por SSH, que já vem no Windows, no macOS e no Linux: nenhum programa nosso, nenhum Java, nenhum arquivo de configuração com senha.

O SAP® do cliente continua na rede dele. Quem alcança o SAP® é o seu computador (pela VPN que você já usa), nunca o servidor. O túnel sai pela porta 443, a mesma de qualquer site.

A sua senha do SAP® não fica em lugar nenhum. Você a digita só na página de login que a IA abre, ela vai ao SAP® naquela hora, e o SAP® responde se aceita. Ela não passa pela conversa com a IA.

2 · A sua conta

  1. Na página inicial, preencha o cadastro com o seu e-mail de trabalho e uma senha que você escolhe.
  2. Você recebe um e-mail dizendo que o cadastro chegou. A administração aprova.
  3. Aprovado, chega outro e-mail. Entre no painel com o seu e-mail e a sua senha.

A senha do painel é sua e não tem nada a ver com a senha do SAP®.

3 · Pedir acesso ao seu cliente

No painel, aba Instalação, passo 1:

  1. Escolha o cliente na lista e o sistema em que você vai trabalhar (DEV, QAS ou PRD).
  2. Informe o seu usuário SAP® nesse sistema e, se souber, o mandante.
  3. Se quiser, o e-mail do seu gestor: ele recebe uma cópia do pedido.
  4. Envie. Você recebe um e-mail de "pedido recebido", e a administração do portal (e o gestor do cliente, quando houver) recebe o pedido com um botão para aprovar.
  5. Aprovado, chega o e-mail de "acesso aprovado", e o resto da aba Instalação se abre.

O cliente não está na lista? Escolha "Meu cliente não está na lista" e descreva: o nome, como você chega ao SAP® dele (VPN do cliente, VPN da consultoria, rede do escritório) e o host de cada sistema que você conhece. Quem aprova confere e cadastra o cliente uma vez; dali em diante ele aparece na lista para todo mundo.

Pré-aprovação: quando o cliente já informou quais usuários SAP® ele aceita, o pedido com um deles é aprovado na hora, sem esperar ninguém.

Citrix ou área de trabalho remota não serve. O MCP precisa que o SAP® responda do seu computador, e pelo Citrix quem alcança o SAP® é a máquina remota.

No DEV vale o que o cliente libera; em QAS e PRD, só leitura. Cada pessoa trabalha num sistema por vez: para trocar de sistema, peça o novo e fale com a administração pelo Suporte.

4 · Onde achar o host e a porta do SAP®

Só é preciso quando o cliente não está na lista. O formato é host:porta, por exemplo sapdev.cliente.com:44300.

No Windows (SAP® Logon)

  1. Abra o SAP® Logon.
  2. Clique com o botão direito no sistema (o DEV do cliente, por exemplo) e escolha Propriedades.
  3. Na aba Conexão, o campo Servidor de aplicação é o host. Ao lado está o Número da instância (dois dígitos, como 00).
  4. A porta é a do serviço HTTPS do SAP® (o ICM). A regra mais comum é 443 seguido do número da instância: instância 00 dá 44300, instância 01 dá 44301.

O SAP® Logon guarda a lista de sistemas no arquivo SAPUILandscape.xml, na pasta %APPDATA%\SAP\Common. Quando a empresa distribui a lista pela rede, o SAP® Logon mostra o caminho em Opções, Configuração do servidor.

No Mac (SAP® GUI for Java)

  1. Abra o SAP® GUI for Java e selecione o sistema.
  2. Abra a conexão para editar: o host aparece em Servidor de aplicação (ou em Servidor de mensagens, quando a conexão usa grupo de logon).
  3. A porta segue a mesma regra do Windows: 443 mais o número da instância.

Pelo navegador ou pelo Eclipse

Se você abre o Fiori ou o ADT (Eclipse) desse SAP®, o endereço deles já tem o host e a porta certos: https://host:porta/sap/bc/ui2/flp.

Na dúvida, mande o que você tem e explique na observação: quem aprova confere antes de cadastrar.

5 · Instalar

É uma linha, e ela sai pronta no seu painel depois que o pedido é aprovado.

  1. No painel, aba Instalação, escolha a sua IA e o seu sistema operacional e clique em Gerar meu comando de instalação.
  2. Cole a linha num terminal comum (PowerShell no Windows, Terminal no Mac e no Linux). Não cole dentro da IA.
  3. Antes de tocar no seu computador ele confere três coisas: as ferramentas necessárias, a saída de rede até o servidor e o SAP® respondendo daí. Se qualquer uma falhar, ele para e avisa que nada foi alterado.
  4. No fim ele lista em quais IAs registrou o servidor e diz Tudo pronto.

O comando vale uma vez, até o horário que o painel mostra. Gerar de novo invalida o anterior.

Um computador por conexão

6 · Na sua IA: Claude, Codex, Antigravity e as outras

O comando registra o servidor da sua conexão em cada IA que já estiver instalada no computador. Instalou uma IA depois? Gere o comando e rode de novo, no mesmo computador.

Claude pelo terminal (Claude Code)

  1. Rode o comando de instalação e espere ele dizer Tudo pronto.
  2. Abra um terminal novo e rode claude mcp list: o servidor da sua conexão aparece como conectado.
  3. Abra o claude e digite /mcp: o servidor aparece com as ferramentas.
  4. Peça "entre no SAP®" e siga a seção Entrar no SAP®.

Claude pela interface

  • App do Claude, aba Code, e extensão do Claude Code no VS Code: leem a mesma configuração do terminal. Feche e abra o app (ou a janela do VS Code) depois de instalar, e o servidor aparece sozinho.
  • Chat do Claude (claude.ai e o app, fora da aba Code): ali o caminho é um conector, que a administração libera à parte. Peça pela aba Suporte.

Codex pelo terminal

  1. Rode o comando de instalação. Ele grava o servidor no arquivo de configuração do Codex (config.toml, na pasta .codex do seu usuário).
  2. Abra um terminal novo e rode codex mcp list: o servidor da sua conexão aparece na lista.
  3. Abra o codex e digite /mcp: o servidor aparece com as ferramentas.
  4. Peça "entre no SAP®" e siga a seção Entrar no SAP®.

Codex pela interface

  • Extensão do Codex no VS Code e app do Codex: usam o mesmo config.toml do terminal. Feche e abra depois de instalar. Para conferir, procure MCP nas configurações da extensão.
  • O Codex ainda não estava instalado quando você rodou o comando? Instale, gere o comando e rode de novo.

Antigravity pelo terminal

  1. Rode o comando de instalação. Ele grava o servidor no arquivo de MCP do Antigravity (mcp_config.json, na pasta .gemini do seu usuário).
  2. O Antigravity não tem comando de terminal para listar servidores: a conferência é pela interface, logo abaixo.

Antigravity pela interface

  1. Feche e abra o Antigravity.
  2. No painel do agente, abra o menu … e entre em MCP Servers, depois Manage MCP Servers.
  3. O servidor da sua conexão aparece na lista. Em View raw config você vê o arquivo que o comando gravou.
  4. Peça "entre no SAP®" e siga a seção Entrar no SAP®.

Cursor, Copilot no VS Code, Gemini CLI e Windsurf

O mesmo comando grava o servidor da sua conexão em cada uma que estiver no computador, no arquivo que ela lê, sem mexer nos outros servidores que você já tem. Feche e abra a IA depois.

  • Cursor: mcp.json na pasta .cursor do seu usuário. Confira em Settings, MCP.
  • Copilot no VS Code: mcp.json nas configurações de usuário do VS Code. No chat do Copilot, modo Agent, o ícone de ferramentas mostra o servidor.
  • Gemini CLI: settings.json na pasta .gemini do seu usuário. No gemini, digite /mcp.
  • Windsurf: mcp_config.json na pasta .codeium/windsurf. Confira em Settings, MCP Servers.

Se o comando disser "Nao gravei" para uma delas, o arquivo dela tinha algo que ele não lê com segurança (um comentário, por exemplo) e ficou como estava. No Mac e no Linux a gravação usa o python3: sem ele, instale e rode o comando de novo com um código novo.

7 · Entrar no SAP®

  1. Peça à sua IA: "entre no SAP®".
  2. Ela responde com um link e um código de conferência. Abra o link no navegador.
  3. Confira se a página mostra o mesmo código. Se não mostrar, feche e não digite nada.
  4. Usuário e mandante já vêm preenchidos. Digite a sua senha e entre. O navegador pode guardá-la para a próxima vez.
  5. Volte à IA e diga "entrei": as ferramentas do SAP® aparecem.

O link vale uma vez e por poucos minutos. Quando a sessão cair (tempo parado, servidor reiniciado), a IA pede o login de novo, pelo mesmo caminho. É de propósito: ninguém assume a sua sessão sem a sua senha.

Não fique tentando senha. "Login failed" vem do SAP®, não de nós. Cada erro conta no seu usuário e o SAP® bloqueia a conta. Confira no SAP® GUI primeiro.

8 · Se der problema

O diagnóstico da sua conexão, com o que fazer em cada falha, está no painel, aba Instalação, no fim, em "Se der problema".

9 · MCP do Windows (a sua máquina)

É o segundo servidor, que roda na sua máquina e trabalha ao lado do MCP do SAP®: um lê o sistema, o outro age no computador. Os dois convivem na mesma sessão da IA, com nomes diferentes.

10 · A inteligência que vem junto

Além de alcançar o SAP® e a sua máquina, este servidor responde sozinho um conjunto de capacidades que não existem em nenhum dos dois lados. Elas aparecem na lista de ferramentas do seu assistente com estes nomes, e a maior parte é somente leitura.

Há ainda a inteligência que não tem porta e chega sem você pedir: quando uma chamada falha, a resposta traz junto o que costuma resolver aquilo (só nomes de parâmetro, nunca valores); e a abertura da sessão já leva um resumo curto do seu jeito de trabalhar, tirado das suas próprias chamadas dos últimos dias. Nada de conteúdo lido ou escrito entra nesse resumo, e nada de outra pessoa.

O catálogo completo, com o limite e o custo de cada capacidade, fica no console de administração, na aba Inteligência.

MCP Gateway · Voltar ao painel