O que você precisa saber
- Endereço do servidor:
https://trulyform.com/mcp. Não esqueça o/mcpno final. - Transporte: MCP remoto via HTTP (streamable HTTP).
- Login: OAuth com registro automático do cliente. Você entra no trulyform pelo navegador e autoriza a conexão. Não é preciso configurar chave de API, segredo do cliente nem cabeçalho de requisição.
- Planos: dá para conectar um assistente em qualquer plano do trulyform, inclusive no Free. A conta precisa ter o e-mail confirmado.
- Acesso: o assistente conectado pode ler os formulários e as respostas da sua organização, criar e editar rascunhos e publicar formulários. Não existe permissão só de leitura nem por formulário.
Configure um assistente
Um guia passo a passo para cada assistente, com o que cada um exige:
- Claude: Qualquer plano do Claude, inclusive o Free
- ChatGPT: Plus, Pro, Business, Enterprise ou Edu, na web
- Claude Code: Claude Code instalado e com login feito
- Cursor: Cursor com suporte a MCP remoto e OAuth
- Codex: Codex CLI, extensão para IDE ou app para desktop
- VS Code: VS Code com GitHub Copilot, em qualquer plano
- Mistral Vibe: Qualquer plano do Vibe, inclusive o Free
Qualquer outro cliente funciona, desde que aceite servidores MCP remotos via HTTP com OAuth e registro dinâmico de cliente.
Quer um passo a passo para criar um formulário no Claude ou no ChatGPT? Leia Como criar um formulário com Claude ou ChatGPT.
Como funciona o login
- O cliente encontra o servidor OAuth do trulyform nos metadados do servidor MCP e se registra sozinho. O trulyform trabalha com clientes públicos, então deixe em branco qualquer campo de ID ou de segredo do cliente.
- O navegador abre o trulyform para você entrar ou criar uma conta. Quem cria uma conta nova confirma o e-mail primeiro.
- O trulyform mostra uma tela de autorização com o endereço de retorno do cliente, o e-mail da conta conectada e a organização. É só autorizar.
- O cliente recebe os tokens. Cada token de acesso vale por uma hora, e o cliente o renova sozinho. Depois de 30 dias sem uso, você precisa entrar de novo.
Se o cliente oferecer a opção de "identidade publicada" ou de documento de metadados do ID do cliente, não use: ela não funciona com o trulyform. Escolha o registro automático.
Revogue o acesso
Em Configurações → Conexões de IA, no trulyform, você vê todas as conexões e pode revogar qualquer uma. A revogação bloqueia as próximas requisições na hora. O que o assistente já leu continua onde ele tiver guardado.
Quando a conexão falha
| O que acontece | Por quê | O que fazer |
|---|---|---|
HTTP 401 com o cabeçalho WWW-Authenticate: Bearer |
Você não entrou, ou o token expirou ou foi revogado | Deixe o cliente refazer o login. |
| HTTP 403 | O e-mail da conta não foi confirmado, ou a conta não tem organização | Confirme o e-mail no trulyform e conecte de novo. |
| HTTP 429 | Requisições demais | Aguarde um pouco. O limite é de 120 requisições por minuto por pessoa. |
As ferramentas retornam unauthenticated ou organization_required |
As mesmas causas, informadas pela ferramenta | Conecte de novo ou entre em uma organização no trulyform. |