Passo a passo da conexão
Adicione o trulyform
ao Claude Code.
Basta um comando no terminal e um login no navegador. A partir daí, o Claude Code cria e lê seus formulários enquanto você trabalha no projeto.
Antes de começar
Do que você precisa
- O Claude Code instalado e com login feito, e um terminal aberto em qualquer pasta.
- Uma conta do trulyform. Dá para criar uma quando o navegador abrir para o login.
- Se a sua empresa gerencia o Claude Code, as configurações dela podem liberar ou bloquear servidores MCP. Seu admin sabe dizer quais.
O MCP está incluído no plano Free do trulyform. Não tem chave de API para criar nem colar no shell.
Passo 1
Adicione o servidor pelo terminal
Rode isto uma vez, em qualquer pasta:
Comando de instalação do Claude Code
claude mcp add --transport http --scope user trulyform 'https://trulyform.com/mcp'Selecione o texto para copiá-lo.
O Claude Code mostra uma linha Added quando a configuração é salva.
Qual escopo escolher
--scope user, como acima, carrega o trulyform em todos os seus projetos. A configuração fica em~/.claude.jsone só você tem acesso a ela.- Sem o escopo, o trulyform fica disponível só no projeto atual.
--scope projectgrava a configuração em.mcp.json, e os colegas recebem pelo controle de versão. O Claude Code pede que cada pessoa aprove os servidores do projeto, e cada um entra com a própria conta do trulyform.
Agora rode claude mcp list. O trulyform mostra ! Needs authentication até você fazer login. É assim mesmo.
Passo 2
Autentique com /mcp
- Inicie uma sessão com
claudee digite/mcp. - Selecione trulyform, pressione Enter e escolha Authenticate. O navegador abre a página de login do trulyform.
- Entre na sua conta ou escolha Criar conta. Se a conta for nova, confirme o e-mail primeiro, abrindo o link no mesmo navegador.
- Na tela de aprovação, o endereço de retorno fica na sua própria máquina:
http://localhost:PORT/callback, com uma porta que o Claude Code escolhe. Confira seu e-mail e sua organização e escolha Aprovar acesso. - De volta ao terminal, o trulyform aparece conectado.
Prefere não sair do shell? claude mcp login trulyform faz o mesmo login. Por SSH, ou em qualquer máquina sem navegador, ele mostra um link para você abrir em outro aparelho. Depois de aprovar, copie o endereço completo da barra de endereços desse navegador e cole no prompt do terminal. Conecte com ssh -t para o prompt aceitar o texto colado.
O que você autoriza
Ler os formulários e as respostas da sua organização atual, criar formulários, editar rascunhos e publicar. Isso inclui os formulários dos colegas, e não dá para liberar só a leitura nem escolher formulários específicos. Os dados que o assistente busca vão para ele e seguem as políticas dele.
Passo 3
Confirme que está conectado
No shell, claude mcp list agora deve mostrar ✔ Connected ao lado do trulyform. Dentro de uma sessão, /mcp mostra quantas ferramentas ele tem: dez.
Depois, peça ao Claude algo que só existe na sua conta:
Prompt para testar a conexão
Liste meus formulários do trulyform.Selecione o texto para copiá-lo.
Na primeira vez, o Claude Code pode pedir permissão para usar a ferramenta; é só aprovar. A chamada aparece com o nome do servidor trulyform, sinal de que a resposta veio da sua conta. Uma conta nova ainda não tem formulários, então uma lista vazia também está certa.
Passo 4
Teste no projeto que você vai lançar
Como o Claude Code lê o seu repositório, o formulário pode perguntar sobre o que você está lançando de verdade. Na pasta do projeto, experimente:
Prompt para o primeiro formulário
Leia o README e as mudanças mais recentes deste repositório. Depois, crie no trulyform um formulário de feedback para quem está testando esta versão: quais recursos novos usou, uma nota de 1 a 5, o que atrapalhou e um e-mail opcional. Salve como rascunho e não publique.Selecione o texto para copiá-lo.
Abra o rascunho no trulyform e mude o que quiser. Quando estiver pronto:
Prompt para publicar
Já revisei no trulyform o formulário de feedback da nova versão. Leia o rascunho mais recente e publique essa revisão. Depois, coloque o link público no README, numa seção chamada Feedback.Selecione o texto para copiá-lo.
O publish_form exige a revisão que você conferiu. Se o rascunho mudou desde a última vez que o Claude o leu, o trulyform recusa a publicação até ele ler a versão mais recente.
Saia ou remova o trulyform
- Em
/mcp, selecione o trulyform e escolha Clear authentication para apagar o login que o Claude Code guardou.claude mcp logout trulyformfaz o mesmo pelo shell. claude mcp remove trulyformremove o servidor, junto com o login e o registro de client que o Claude Code guardou para ele.- Para encerrar o acesso do nosso lado também, abra Configurações → Conexões de IA no trulyform e escolha Revogar acesso na conexão do Claude Code.
Revogar bloqueia novos pedidos, mas não apaga nada que o Claude Code já recebeu.
Gerenciar conexões de IAQuando o Claude Code não conecta
O navegador não abriu, ou deu erro depois que aprovei.
Se o navegador não abrir, copie o link que o Claude Code mostra e abra você mesmo. Se a página não carregar depois de aprovar, copie o endereço completo da barra de endereços do navegador e cole no prompt do Claude Code.
O /mcp mostra No MCP servers configured.
Provavelmente o servidor foi adicionado em outra pasta com o escopo local padrão, que vale só para aquele projeto. Rode o comando acima de novo; com --scope user, ele carrega em qualquer pasta.
O Claude Code diz que o servidor não é permitido pela política da empresa.
Sua organização limita quais servidores MCP o Claude Code pode usar. A mensagem diz Cannot add MCP server "trulyform": not allowed by enterprise policy. Peça ao seu admin para liberar a URL do servidor do trulyform.
O trulyform pede autenticação de novo.
Abra /mcp, selecione o trulyform e escolha Re-authenticate. Isso acontece depois que o acesso é revogado no trulyform ou quando a conexão fica 30 dias sem uso.
Documentação do Claude Code
Conferimos este passo a passo com as páginas abaixo em 3 de outubro de 2026. Como o Claude Code atualiza as telas de vez em quando, vale sempre o que diz a documentação oficial dele.
Ainda precisa de ajuda? Fale com a gente.