← Início

Manual de instalação

Pré-requisitos

• Node.js
  É o programa que faz o servidor rodar; os comandos npm e npx vêm junto. Você precisa da versão 18 ou mais nova. Para conferir, abra o terminal e digite node --version. Se não tiver, baixe a versão LTS em nodejs.org.
• Claude Code
  É por ele que você conversa com o servidor (code.claude.com/docs).
• Uma conta Google
  A mesma em que os formulários vão aparecer.

Passo 1 — Autorize com a sua conta Google

1. Rode o comando de autorização:
   npx -p mcp-server-google-forms mcp-server-google-forms-token
   O navegador abre sozinho na tela de login do Google.
2. Entre com a sua conta Google e permita o acesso.
   A tela mostra o app Forms IA (MCP) — verificado pelo Google, sem avisos de segurança. Confira as permissões (criar/editar formulários e ler respostas) e clique em Continuar/Permitir. No terminal aparece “Pronto. refreshToken salvo…” — deu certo.

Passo 2 — Registre no Claude Code

Rode o comando:

claude mcp add google-forms -- npx mcp-server-google-forms

Passo 3 — Peça ao Claude

Pronto: peça ao Claude, por exemplo, “crie um quiz de 5 perguntas sobre fotossíntese, valendo 2 pontos cada, e me dê o link”.

Usar em outro computador

É só repetir os Passos 1 e 2 na máquina nova — sem arquivos, sem configuração.

Atalho para quem não quer refazer o login: copie a pasta ~/.config/mcp-server-google-forms/ (no Windows, C:\Users\SeuNome\.config\mcp-server-google-forms\) do computador antigo para o mesmo lugar no novo — o arquivo config.json dentro dela guarda a sua autorização. A pasta começa com ponto e por isso fica oculta; para abri-la, cole o caminho na barra de endereço do Explorer (Windows), ou use Cmd + Shift + G no Finder (Mac).

Solução de problemas

• “Credenciais expiradas ou revogadas” — rode o comando de autorização de novo (Passo 1) e refaça o login; o servidor recarrega as credenciais sozinho, sem reiniciar nada.
• O navegador não abriu? — o terminal também imprime a URL de autorização; copie e cole no navegador.
• Usa o seu próprio projeto do Google Cloud? Os problemas específicos desse caso (app não verificado, usuário de teste, expiração de 7 dias) estão no apêndice abaixo.

O passo a passo completo também está no README do projeto.

Apêndice — Usar o seu próprio projeto do Google Cloud (avançado)

Por padrão, o app usa a credencial verificada do Forms IA (MCP) — e a sua autorização e os seus dados continuam só na sua conta e na sua máquina. Se mesmo assim você preferir usar um projeto seu no Google Cloud (por exemplo, para ter as suas próprias cotas), o app respeita: basta colocar um client_secret*.json seu na pasta de credenciais, que ele tem prioridade sobre a credencial embutida.

1. Crie o projeto e a credencial em console.cloud.google.com:

1. Crie um projeto (seletor de projetos → Novo projeto).
2. Ative a Google Forms API (busque pelo nome e clique em Ativar).
3. Configure a Tela de permissão OAuth (tipo Externo; preencha nome e e-mails).
4. Adicione-se como usuário de teste — sem isso, a autorização falha com “acesso negado”.
5. Crie a credencial: Credenciais → Criar credenciais → ID do cliente OAuth → tipo App para computador.
6. Baixe o JSON na hora da criação — o Google não deixa baixá-lo depois (se perder, crie outro cliente).

2. Coloque o client_secret*.json em ~/.config/mcp-server-google-forms/ (Windows: C:\Users\SeuNome\.config\mcp-server-google-forms\; crie a pasta se não existir).

3. Rode o comando de autorização (Passo 1 acima). O terminal confirma: “Usando o seu projeto próprio do Google Cloud”.