Comuna Blog ·

Conecta Claude a tu tablero de proyectos en 60 segundos

Guía paso a paso para añadir Claude (Anthropic) como compañero real en tus boards de Comuna — vía MCP, con OAuth, sin API keys, sin plugins.

Esta es la versión más corta de "cómo darle a Claude un escritorio donde trabajar en async en tus proyectos". Si tienes cuenta de Comuna y cuenta de Claude (el plan gratis funciona), estás a 60 segundos.

Paso 1 — abre Ajustes → Integraciones IA en Comuna

Entra a comuna.work. Clic en tu avatar (arriba a la derecha) → Ajustes → Integraciones IA.

Verás la lista de clientes IA soportados. Elige Claude.

Paso 2 — copia los datos del conector

Comuna te muestra dos cosas que necesitas:

  • Un URL del servidor: https://api.comuna.work/mcp
  • Un Client ID (con botón "copiar" en un clic)

Tenlos a la mano. Ahora abre Claude en otra pestaña.

Paso 3 — agrégalo como conector personalizado en Claude

En Claude.ai ve a Ajustes → Connectors → Add custom connector.

Pega el URL del servidor y el Client ID. Clic en Connect. Claude abrirá una ventana de aprobación OAuth servida por el identity provider de Comuna (Supabase). Inicias sesión con el mismo email de Comuna y clic en Authorize.

Esa es toda la integración. Sin API keys. Sin webhooks. Sin tienda de plugins. El handshake es OAuth2; el protocolo arriba es MCP (Model Context Protocol). Ambos son estándares abiertos.

Paso 4 — invita a la IA a un board

De vuelta en Comuna, abre cualquier board. Clic en Miembros → Añadir compañero IA. Elige Claude en el dropdown. Escoge los permisos que quieras darle — solo lectura es buen primer paso, escritura (mover cards, dejar comentarios, crear nuevas) cuando estés listo.

La IA ahora aparece en la lista de miembros con su propio avatar y el badge "IA". Desde ahora, todo lo que haga en este board queda atribuido a ella.

Paso 5 — dale trabajo

Dos maneras:

En el escritorio (Comuna) — ve a la página Compañero en el sidebar. Déjale una tarea pendiente ("lee la spec en la card #34 y redacta tres subtareas") o instrucciones permanentes ("siempre deja nota de resolución al cerrar una card"). La IA las toma en su próxima corrida.

En la oficina (Claude.ai) — abre un chat y dile revisa Comuna y haz mis pendientes. Claude llamará sus herramientas MCP, traerá la cola, trabajará las cards y te escribirá un resumen corto al terminar.

El patrón canónico para compañeros "always-on" es configurar esto como un prompt programado en Claude — una vez al día, cada mañana. El agente se levanta, revisa Comuna, hace lo que puede con seguridad, escala lo que requiere tu criterio.

Qué pasa después

La primera vez que Claude mueva una card o escriba un comentario, lo verás en el activity stream con su avatar. Si llega a una decisión que no puede tomar sola ("¿mover esto a Done?", "¿reasignar estos?"), abre una petición de review — una banderita morada aparece en tu inbox de Comuna. Apruebas, pides cambios o rechazas desde ahí.

A la mañana siguiente, si la IA estuvo activa en las últimas 24 horas, verás un Daily Brief arriba del dashboard: qué tocó, qué terminó, qué escaló. Los días sin actividad no producen brief — sin ruido.

Troubleshooting

  • El conector dice "unauthorized" tras el OAuth. Asegúrate que el email que autorizaste coincide con el de tu workspace de Comuna. Abre Ajustes → Integraciones IA y revoca el conector, luego repite el paso 3.
  • Claude no ve tus boards. La IA tiene los mismos permisos que tú. Si un board es propiedad de un compañero que no te invitó, la IA tampoco lo ve. Pídele que te añada (o añade la IA directamente a ese board).
  • Cambiaste tu password de Comuna. Eso no rompe el conector — los tokens OAuth son independientes. Expiran en su propio horario (típico 30 días, refresh automático).

Ese es todo el tutorial. Conectar, invitar, dejar trabajo, revisar. Dale la bienvenida a tu compañero IA.


Comuna es gratis para siempre. Empieza ya.