Conecte seu assistente de IA

Conectando o Grow Up a um assistente de IA, você pergunta em linguagem natural sobre vacinas, crescimento, consultas e o resto dos dados da família. Se você permitir, o assistente também registra vacinas (por exemplo, lendo a foto da caderneta), medidas, consultas, marcos e entradas do diário. Antes de salvar, ele mostra o que vai gravar e pede a sua confirmação. Toda alteração pode ser desfeita por 7 dias.

Endereço do conector

https://grow-up-brown.vercel.app/api/mcp

Cole este endereço no assistente. Ele é o mesmo em Configurações → Assistentes de IA.

Duas formas de autorizar

Para quem: Claude (web, Desktop e celular), Claude Code, ChatGPT e grok.com.

Como: Você cola o endereço, faz login no Grow Up e escolhe o que o assistente pode fazer. Não tem nada para copiar.

Token pessoal

Para quem: Assistentes que aceitam um cabeçalho Authorization: Claude Code, Cursor, Grok Bot e a API da xAI.

Como: Você cria o token em Configurações e cola no assistente.

Passo a passo por assistente

Os nomes de menus do Claude, do ChatGPT e do Grok aparecem aqui em inglês, como nesses apps. Se o seu app estiver em outro idioma, eles podem aparecer traduzidos.

Quem pode

Conectores personalizados existem no Claude e no Claude Desktop nos planos Free, Pro, Max, Team e Enterprise. No Free, só um conector personalizado.
Team e Enterprise: só Owners e Primary Owners adicionam o conector, em Organization settings → Connectors → Add → Custom → Web. Depois, cada membro conecta a própria conta em Customize → Connectors → Connect.
O Claude na web e o Claude Desktop usam a mesma conta: o conector que você adiciona em um aparece no outro.

Passo a passo (Free, Pro e Max)

Abra Customize → Connectors. No navegador, o endereço é claude.ai/customize/connectors.
Clique em + Add e depois em Add custom connector (em algumas telas o caminho aparece como Add → Custom → Web).
Em nome, digite Grow Up. É o nome que aparece na sua lista de conectores.
Cole o endereço do conector e clique em Continue.
Revise as configurações de autenticação que o Claude detectou e clique em Continue.
Em Authentication, escolha Sign in now.
Em OAuth client, deixe Use Claude's published identity (Recommended). Register automatically também funciona. Não use Use your own OAuth client.
Deixe Request headers vazio. Com o Grow Up, você usa o login.
Clique em Add.
Siga o login que o Claude abrir. No Grow Up, escolha as permissões e clique em Permitir.

Ligar o Grow Up em uma conversa

Na conversa, clique no + no canto inferior esquerdo (ou digite /), passe o mouse em Connectors e ligue o Grow Up. Essa chave vale por conversa.
Em + → Connectors → Tool access você escolhe como os conectores carregam. Auto é o padrão e serve para quase todo mundo.

Aprovar as ferramentas

Quando o Claude vai usar uma ferramenta, ele pode pedir aprovação. Use Allow always só para o que você confia que rode sem supervisão.
Sugestão: leitura e prévias (preview_*) podem rodar sem perguntar, porque não gravam nada. Aprove confirm_change e undo_change a cada vez.
Na pesquisa avançada (Research), o Claude usa as ferramentas dos conectores sem pedir aprovação. Para pesquisar, desligue as ferramentas que gravam.

Claude no celular

O conector adicionado no Claude web ou no Desktop aparece no app do celular (iOS e Android) no próximo login da mesma conta.
Adicionar conectores pelo celular ainda está em beta. Adicione no computador e use no celular.

Remover o conector

Em Customize → Connectors, clique em Remove ou nos três pontinhos do Grow Up. No Team e no Enterprise, Owners fazem isso em Organization settings → Connectors.
Para editar um conector personalizado, remova e adicione de novo.
Remover no Claude não apaga a conexão no Grow Up. Para cortar o acesso na hora, use Desconectar no Grow Up.

Avançado: Claude Code

O Claude Code conecta pelo terminal. Ele aceita o login com o Grow Up ou um token pessoal.

Opção A: login com o Grow Up (recomendada)

