Implantar a clínica com a IA, passo a passo

PARTE 0As peças e quem faz o quê

São quatro peças. Você só mexe diretamente em duas: o repositório da clínica (para ver o progresso) e a conversa com o Claude.

O implantador faz só três coisas: entrega documentos e informações; aprova o que a IA mostra antes de gravar; confere o que ela mostra depois.

PARTE A · UMA VEZ POR CLÍNICA · ~15 MINPreparação

Faça na ordem. Cada passo diz o que você vai ver na tela. As telas do GitHub e do Claude mudam de vez em quando: se um botão estiver com nome um pouco diferente, procure o mais parecido.

A1 · Contas necessárias

1. GitHub (gratuito), onde fica o caderno da clínica: abra github.com/signup, siga as telas e confirme o e-mail. Já tem conta? Use a mesma.
2. Claude com acesso ao Claude Code na web, onde a IA trabalha: entre em claude.ai. O Claude Code na web exige um plano pago que o inclua. Não tenho certeza de quais planos exatamente: confira na página de planos do claude.ai antes de assinar.
3. Teste: abra claude.ai/code.

A2 · Gerar o token da API da clínica (rbt_)

O token deixa a IA ler e gravar os cadastros desta clínica. Caminho recomendado (decisão de 30/09/2026): a própria clínica gera um token rbt_ no Sistema Rabi — sem esperar o time Rabi:

1. No Sistema Rabi da clínica, com um usuário que tenha acesso às configurações: Configurações › Parâmetros › Integrações.
2. Crie um token do tipo Implantação e manutenção (o tipo “TalkMe (IA)” é outra coisa e não serve para a API externa).
3. Marque só as permissões da implantação (lista abaixo) e escolha a validade: 30, 90 ou 365 dias, ou sem validade — prefira a que cobre o período da implantação.
4. Copie o token na hora: ele aparece uma única vez. Cole direto no gerenciador de senhas e, depois, no ambiente do Claude (A6).

Alternativa: a chave rbk_ emitida pelo time Rabi, pelo portal comercial, continua valendo — use-a se a clínica já tem uma ou prefere pedir. Peça pelo canal comercial ou de suporte:

Permissões de implantação (marque estas ao gerar o rbt_; se pedir a rbk_, o time Rabi entende esta lista):

empresa:read/create/update · deposito:read/create · local:read/create · auxiliar:read
operadora:read/create/update · fornecedor:read/create · fabricante:read/create
taxa:read/create/update · produto:read/create/update · equipamento:read/create
servico:read/create/update · colaborador:read/create/update (o update também cria o login)
gradeColaborador:read/create · gradeEquipamento:read/create
convenio:read/create/update · tabelaPreco:read/create/update · paciente:read/create/update
Se for migrar histórico: atendimento:read/create/update
Opcionais: estoque:read/create · financeiro:read/create · parametro:read/update
Não peça: nenhum :delete, nfse de escrita, agendamento:create, orcamento:create/update, faturamento:create/update

Enquanto o token não está pronto, siga A3 a A5 e até abra a primeira sessão: a IA organiza os documentos e espera o token para gravar.

A3 · Criar o repositório da clínica pelo modelo

1. Entre no GitHub com a conta da clínica.
2. Abra github.com/fmunizmcorp/implantarabi-modelo-clinica/generate.
   Você vê: a tela “Create a new repository”, com o modelo implantarabi-modelo-clinica já escolhido em cima.
3. Owner: escolha a conta da clínica.
4. Repository name: rabi-implantacao-<nome-da-clinica> (minúsculas, sem acento, com hífen). Ex.: rabi-implantacao-clinica-exemplo.
5. Marque Private. É obrigatório: este repositório guarda as senhas iniciais dos usuários em texto claro (o token da API não vai para o repositório — fica só no ambiente do Claude, A6). Se ficar público, qualquer pessoa na internet lê.
6. Deixe “Include all branches” desmarcado e clique em Create repository.
   Você vê: a página do repositório novo, com CLAUDE.md, ESTADO.md e as pastas dados, sprints… Ao lado do nome, a etiqueta Private.

