Formswrite

Transforme documentos em formulários

Documentação

Formswrite MCP

Conecte o Claude Desktop, Cursor, Claude Code e outros clientes MCP à API do Formswrite.

Converta documentos em Google Forms, edite perguntas, liste e publique formulários e execute ferramentas de assistente de formulários com IA — tudo a partir do seu LLM.

O que você pode fazer

Após a instalação, seu LLM ganha acesso ao conjunto de ferramentas do Formswrite:

create_form — crie um job do Formswrite a partir de um Google Doc, PDF ou texto colado
get_form_data — leia as perguntas, opções e metadados atuais de um formulário
modify_questions — adicione, edite, exclua ou reordene perguntas
update_form_metadata — atualize título, descrição ou introdução
publish_form — publique um formulário rascunho para que ele possa receber respostas
export_form — exporte um formulário para Google Forms, Moodle, Kahoot, Quizizz, Canvas e mais de 25 outros formatos
list_jobs / get_job — navegue e inspecione seus jobs de conversão

Instalação

1. Obtenha um token de API

Entre no seu painel do Formswrite e crie um token de API em: https://app.formswrite.com/settings/api-tokens

2. Adicione ao seu cliente MCP

Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "formswrite": {
      "command": "npx",
      "args": ["-y", "@formswrite/mcp"],
      "env": {
        "FORMSWRITE_API_TOKEN": "fw_..."
      }
    }
  }
}

Reinicie o Claude Desktop. As ferramentas do Formswrite aparecerão na lista de ferramentas.

Cursor

Em Configurações → MCP, adicione:

{
  "formswrite": {
    "command": "npx",
    "args": ["-y", "@formswrite/mcp"],
    "env": { "FORMSWRITE_API_TOKEN": "fw_..." }
  }
}

Claude Code

claude mcp add formswrite -- npx -y @formswrite/mcp

Em seguida, defina o token em ~/.claude/settings.json:

{ "env": { "FORMSWRITE_API_TOKEN": "fw_..." } }

Streamable HTTP direto (sem necessidade de npm)

Se o seu cliente suportar o transporte Streamable HTTP nativamente (Cursor 0.45+, ChatGPT MCP, Claude Desktop recente), você pode pular este pacote e conectar diretamente:

URL:    https://mcp.formswrite.com/mcp
Header: Authorization: Bearer fw_...

Como funciona

Este pacote é uma pequena ponte stdio ↔ Streamable HTTP. Ele roda localmente na sua máquina, abre uma conexão com https://mcp.formswrite.com/mcp usando seu token de API e encaminha mensagens JSON-RPC entre seu cliente MCP (stdio) e o servidor Formswrite (HTTP).

Toda a lógica das ferramentas vive no backend do Formswrite — este pacote não contém lógica de negócios e nunca vê seus dados de formulário além de encaminhá-los.

Configuração

Variável de ambiente	Obrigatória	Padrão	Descrição
`FORMSWRITE_API_TOKEN`	sim	—	Token de API do seu painel Formswrite
`FORMSWRITE_MCP_URL`	não	`https://mcp.formswrite.com/mcp`	Substituição para staging ou self-hosted

Solução de problemas

A saída de diagnóstico é gravada em stderr (stdout é o canal JSON-RPC). Para ver os logs:

Claude Desktop: abra o painel de logs do MCP (Configurações → Desenvolvedor)
CLI: execute FORMSWRITE_API_TOKEN=... npx @formswrite/mcp 2>&1 >/dev/null

Problemas comuns:

Missing token — FORMSWRITE_API_TOKEN não está definido no bloco env do MCP do seu cliente
401 unauthorized — o token é inválido, expirou ou é para o ambiente errado. Gere um novo na URL do painel acima
429 rate_limited — você ultrapassou o limite de 60 req/min; diminua o ritmo

Licença

MIT — veja LICENSE.