A versão mais curta
- Na Comuna: Configurações → Integrações IA → Claude → copie a URL do servidor e o Client ID.
- No Claude.ai: Configurações → Connectors → Add custom connector → cole esses valores → Connect → Authorize.
- Em qualquer board da Comuna: Membros → Adicionar colega IA → Claude → escolha permissões.
- No Claude.ai: diga "revisa Comuna e faz meus pendentes".
É só isso. Sem API keys, sem webhooks, sem plugins, sem proxies. O handshake inteiro é OAuth2; o protocolo em cima é MCP (Model Context Protocol), um padrão aberto construído pela Anthropic.
Um walkthrough detalhado com screenshots vive em Conecte Claude ao seu quadro de projetos em 60 segundos.
O que o Claude pode fazer uma vez conectado
Através de cerca de 80 ferramentas MCP, o Claude pode:
- Ler seus boards, colunas, labels, membros
- Ler o conteúdo completo de qualquer card (descrição, datas, checklist, comentários, histórico)
- Criar, mover, completar e deletar cards
- Gerenciar labels, atribuídos, datas, dependências, checklists, anexos
- Ler e escrever notas, páginas de wiki, goals, key results, milestones
- Enviar mensagens de chat e DMs em canais de projeto
- Propor cards novas para você aceitar (escalação leve)
- Trazer itens de atenção de todos seus boards (cards estagnadas, datas vencidas, reviews sem resposta)
- Reportar seu próprio progresso para você ver "Claude · trabalhando na Card #34"
Todas as ações são atribuídas ao Claude no activity feed. Você pode revogar o conector quando quiser pela Comuna ou pelo Claude.
Permissões
A IA recebe as mesmas permissões que você, escopadas por board. Num board com membros só-leitura, a IA pode ler mas não escrever. Num board onde você é admin, a IA pode fazer tudo que você faz — a menos que você limite explicitamente pelo painel de permissões do Colega IA.
Quando a IA está prestes a fazer algo que precisa do seu julgamento ("deletar esta card?", "reatribuir essas três?"), ela não faz. Abre uma requisição de review e espera.
Custo
Zero do lado da Comuna. Conectar e usar Claude é grátis na Comuna para sempre.
O custo do lado da Anthropic é o que seu plano do Claude cobre. O free tier do Claude funciona para uso leve; Claude Pro ($20/mês na hora desta escrita) te dá bem mais headroom. A Comuna não proxia tokens, não pega cut, não adiciona cobrança por chamada IA.
Privacidade
Quando o Claude lê uma card no seu nome, essa card vai para a Anthropic via MCP para essa chamada específica. A Anthropic lida segundo sua própria política de dados — não treina em chamadas API tier consumer por default. A gente não proxia os dados, não guarda cópia, não reproduz.
Os tokens OAuth do conector são guardados criptografados no Supabase, escopados ao seu usuário. Revogue quando quiser em Configurações → Integrações IA da Comuna ou no painel de Connectors do Claude.
Troubleshooting
- O conector diz "unauthorized" após o OAuth. Confira que o email autorizado bate com o do seu workspace na Comuna. Revogue e refaça o passo 2.
- O Claude não vê um board. A IA herda suas permissões. Se o dono do board não te convidou, a IA também não vê. Peça pra ser adicionado.
- Você mudou a senha da Comuna. Os tokens OAuth são independentes; não quebram. Expiram no próprio cronograma (~30 dias, refresh automático).
- Você quer desconectar. Comuna → Configurações → Integrações IA → Disconnect. Ou em Claude.ai → Settings → Connectors → Remove. Qualquer lado corta o link.
Outros clientes IA
ChatGPT funciona do mesmo jeito (Settings → Apps → Developer Mode → Create — precisa de plano Plus / Pro). Gemini e Cursor estão no roadmap; o servidor MCP já suporta — estamos esperando esses clientes liberarem GA dos seus UIs de connector MCP.
Abra um workspace e conecte Claude.