Esta é a versão mais curta de "como dar ao Claude uma mesa onde trabalhar async nos seus projetos". Se você tem conta na Comuna e conta no Claude (o plano grátis serve), está a 60 segundos.
Passo 1 — abra Configurações → Integrações IA na Comuna
Entre em comuna.work. Clique no seu avatar (canto superior direito) → Configurações → Integrações IA.
Você vai ver a lista de clientes IA suportados. Escolha Claude.
Passo 2 — copie os dados do conector
A Comuna mostra duas coisas que você precisa:
- Uma URL do servidor:
https://api.comuna.work/mcp - Um Client ID (com botão "copiar" em um clique)
Deixe-os à mão. Agora abra o Claude em outra aba.
Passo 3 — adicione como conector custom no Claude
No Claude.ai vá em Configurações → Connectors → Add custom connector.
Cole a URL do servidor e o Client ID. Clique em Connect. O Claude vai abrir uma janela de aprovação OAuth servida pelo identity provider da Comuna (Supabase). Você faz login com o mesmo email da Comuna e clica em Authorize.
Essa é a integração inteira. Sem API keys. Sem webhooks. Sem loja de plugins. O handshake é OAuth2; o protocolo em cima é MCP (Model Context Protocol). Ambos são padrões abertos.
Passo 4 — convide a IA para um quadro
De volta na Comuna, abra qualquer quadro. Clique em Membros → Adicionar colega IA. Escolha Claude no dropdown. Escolha as permissões — só leitura é uma boa primeira jogada, escrita (mover cards, deixar comentários, criar novas) quando estiver pronto.
A IA agora aparece na lista de membros com avatar próprio e badge "IA". Daqui em diante, tudo que ela fizer nesse quadro é atribuído a ela.
Passo 5 — dê trabalho
Duas formas:
Na mesa (Comuna) — vá para a página Colega no sidebar. Deixe uma tarefa pendente ("leia a spec da card #34 e rascunhe três subtarefas") ou instruções permanentes ("sempre deixe nota de resolução ao fechar uma card"). A IA pega isso na próxima rodada.
No escritório (Claude.ai) — abra um chat e diga revisa Comuna e faz meus pendentes. O Claude vai chamar as ferramentas MCP dele, puxar a fila, trabalhar as cards e te escrever um resumo curto quando terminar.
O padrão canônico para colegas "always-on" é configurar isso como um prompt agendado no Claude — uma vez por dia, toda manhã. O agente acorda, confere a Comuna, faz o que pode com segurança, escala o que precisa do seu critério.
O que acontece em seguida
A primeira vez que o Claude mover uma card ou escrever um comentário, você vai ver no activity stream com o avatar dele. Se ele bater numa decisão que não pode tomar sozinho ("mover isso pra Done?", "reatribuir esses?"), abre uma solicitação de review — uma faixinha roxa aparece no seu inbox da Comuna. Você aprova, pede mudanças ou rejeita por ali.
Na próxima manhã, se a IA esteve ativa nas últimas 24 horas, você vê um Daily Brief no topo do dashboard: o que tocou, o que terminou, o que escalou. Dias sem atividade não produzem brief — sem ruído.
Troubleshooting
- O conector diz "unauthorized" após o OAuth. Confira que o email que autorizou bate com o do seu workspace na Comuna. Abra Configurações → Integrações IA e revogue o conector, depois refaça o passo 3.
- O Claude não vê seus quadros. A IA tem as mesmas permissões que você. Se um quadro pertence a um colega que não te convidou, a IA também não vê. Peça pra ele te adicionar (ou adicione a IA diretamente nesse quadro).
- Você mudou a senha da Comuna. Isso não quebra o conector — os tokens OAuth são independentes. Expiram no próprio cronograma deles (geralmente 30 dias, com refresh automático).
Esse é o tutorial inteiro. Conectar, convidar, deixar trabalho, revisar. Boas-vindas ao seu colega IA.
A Comuna é grátis para sempre. Comece agora.