A4 · Liberar a gravação automática

Para quê: cada conversa trabalha numa cópia de rascunho (branch claude/…). Um robô do GitHub leva esse trabalho para a versão principal (main) em cerca de 1 minuto. É a main que a próxima conversa abre.

1. No repositório da clínica, clique em Settings (engrenagem, na barra de abas). Não vê? Peça ao dono do repositório para fazer este passo.
2. No menu da esquerda: Actions → General.
3. Em Workflow permissions, marque Read and write permissions e clique em Save.
4. Confira, mais acima, que “Actions permissions” está em Allow all actions and reusable workflows.

A5 · Ligar o GitHub ao Claude

1. Abra claude.ai/connect-github e autorize (Authorize).
2. Instale o app Claude no repositório: github.com/apps/claude/installations/select_target → conta da clínica → Only select repositories → marque rabi-implantacao-<clínica> → Install.
3. Teste: em claude.ai/code, o repositório tem de aparecer na lista. Não aparece? Refaça o passo 2 e recarregue a página.

A6 · Criar o ambiente da clínica e registrar o token

O ambiente é a “sala de trabalho” da IA: define o acesso à internet e guarda o token. Use um ambiente por clínica.

1. Em claude.ai/code, escolha o repositório da clínica.
2. Abra o menu do ambiente na barra de título da sessão (mostra o nome do ambiente atual, por exemplo “Default”).
3. Crie um ambiente novo com o nome da clínica (por exemplo Rabi - Clínica Exemplo). Se já existe, escolha-o e clique em Edit.
4. Token: se houver a seção “API credentials”, cadastre ali. Se não houver, em Environment variables escreva uma linha: RABI_API_KEY=rbt_... (o token da clínica — ou RABI_API_KEY=rbk_..., se usar a chave do time Rabi; sem espaços, sem aspas).
5. Rede: se o acesso à internet for limitado a domínios permitidos, acrescente api.rabisistemas.com.br (e api.hmg.rabisistemas.dev se for ensaiar em homologação).
6. Clique em Save. O token vale nas sessões novas.

PARTE B · PRIMEIRO DIAPrimeira sessão

B1 · Abrir a sessão e dizer a frase

1. Abra claude.ai/code, escolha o repositório e o ambiente da clínica.
2. Comece uma nova sessão e envie, com o nome real da clínica:

Vamos implantar Clínica Exemplo Copiar

Não precisa colar nenhum outro texto.

B2 · O que a IA faz sozinha

1. Baixa o kit.
2. Personaliza o repositório com o nome da clínica. Se não souber o porte, faz uma pergunta (consultório, clínica pequena/média ou rede).
3. Confere se o repositório é privado e se o token está no ambiente, e até quando vale.
4. Fotografa o que já existe no seu Rabi (só leitura), para nunca duplicar nem sobrescrever o que a clínica já cadastrou.
5. Salva tudo no repositório.
6. Mostra o plano da clínica (etapas S00 a S17) e faz a primeira pergunta.

B3 · O pedido único de documentos

A IA manda uma mensagem com a lista inteira. Mande o que tiver, em qualquer formato (PDF, foto, Excel, Word, exportação do sistema antigo) e em qualquer ordem.

B4 · Como enviar documentos

Na conversa: clique no ícone de anexo, escolha os arquivos e envie.

Pelo GitHub (muitos arquivos): no repositório, pasta documentos-do-cliente → Add file → Upload files → arraste → Commit changes. Depois avise na conversa: “mandei documentos pelo GitHub”. Arquivos acima de 25 MB: divida em partes.

B5 · Como responder

B6 · A prévia, a aprovação e a foto depois

1. Foto antes: a IA lê como está hoje no Rabi.
2. Prévia: uma tabela com item, campo, de → para e o porquê.
3. Aprovação: você responde “pode gravar” (ou “corrija …”). Em listas grandes, ela grava o primeiro item, mostra que saiu certo e só então pede o resto.
4. Grava pelo canal oficial.
5. Foto depois: relê e mostra o que mudou. O que não foi relido aparece como NÃO CONFIRMADO.

