Pular para o conteúdo

Passo a passo da conexão

Leve o trulyform
para o VS Code.

Instale o trulyform como servidor MCP e faça login pelo VS Code. A partir daí, o agente do GitHub Copilot cria formulários e lê respostas sem você sair do código.

Antes de começar

Do que você precisa

  • Um VS Code atualizado. O login em servidores MCP chegou na versão 1.101, e os nomes abaixo vêm da 1.140.
  • GitHub Copilot. O GitHub inclui MCP em todos os planos do Copilot, inclusive o Free.
  • No Copilot Business ou Enterprise, o admin precisa ativar a política MCP servers in Copilot, que o GitHub deixa desligada por padrão.
  • Uma conta do trulyform, que você também pode criar durante o login.

O plano Free do trulyform inclui MCP, e nada roda na sua máquina: o servidor é on-line, então não há pacote nem comando para instalar.

Passo 1

Adicione o trulyform com um clique

No computador onde o VS Code está instalado, abra:

Adicionar ao VS Code

O navegador passa o link para o VS Code, que mostra a página do servidor trulyform. Selecione Install. O link só define o nome, http como tipo e a nossa URL.

Ou adicione pela Command Palette

  1. Rode MCP: Add Server... na Command Palette (paleta de comandos).
  2. Escolha HTTP (HTTP or Server-Sent Events).
  3. Em Enter Server URL, cole:

URL do servidor MCP

https://trulyform.com/mcp

Selecione o texto para copiá-lo.

  1. Em Enter Server ID, troque o ID sugerido por trulyform.
  2. Escolha Global para usar em todos os workspaces e depois Copilot Global.

Compartilhe com um projeto

Para todo mundo no repositório ter a mesma configuração, faça commit de um arquivo .mcp.json na raiz do workspace:

Configuração MCP do VS Code

{
    "mcpServers": {
        "trulyform": {
            "type": "http",
            "url": "https://trulyform.com/mcp"
        }
    }
}

Selecione o texto para copiá-lo.

O arquivo não guarda credenciais. Cada colega entra com a própria conta do trulyform na primeira vez que o servidor inicia. Enquanto a pasta estiver em Restricted Mode, o VS Code não roda servidores definidos em arquivos do workspace.

Passo 2

Permita o login

Quando o servidor inicia pela primeira vez, o VS Code pergunta: “The MCP Server Definition 'trulyform' wants to authenticate to trulyform.com.” (o servidor quer se autenticar em trulyform.com). Selecione Allow e o navegador abre o trulyform.

  1. Entre na sua conta, ou crie uma e confirme o e-mail nesse navegador.
  2. Na tela de aprovação, o endereço de retorno é o do VS Code: normalmente http://127.0.0.1:33418/, ou https://vscode.dev/redirect quando o endereço local não está disponível.
  3. Confirme o e-mail e a organização e escolha Aprovar acesso.

O pedido não apareceu? Rode MCP: List Servers, selecione o trulyform e escolha Start Server.

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

Use o trulyform no modo agente

  1. Abra o Chat pelo menu Chat na barra de título, em Open Chat.
  2. Selecione Agent no seletor de agente.
  3. Em Configure Tools, confira se as ferramentas do trulyform estão marcadas.

Prompt para testar a conexão

Liste meus formulários do trulyform.

Selecione o texto para copiá-lo.

O trulyform marca as ferramentas de leitura como somente leitura, então o Copilot pode rodar list_forms sem pedir confirmação. Uma conta nova não tem formulários, e uma lista vazia também mostra que a conexão está funcionando.

Para ferramentas que alteram algo, o Copilot pergunta antes. Allow in this Session é o botão principal; o menu dele traz também Allow Once e Always Allow Tools from trulyform, e Skip recusa.

Crie um formulário a partir do seu projeto

Prompt para o primeiro formulário

Leia os arquivos README e CONTRIBUTING deste repositório. Crie no trulyform um formulário de boas-vindas para quem quer começar a contribuir: nome e usuário do GitHub, que áreas do projeto mais interessam, quanto tempo a pessoa pode dedicar por mês e o que ajudaria na primeira contribuição. Salve como rascunho e não publique.

Selecione o texto para copiá-lo.

Dê uma olhada no rascunho no trulyform. Quando estiver bom, peça ao Copilot para publicar e colocar o link do formulário no CONTRIBUTING.

Sair, parar ou desinstalar

Em MCP: List Servers
Selecione o trulyform para Stop Server, Restart Server, Show Output e Sign Out.
Desinstalar
Na visualização Extensions, encontre o trulyform em MCP Servers - Installed e escolha Uninstall. Um servidor adicionado ao .mcp.json some quando você apaga a entrada dele.
Revogar no trulyform
Em Configurações → Conexões de IA, escolha Revogar acesso na conexão do VS Code.

Revogar bloqueia novos pedidos; as respostas que já apareceram no chat continuam lá.

Gerenciar conexões de IA

Quando o VS Code não conecta

O Copilot ignora o trulyform.

Confira se você está no modo Agent e se o trulyform está marcado em Configure Tools. Citar o trulyform no pedido também ajuda.

Os servidores MCP estão bloqueados na minha conta.

No Copilot Business ou Enterprise, um admin precisa ativar MCP servers in Copilot. Algumas empresas também limitam o MCP por políticas de dispositivo do VS Code. Fale com quem cuida do seu ambiente.

O login falha ou fica em loop.

Abra MCP: List Servers, selecione o trulyform e escolha Show Output; o login em si aparece no canal de saída Auth: trulyform.com. Para recomeçar, rode Authentication: Remove Dynamic Authentication Providers e inicie o servidor de novo.

O VS Code pede para eu entrar no trulyform de novo.

Isso acontece depois de uma revogação no trulyform ou após 30 dias sem usar a conexão. Permita o login e aprove mais uma vez.

Documentação do VS Code

Conferimos este passo a passo com as páginas abaixo em 4 de outubro de 2026. Como o VS 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.

Conectou?
Agora é só pedir.

Peça perguntas mais claras, um rascunho melhor ou um resumo das respostas. Tem muita coisa para experimentar.

Ver o que dá para fazer