No terminal, adicione o servidor. Para usar em todos os seus projetos, acrescente --scope user; o padrão vale só para o projeto atual.
```
claude mcp add --transport http grow-up https://grow-up-brown.vercel.app/api/mcp
```
Dentro do Claude Code, rode /mcp, escolha grow-up e siga o login no navegador. Outro caminho, direto do terminal:
```
claude mcp login grow-up
```
Na tela do Grow Up aparece um aviso de que o app recebe a autorização no próprio computador. Isso é esperado: continue só se foi você que acabou de abrir o Claude Code, neste aparelho.
Confira com claude mcp list, que deve mostrar ✔ Connected, ou com /mcp.
Se o navegador não abrir, copie a URL que o Claude Code mostra. Se o retorno falhar, cole no prompt a URL completa da barra de endereço. Não compartilhe essa URL: ela carrega o código de autorização.

Opção B: token pessoal no cabeçalho

Crie um token no Grow Up (veja Criar um token pessoal, mais abaixo).

No terminal, troque YOUR_TOKEN pelo token:

claude mcp add --transport http grow-up https://grow-up-brown.vercel.app/api/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Se o token for recusado, o Claude Code não tenta o login e só mostra a conexão como falha. Para usar o login, remova o servidor e adicione sem o cabeçalho.
Cuidado com espaço ou quebra de linha no fim do token colado.

Prompts do Grow Up

Os prompts do Grow Up viram comandos. Digite / para ver a lista, ou rode direto. Os argumentos vão separados por espaço; para um nome com espaço, rode sem argumento e diga o nome na conversa.

/mcp__grow-up__register_vaccination_card Helena
/mcp__grow-up__child_checkup_brief Helena

Conector do claude.ai dentro do Claude Code

Se você entra no Claude Code com a conta do claude.ai, o Grow Up adicionado na web já aparece em /mcp. Se você também adicionou com claude mcp add, a configuração local tem prioridade.

Remover

Primeiro claude mcp logout grow-up, que revoga o acesso no servidor. Depois claude mcp remove grow-up, que só apaga a configuração local.

No vídeo: conectar o Grow Up ao ChatGPT, autorizar o acesso e fazer a primeira pergunta.

Quem pode

Só no computador, em chatgpt.com. A OpenAI não permite adicionar servidores MCP pelo celular.
Business: só admins e owners do workspace criam o plugin. Enterprise e Edu: admins e owners, ou membros com a permissão Create plugins with MCPs.
Segundo a OpenAI, o Pro conecta servidores MCP com permissão de leitura, e o acesso completo, com registro, está por enquanto no Business e no Enterprise/Edu.

Passo a passo (chatgpt.com)

Abra chatgpt.com/plugins (no menu lateral: Plugins).
No canto superior direito, clique em Add e escolha Add custom MCP server.
Na janela, deixe Icon vazio, digite Grow Up em Name e, se quiser, uma descrição.
Em Connection, deixe Server URL selecionado e cole o endereço do conector. Em Authentication, deixe OAuth.
Não mexa em Advanced OAuth settings. O ChatGPT descobre tudo sozinho a partir do endereço.
Leia o aviso Custom MCP servers introduce risk. e marque I understand and want to continue.
Clique em Create as a plugin e espere o ChatGPT ler o servidor.
Na janela Connect Grow Up, que avisa o que o ChatGPT pode compartilhar com o app, clique em Connect Grow Up.
Abre o Grow Up. Faça login se pedir. Na tela Conectar ChatGPT, escolha as permissões e clique em Permitir.
Você volta para Plugins, com o Grow Up em Installed.

Usar numa conversa

Abra uma conversa nova, digite @ (por exemplo, @Grow) e escolha Grow Up na lista.
Faça a pergunta, por exemplo: “Quais vacinas da minha filha estão pendentes?”.
A escolha do app vale para aquela mensagem. Para continuar falando do que ele já respondeu, não precisa repetir. Para buscar dados novos ou registrar algo, cite @Grow Up de novo.
Se ele escolher a ferramenta errada, seja explícito: “Use o Grow Up para…” ou “não use a busca na web, só o Grow Up”.
Para registrar a caderneta, anexe a foto e escreva: “@Grow Up registre as vacinas desta foto da caderneta”.

Confirmações