Em cada etapa, a IA termina a mensagem com “📖 Para saber mais: …”, o link da parte certa do manual oficial do Rabi. Veja a tabela completa em Etapas e manual oficial.

PARTE CTodos os dias

1. Abra claude.ai/code, o mesmo repositório e o mesmo ambiente.
2. Comece uma sessão nova (uma por dia) e escreva a frase, ou só continuar.

Ver o progresso sem a IA

No GitHub, abra ESTADO.md: clínica, etapa atual, próximo passo e a tabela de todas as etapas com % e o link 📖 do manual. Também: historico/daily/ (resumo do dia), historico/reviews/ (fechamento de cada etapa), pendencias/LACUNAS.md (o que falta).

Quanto tempo leva

Do guia oficial, com os documentos completos no começo:

PARTE DOutros modos, com frases prontas

Um assunto por sessão funciona melhor.

ETAPAS S00 A S17Onde ler mais no manual oficial

A IA mostra estes links em cada etapa. O manual oficial é a fonte primária: se algo divergir, vale o manual.

PARTE IAprendizados e atualizações

Duas coisas acontecem sozinhas, em toda clínica, para o kit ficar cada vez melhor.

I1 · A IA manda ao kit o que aprendeu (com o seu clique)

Quando a IA descobre algo que serve a todas as clínicas (uma conta que o Rabi faz diferente do que o kit dizia, uma regra que faltava, um comportamento da API, um jeito melhor de conduzir), ela:

1. escreve o aprendizado sem nenhum dado da clínica (nada de nome, CNPJ, CPF, pessoa, paciente, código interno, valor do contrato);
2. passa por um filtro automático que bloqueia qualquer coisa parecida com dado da clínica;
3. mostra a você o texto final e pergunta uma vez: “Posso enviar para o kit?”.

Se você disser sim, ela entrega um link. Abra, confira o texto e clique em Submit new issue (é preciso estar logado no GitHub).

Tem vários aprendizados guardados? Escreva enviar aprendizados.

I2 · A IA se atualiza sozinha com as novidades do kit

Em toda sessão a IA baixa a versão mais nova do kit. Se houver novidade, ela:

• conta em até 3 linhas o que mudou para a sua clínica;
• atualiza as instruções e os scripts do repositório da clínica (nunca os seus dados, documentos, provas ou senhas) e salva;
• se a novidade mexer em algo já gravado no Rabi (por exemplo, uma regra de preço), abre uma pendência e propõe um diagnóstico (só leitura). Nada é corrigido no Rabi sem a sua aprovação.

I3 · Quem consolida

A equipe Rabi lê os aprendizados enviados de tempos em tempos, confere com o sistema e, o que for aprovado, entra no kit. Na sessão seguinte, todas as clínicas recebem.

PARTE EProblemas comuns

O token está vencendo ou venceu

Faz parte da proteção. Token rbt_ (recomendado): use Renovar em Configurações › Parâmetros › Integrações (dá para revisar permissões e validade; o valor antigo deixa de valer). Chave rbk_: peça uma nova ao time Rabi. Depois, no Claude Code: menu do ambiente da clínica → Edit → troque RABI_API_KEY → Save. Abra uma sessão nova e escreva continuar. Token recusado aparece como erro 401: a IA para e avisa, não fica tentando (503 é falha de rede — repetir com espera). Erro 403 = o token não tem a permissão daquela etapa (o campo escopoFaltante diz qual) ou é do tipo TalkMe: no rbt_ “Implantação e manutenção”, use Editar permissões e marque a que falta — o token não muda.

A API recusou excluir um produto ou uma taxa (409)

