La versión más corta
- En Comuna: Ajustes → Integraciones IA → Claude → copia el URL del servidor y el Client ID.
- En Claude.ai: Ajustes → Connectors → Add custom connector → pega esos valores → Connect → Authorize.
- En cualquier board de Comuna: Miembros → Añadir compañero IA → Claude → elige permisos.
- En Claude.ai: dile "revisa Comuna y haz mis pendientes".
Eso es todo. Sin API keys, sin webhooks, sin plugins, sin proxies. El handshake completo es OAuth2; el protocolo arriba es MCP (Model Context Protocol), un estándar abierto construido por Anthropic.
Un walkthrough detallado con screenshots vive en Conecta Claude a tu tablero de proyectos en 60 segundos.
Qué puede hacer Claude una vez conectado
A través de unas 80 herramientas MCP, Claude puede:
- Leer tus boards, columnas, labels, miembros
- Leer el contenido completo de cualquier card (descripción, fechas, checklist, comentarios, historial)
- Crear, mover, completar y borrar cards
- Manejar labels, asignados, fechas, dependencias, checklists, adjuntos
- Leer y escribir notas, páginas de wiki, goals, key results, milestones
- Mandar mensajes de chat y DMs en canales de proyecto
- Proponer cards nuevas para que las aceptes (escalación ligera)
- Sacar items de atención de todos tus boards (cards estancadas, fechas vencidas, reviews sin contestar)
- Reportar su propio progreso para que veas "Claude · trabajando en Card #34"
Todas las acciones se atribuyen a Claude en el activity feed. Puedes revocar el conector cuando quieras desde Comuna o desde Claude.
Permisos
La IA recibe los mismos permisos que tú, scoped por board. En un board con miembros solo-lectura, la IA puede leer pero no escribir. En un board donde tienes rights de admin, la IA puede hacer todo lo que tú puedes — a menos que la limites explícitamente desde el panel de permisos del Compañero IA.
Cuando la IA está por hacer algo que requiere tu juicio ("¿borrar esta card?", "¿reasignar estas tres?"), no lo hace. Abre una petición de review y espera.
Costo
Cero del lado de Comuna. Conectar y usar Claude es gratis en Comuna para siempre.
El costo del lado de Anthropic es lo que cubra tu plan de Claude. El free tier de Claude funciona para uso ligero; Claude Pro ($20/mes al momento de escribir esto) te da bastante más headroom. Comuna no proxiea tokens, no se lleva un cut, no agrega cargos por llamada IA.
Privacidad
Cuando Claude lee una card en tu nombre, esa card se manda a Anthropic vía MCP para esa llamada específica. Anthropic la maneja según su propia política de datos — no entrena con llamadas API tier consumer por default. Nosotros no proxieamos la data, no guardamos copia, no la reproducimos.
Los tokens OAuth del conector se guardan encriptados en Supabase, scoped a tu usuario. Revócalos cuando quieras en Ajustes → Integraciones IA de Comuna o en el panel de Connectors de Claude.
Troubleshooting
- El conector dice "unauthorized" después del OAuth. Asegúrate que el email autorizado coincide con el de tu workspace de Comuna. Revoca y rehaz el paso 2.
- Claude no ve un board. La IA hereda tus permisos. Si el dueño del board no te invitó, la IA tampoco lo ve. Pide ser añadido.
- Cambiaste tu password de Comuna. Los tokens OAuth son independientes; no se rompen. Expiran en su propio horario (~30 días, refresh automático).
- Quieres desconectar. Comuna → Ajustes → Integraciones IA → Disconnect. O en Claude.ai → Settings → Connectors → Remove. Cualquiera de los dos lados corta el link.
Otros clientes IA
ChatGPT funciona igual (Settings → Apps → Developer Mode → Create — requiere plan Plus / Pro). Gemini y Cursor están en el roadmap; el servidor MCP ya los soporta — esperamos a que esos clientes saquen GA de sus UIs de connector MCP.
Abre un workspace y conecta Claude.