As ferramentas de leitura e as prévias do Grow Up são marcadas como só leitura. confirm_change e undo_change gravam dados, e o ChatGPT pede a sua confirmação antes, além da confirmação que o Grow Up pede na conversa.
Na confirmação, dá para abrir os detalhes e ver o que vai ser enviado, e lembrar a escolha só naquela conversa. Uma conversa nova pergunta de novo.
Em Settings → Plugins (chatgpt.com/settings/plugins-settings), cada plugin tem uma Permission. O padrão é Allow low-risk tools. Não libere as ferramentas que gravam para rodar sem perguntar.

Quando o Grow Up ganhar ferramentas novas

Em Plugins, abra o Grow Up, clique em Refresh e comece uma conversa nova.

Remover o plugin

Abra Settings → Plugins (chatgpt.com/settings/plugins-settings) e clique em Grow Up.
Clique em Uninstall, o botão vermelho no topo.
Para cortar o acesso na hora, use também Desconectar no Grow Up.

Quem pode

Segundo a xAI, os conectores estão disponíveis para todos os usuários do Grok. Se a opção Custom ainda não aparecer para você, ela pode chegar à sua conta depois.
Grok Business e Enterprise: um admin precisa cadastrar o conector antes no console. Só depois ele aparece para os membros.

Passo a passo (grok.com)

Abra grok.com/connectors. De dentro do chat também dá: clique no +, escolha Connectors e depois + Add connector.
Clique em New Connector e escolha Custom.
Cole o endereço do conector e siga o login que o Grok mostrar.
No Grow Up, faça login se pedir, escolha as permissões e clique em Permitir. O Grok se identifica sozinho, por isso a tela avisa que o Grow Up não verificou o nome dele.
O Grok descobre as ferramentas do Grow Up e as deixa disponíveis nas conversas.

Usar numa conversa

O Grok usa as ferramentas do conector quando a pergunta tem a ver com ele. Para ajudar, cite o Grow Up na pergunta: “Quais vacinas da minha filha estão atrasadas no Grow Up?”.
Para registrar a caderneta, mande a foto e peça para registrar no Grow Up.

Grok no celular

Nos apps do Grok (iOS e Android), os conectores ficam em Settings → Connectors. Adicione o Grow Up em grok.com, no computador.

Remover

Para cortar o acesso do Grok, use Desconectar no Grow Up. Funciona na hora, com qualquer assistente.

Grok Bot e API da xAI

Eles usam um token pessoal. Em Configurações → Assistentes de IA, a parte Como conectar traz os exemplos prontos com o endereço do Grow Up.

A tela de autorização do Grow Up

Depois de colar o endereço, o assistente abre o Grow Up. Faça login se pedir e confira a tela antes de permitir.

Título: “Conectar” e o nome do app, com o nome da sua família logo abaixo. Confira se é a família certa.
Quem pede: “Identificado por” e o endereço do app (por exemplo, claude.ai). Apps que se registram sozinhos, como o Grok, aparecem com o aviso de que o Grow Up não verificou o nome.
Para onde volta: o endereço para onde você volta ao terminar.
Aviso de app local: aparece no Claude Code, que recebe a autorização no próprio computador.
Conta: o seu nome e e-mail no Grow Up.

Sempre incluído

Ler o nome, a data de nascimento, a saúde, as vacinas, o crescimento, o desenvolvimento e a escola das crianças. Anexos aparecem por nome e tipo, nunca o arquivo.

Opcional

As três caixas começam desmarcadas. Marque só o que o assistente precisa.

Caixa na tela: “Permitir registrar vacinas, medidas, consultas e marcos. O app só cria registros, e cada um pode ser desfeito em Configurações por 7 dias.”: O que libera: Registrar com prévia e confirmação, e desfazer. O assistente só cria registros: não edita nem apaga o que já existe.
Caixa na tela: “Incluir finanças: contas, lançamentos e metas”: O que libera: Contas, lançamentos, metas e lembretes de aporte. Sem essa caixa, nenhum valor em dinheiro aparece.
Caixa na tela: “Incluir o diário: ler as entradas e, com registro permitido, escrever novas”: O que libera: Ler o diário. Junto com registro, também escrever no diário. A leitura do diário não faz parte do “Sempre incluído”.