✅ Novo — 02/10/2026 Desde 02/10/2026 o Rabi não deixa desativar produto ou taxa que está na composição de um serviço ativo (#626); a resposta lista os serviços. A IA deve substituir o item nesses serviços primeiro e só depois desativar.

O token apareceu no chat, num e-mail ou num documento

Trate como vazado: revogue o rbt_ em Configurações › Parâmetros › Integrações (vale na hora) e gere outro — ou, se era a rbk_, peça ao time Rabi para revogá-la e emitir outra. Troque o RABI_API_KEY no ambiente (A6) e apague a mensagem ou o arquivo onde o token apareceu.

O repositório está público

Settings → fim da página (Danger Zone) → Change visibility → Change to private. Se um token já foi para lá enquanto estava público, revogue-o: o rbt_ em Configurações › Parâmetros › Integrações; a rbk_, pedindo ao time Rabi. Troque as senhas iniciais que estavam no repositório.

A sessão não achou o kit

Abra uma sessão nova (costuma ser falha momentânea). Confira o acesso à rede do ambiente (A6). Plano B: baixe o ZIP em github.com/fmunizmcorp/implantarabi-ia (Code → Download ZIP), anexe na conversa e peça para colocar em .kit/.

O robô da gravação automática falhou

Na aba Actions aparece um X vermelho no automerge. Refaça A4, abra o item com erro e clique em Re-run jobs. Continua vermelho? Escreva na sessão: “o automerge falhou, veja e corrija”.

O trabalho “sumiu”

No GitHub, no seletor de branch, veja se há uma claude/… recente: o trabalho está lá. Escreva na sessão: “o trabalho da branch claude/… não chegou na main”.

Trocar de implantador

Dê acesso ao repositório (Settings → Collaborators → Add people) e ao ambiente da clínica. A pessoa nova escreve continuar e a IA retoma pelo ESTADO.md.

A IA pediu algo que você não tem

Responda “não temos” ou “não sei, pergunte a Fulano”. Vira pendência; a IA não inventa valor.

A IA disse que o repositório é de outra clínica

Você abriu o repositório errado. Cada clínica tem o seu; abra a sessão no certo.

PARTE FSegurança e LGPD

• Repositório privado, sempre. Só convide quem trabalha na implantação.
• Senhas iniciais só no repositório privado; o token da API só no ambiente do Claude (A6). Nunca em e-mail, WhatsApp, chat, print, documento, chamado, manual ou relatório.
• Um token e um ambiente por clínica. Token de uma clínica não acessa outra. Prefira o rbt_ da própria clínica, só com as permissões da implantação (sem nenhum :delete).
• Vazou? Revogue e gere outro (o rbt_ a clínica revoga na hora).
• Pacientes (LGPD): nome, CPF e texto de prontuário nunca entram em prova, relatório ou histórico. Planilhas de pacientes não ficam no repositório.
• Senha de banco, nunca. Para o financeiro basta o nome da conta.
• Ao terminar a implantação, revogue o token rbt_ em Configurações › Parâmetros › Integrações (ou peça ao time Rabi para revogar a chave rbk_). Para a manutenção depois, gere um token novo quando precisar.

PARTE GChecklist

Marque conforme avança. As marcações ficam só neste navegador.

Preparação (uma vez)

• A1 · Conta GitHub da clínica e Claude com acesso a claude.ai/code
• A2 · Token rbt_ “Implantação e manutenção” gerado pela clínica (ou chave rbk_ pedida ao time Rabi) e guardado no gerenciador de senhas (nunca no chat); validade anotada
• A3 · Repositório criado pelo modelo e marcado Private
• A4 · Settings → Actions → General → Read and write → Save
• A5 · GitHub conectado ao Claude e app Claude instalado no repositório
• A6 · Ambiente da clínica com RABI_API_KEY e rede liberada para api.rabisistemas.com.br

Cada sessão

• Abrir claude.ai/code → repositório da clínica → ambiente da clínica → nova sessão
• Escrever “Vamos implantar <Nome da Clínica>” (ou “continuar”)
• Ler o resumo: onde paramos, o que mudou, validade do token
• Responder uma pergunta por vez e mandar os documentos pedidos
• Ler a prévia e só responder “pode gravar” se estiver certo
• Conferir a foto depois
• Ao parar: “vamos parar por hoje” e conferir o ESTADO.md no GitHub

Limpar marcações da sessão

Kit de implantação v0.3.0 · 25/09/2026 · Manual completo no kit: MANUAL-PASSO-A-PASSO.md · Voltar ao início do manual