Conecte o Grok Build
A ferramenta de código da xAI, no terminal. Siga os passos abaixo: cada imagem mostra a tela que vai aparecer e onde clicar.
Antes de começar
- Uma conta da xAI com acesso ao Grok Build.
- Sua conta na RTCloud.
- 1
Abra o terminal
No seu computador
No Windows, aperte a tecla Windows, digite PowerShell e dê Enter. No Mac, abra o app Terminal. É uma janela de texto, com a linha começando em PS C:\ no Windows.
Os comandos deste tutorial vão nessa janela. Se você colar em uma conversa com a IA, eles viram mensagem e nada acontece.
- 2
Instale o Grok Build
No terminal
Já tem instalado? Pule este passo. Cole o comando do seu sistema, aperte Enter e espere terminar. Depois, feche a janela e abra um terminal novo.
Windows (PowerShell)
irm https://x.ai/cli/install.ps1 | iex
Mac e Linux
curl -fsSL https://x.ai/cli/install.sh | bash
- 3
Confira se instalou
Em um terminal novo
No terminal novo, rode o comando abaixo. Se aparecer um número de versão, siga para o próximo passo.
Cole no terminal
grok version
Apareceu que grok não é reconhecido?
Primeiro, feche a janela e abra um terminal novo. Se continuar, o Grok Build está no computador, mas o terminal não sabe onde ele fica. Cole o comando do seu sistema uma vez só.
Windows (PowerShell)
[Environment]::SetEnvironmentVariable('PATH', [Environment]::GetEnvironmentVariable('PATH', 'User') + ";$env:USERPROFILE\.grok\bin", 'User')Mac (zsh)
echo 'export PATH="$HOME/.grok/bin:$PATH"' >> ~/.zshrc
Linux (bash)
echo 'export PATH="$HOME/.grok/bin:$PATH"' >> ~/.bashrc
Depois, feche esta janela, abra um terminal novo e rode grok version outra vez.
- 4
Entre na sua conta da xAI
No terminal
Rode o comando abaixo e entre pelo navegador. Se você já entrou antes, pule este passo.
Cole no terminal
grok login
- 5
Adicione a RTCloud
No terminal
Cole o comando abaixo. Depois, se quiser conferir, rode grok mcp list: a RTCloud precisa aparecer na lista.
Cole no terminal
grok mcp add --transport http rtcloud https://rtcloud.com.br/mcp
- 6
Abra o Grok numa pasta de trabalho
No terminal
Rode um comando de cada vez. Use a pasta de um projeto seu ou crie uma vazia, como aqui: o Grok trabalha na pasta em que abrir.
1. Crie a pasta
mkdir $HOME/teste-rtcloud
2. Entre nela
cd $HOME/teste-rtcloud
3. Abra o Grok Build
grok
Não abra em C:\Windows\system32 nem na pasta do seu usuário: elas têm arquivos que a ferramenta não precisa ver.
- 7
Autentique a RTCloud
Dentro do Grok Build
O navegador abre sozinho no primeiro uso. Se não abrir, digite /mcps e aperte Enter, escolha rtcloud com as setas e aperte a tecla i.
Digite dentro do Grok Build
/mcps
- 8
Autorize na RTCloud
No navegador
A página da RTCloud abre sozinha. Entre na sua conta se ela pedir. As permissões de leitura já vêm marcadas: para o primeiro teste, é só clicar em Autorizar. Para a ferramenta poder alterar algo, use Liberar tudo ou marque uma a uma.
- 9
Faça o primeiro pedido
Dentro do Grok Build
Peça: Liste minhas aplicações. A ferramenta pode pedir sua aprovação antes de agir. Se aparecerem as suas aplicações, está tudo certo.
Pronto, está conectado
A conexão aparece em Ferramentas MCP, no painel. Toda alteração feita pela ferramenta fica registrada na sua Atividade. Quando quiser liberar mais, desconecte e autorize de novo com outras permissões.
Prefere usar uma chave?
Sem navegador, como em um servidor por SSH: gere uma chave MCP, salve na variável RTCLOUD_MCP_KEY e adicione assim:
Cole no terminal (Mac e Linux)
grok mcp add --transport http rtcloud https://rtcloud.com.br/mcp --header "Authorization: Bearer ${RTCLOUD_MCP_KEY}"Deu algo errado?
Apareceu “Pedido não aceito” na página da RTCloud
Nada foi liberado na sua conta. Confira se o endereço está exato, sem espaço nem barra no fim, e conecte de novo. Se continuar, fale com o suporte e mande o print.
O terminal diz que grok não é reconhecido
O Grok Build está instalado, mas o terminal não sabe onde ele fica. Siga a correção do passo Confira se instalou, com imagens, e abra um terminal novo.
Apareceu que irm não é reconhecido
Você abriu o Prompt de Comando, não o PowerShell. Aperte a tecla Windows, digite PowerShell e use a janela em que a linha começa com PS.
A RTCloud apareceu duas vezes
O Grok Build também lê os servidores configurados no Claude Code e no Cursor. Rode grok inspect para ver de onde vem cada um. Vale a entrada do próprio Grok.
Conectou, mas não responde
Rode grok mcp doctor rtcloud no terminal. Ele mostra se o problema é na configuração ou na conexão.
O login não abre o navegador
Rode grok login --device-auth e siga o código que aparecer no terminal.
Digitei os comandos e virou uma conversa
Você está dentro de uma ferramenta, não no terminal. Volte ao PowerShell, onde a linha começa com PS C:\.
Conectou, mas ela não vê as minhas aplicações
Confira se a permissão Ver aplicações ficou marcada ao autorizar. Se precisar mudar, desconecte em Ferramentas MCP e conecte de novo.
Para desconectar
No painel da RTCloud, abra Ferramentas MCP e clique em Desconectar: o acesso acaba na hora. No terminal, rode grok mcp remove rtcloud.
Outras ferramentas
Coloque a sua IA para cuidar do deploy
Crie a conta, publique a aplicação e conecte a sua ferramenta em poucos minutos.