Clique em Permitir. Negar volta para o app sem dar acesso. Se nada acontecer depois de permitir, use o link “Se nada acontecer, continue…”.
Para mudar as permissões depois, conecte de novo (no Claude, remova e adicione outra vez; no ChatGPT, use Uninstall e adicione de novo) e marque outras caixas. Cada autorização vira uma conexão separada em Configurações: desconecte a antiga.
O acesso se renova sozinho enquanto você usa. A conexão expira se ficar 30 dias sem uso.

Primeiros testes

Ligue o Grow Up na conversa (no Claude, pelo + → Connectors; no ChatGPT, com @Grow Up em cada mensagem; no Grok, citando o Grow Up) e tente:

Só leitura (funciona com a permissão básica)

“Quais vacinas da minha filha estão atrasadas?”
“Quando é a próxima vacina da Helena?”
“Como está o crescimento do Theo? Ele está em qual percentil de peso?”
“Quais consultas e lembretes tenho nos próximos 30 dias?”
“Me mostra a carteirinha de emergência da Helena: alergias, tipo sanguíneo e remédios.”
“Com finanças: quanto já guardamos para a meta da faculdade?”

Prompts prontos do Grow Up

Registrar a caderneta (register_vaccination_card): lê a foto da caderneta e registra as doses, com prévia para você confirmar. Precisa da caixa de registro.
Resumo para a consulta (child_checkup_brief): crescimento e percentis, vacinas atrasadas ou próximas, remédios, alergias e perguntas para o pediatra.

No Claude Code, os prompts viram comandos com /. Nos outros assistentes, peça com as suas palavras, por exemplo: “Registre no Grow Up as vacinas desta foto da caderneta da Helena”, com a foto anexada.

O assistente também pode consultar o calendário de vacinação do PNI/SUS direto no Grow Up.

Como funcionam os registros

Prévia. O assistente manda ao Grow Up o que entendeu (por exemplo, 5 doses da caderneta). O Grow Up confere, aponta duplicados e o que precisa de escolha, e não grava nada. A prévia vale 30 minutos.
Você confirma. O assistente mostra o resumo e pergunta. Só depois do seu “sim” ele grava. Confirmar duas vezes não duplica nada.
Desfazer por 7 dias. Peça “desfaz o último registro” ou vá em Configurações → Assistentes de IA → Alterações por IA → Desfazer. Desfazer apaga só o que o assistente criou, e registros que você editou depois ficam como estão. Depois de 7 dias, corrija ou apague na tela de cada registro.

Desconectar e revogar

No Grow Up (corta o acesso na hora, com qualquer assistente)

Abra Configurações → Assistentes de IA.
Em Assistentes conectados, cada conexão mostra o nome e o endereço do app (ou o começo do token), o acesso dado, quem autorizou e quando, o último uso e a validade.
Clique em Desconectar e confirme. O assistente perde o acesso na hora.
Se quiser, remova o conector também no assistente, para ele sumir da lista de lá.

Criar um token pessoal (Claude Code, Cursor, Grok Bot, API da xAI)

Na mesma seção, em Criar token, dê um nome ao assistente (por exemplo, “Claude Code no notebook”). Crie um token para cada assistente: assim você desconecta um sem afetar os outros.
Escolha a validade: 30 dias, 90 dias (padrão), 1 ano ou sem validade.
O token sempre lê saúde, vacinas, crescimento, desenvolvimento e escola. Marque o que mais precisar: registro, finanças, diário.
Marque a autorização, digite a sua senha e clique em Criar token.
Copie o token na hora: ele não aparece de novo. Guarde num gerenciador de senhas e nunca cole em chat, e-mail ou print.
Para revogar, use Desconectar na lista.

Problemas comuns

401 “No authorization provided”: Causa provávelO assistente ainda não fez login. É esse aviso que inicia o login.; O que fazerNo Claude, clique em Connect no conector. No Claude Code, rode /mcp ou claude mcp login grow-up.
401 “The access token is invalid, revoked or expired”: Causa provávelO acesso foi desconectado em Configurações, expirou, ficou 30 dias sem uso ou o token foi colado errado.; O que fazerCom login, conecte de novo. Com token, crie outro e troque no assistente. Confira se não sobrou espaço no fim.
403 “Insufficient scope”, ou o assistente diz que não pode registrar: Causa provávelA conexão não tem a caixa de registro (ou de diário, para entradas do diário).; O que fazerConecte de novo marcando a caixa, ou crie um token com a permissão. Depois desconecte a conexão antiga.
Finanças ou diário não aparecem: Causa provávelAs caixas de finanças ou de diário ficaram desmarcadas.; O que fazerConecte de novo marcando a caixa.
503 “Grow Up could not check the token”: Causa provávelFalha temporária no Grow Up.; O que fazerEspere uns 30 segundos e tente de novo.
“Não foi possível conectar”: o pedido do app está incompleto, ou o app não está registrado: Causa provávelO pedido do app veio quebrado ou é antigo.; O que fazerVolte ao app e conecte de novo do zero. No Claude, remova e adicione.
“O Grow Up não aceita o app identificado por…”: Causa provávelO app usou uma identidade que o Grow Up não aceita.; O que fazerNo Claude, escolha Use Claude's published identity ou Register automatically. Em outro assistente, avise o suporte do Grow Up.
“O endereço de retorno pedido pelo app não é um dos que ele registrou”: Causa provávelO retorno é diferente do registrado.; O que fazerRemova e adicione o conector de novo.
“Aceite os Termos atualizados para continuar.”: Causa provávelOs Termos de Uso mudaram.; O que fazerAceite os termos no Grow Up e conecte de novo. Você volta direto para a tela de autorização.
“Muitas tentativas. Tente de novo daqui a uma hora.”: Causa provávelMuitas telas de autorização abertas em uma hora.; O que fazerEspere e tente de novo.
Cliquei em Permitir e nada aconteceu: Causa provávelO navegador não seguiu o redirecionamento.; O que fazerUse o link “Se nada acontecer, continue…” na mesma tela.
As ferramentas não aparecem no Claude: Causa provávelO conector está desligado nesta conversa, ou a conexão falhou.; O que fazerLigue o Grow Up em + → Connectors. Em Customize → Connectors, veja se ele está conectado. Se não estiver, remova e adicione de novo.
Claude: “Couldn't reach the MCP server”: Causa provávelO Claude não conseguiu descobrir como fazer login no Grow Up.; O que fazerConfira o endereço colado. Se estiver certo, tente de novo mais tarde ou avise o suporte do Grow Up.
Claude Code: “Failed to connect” com 401: Causa provávelO token no cabeçalho é inválido. Com cabeçalho, o Claude Code não tenta o login.; O que fazerCorrija o token, ou remova o servidor e adicione sem o cabeçalho.
ChatGPT: não aparece Add custom MCP server, ou a opção está bloqueada: Causa provávelO plano ou o workspace não permite. No Business, só admins e owners. No Enterprise/Edu, é preciso a permissão Create plugins with MCPs.; O que fazerPeça ao admin do workspace. Use o computador: no celular a opção não existe.
ChatGPT respondeu sem usar o Grow Up: Causa provávelO app não foi escolhido nesta mensagem. A escolha vale por mensagem.; O que fazerComece a mensagem com @Grow Up. Se precisar, acrescente “use só o Grow Up, não a busca na web”.
ChatGPT só lê e não registra: Causa provávelSegundo a OpenAI, o Pro só conecta com permissão de leitura; o registro está no Business e no Enterprise/Edu. Também pode ser a caixa de registro desmarcada no Grow Up.; O que fazerConfira a caixa de registro e conecte de novo marcando-a.
ChatGPT: uma ferramenta nova do Grow Up não aparece: Causa provávelO ChatGPT guarda a lista de ferramentas de quando conectou.; O que fazerPlugins → Grow Up → Refresh, e comece uma conversa nova. Num workspace Business ou Enterprise, o admin precisa publicar a atualização.
ChatGPT pede confirmação toda vez que vai registrar: Causa provávelÉ o esperado: confirmar grava dados, e o ChatGPT pede confirmação antes de gravar.; O que fazerConfira o resumo e aprove.
Grok: não aparece Custom em New Connector: Causa provávelA sua conta ainda não tem conectores personalizados, ou, no Business e no Enterprise, só o admin adiciona.; O que fazerNo Business e no Enterprise, peça ao admin. Nos outros planos, tente de novo mais tarde.