Integraciones
GitHub, Notion, Draw.io y el servidor MCP (beta) conectados a tu flujo de trabajo
Dos sistemas distintos, no confundir
GitHub se conecta por cuenta personal (pestaña Integraciones del perfil). Notion es un sistema aparte, configurado a nivel de aplicación y gestionado por proyecto, no aparece en esa misma pestaña.GitHub
La conexión con GitHub usa OAuth estándar: vas a tu perfil, pestaña Integraciones, y autorizas a P32 a acceder con permisos read:user y repo. Es por cuenta de usuario: cada persona conecta la suya, y esa conexión es la que se usa para listar y conectar repositorios en cualquier proyecto donde participe.
- El token de acceso se guarda cifrado con AES-256-GCM, nunca en texto plano.
- Se excluye explícitamente de cualquier respuesta de la API; solo se descifra en el servidor cuando hace falta.
- Si el token pierde el permiso "repo" (repos privados no visibles) o caduca, se te pide reconectar la cuenta.
Único proveedor disponible hoy
El sistema está pensado para admitir más proveedores en el futuro, pero actualmente solo GitHub está implementado en esta pestaña.Notion
Notion no es una integración por usuario: es una única cuenta de Notion configurada a nivel de toda la aplicación (por variables de entorno), que sirve a todos los workspaces y proyectos por igual. Se activa y gestiona por proyecto, desde su propio apartado, no desde el perfil.
Sincronización de un solo sentido
Los datos fluyen P32 → Notion, nunca al revés. No hay ningún mecanismo que lea contenido de Notion de vuelta hacia P32.Enlazar un proyecto crea una página en Notion (con enlace público compartible) y, opcionalmente, un Ticket Digital: una página hija estructurada así:
| Sección | Contenido |
|---|---|
| Introducción | Objetivo del proyecto y trabajo realizado (texto editable), más una imagen de portada opcional. |
| Desarrollo | Página hija con un registro cronológico auto-generado: una línea por tarea (con prioridad, equipo y estado) y un bloque por cada revisión de cliente con su resultado. |
| Secciones predefinidas (activables) | Jerarquía (árbol ASCII del repositorio conectado), info del proyecto, miembros, equipos. |
| Secciones personalizadas | Añadidas a mano desde P32: título, icono y bloques básicos (encabezados, párrafo, callout, divisor, lista, to-do, cita, toggle colapsable). |
Un botón "Sincronizar" vuelve a empujar todo el contenido a Notion: reescribe la introducción, regenera cada sección predefinida activa y reconstruye por completo la página de Desarrollo con el estado más reciente de tareas y revisiones. Es una acción manual, no una sincronización automática. Tanto las secciones predefinidas como las personalizadas se editan con el mismo constructor de bloques, en vez de un formulario fijo por tipo. Desvincular un proyecto archiva sus páginas de Notion (recuperables desde la papelera) y borra el enlace.
Draw.io
Draw.io (diagrams.net) se integra a nivel de proyecto, dentro del apartado Docs que desbloquea la categoría de equipo Dev. No es una cuenta conectada ni requiere OAuth: subes un archivo .drawio o .xml (hasta 1MB sin comprimir) y P32 valida que sea un export real de draw.io antes de guardarlo.
- El XML se comprime con gzip antes de guardarse en base de datos, y se descomprime al leerlo.
- La vista previa se renderiza embebida vía el visor público de diagrams.net, en modo solo lectura.
- Un botón "Editar" abre el diagrama directamente en el editor real de draw.io (app.diagrams.net); el contenido viaja en la URL del navegador, nunca pasa por el servidor de P32 en ese paso.
- Cada documento del apartado Docs (subida o diagrama) puede asignarse a uno o varios equipos Dev del proyecto; quien no tenga rango Manager solo ve los documentos de los equipos a los que pertenece.
No es una cuenta conectada
A diferencia de GitHub o Notion, no hay autenticación ni token propio: cualquiera con acceso al proyecto puede subir o ver diagramas de draw.io, sujeto a los mismos permisos que el resto de Docs.Servidor MCP (beta)
Funcionalidad en beta
El servidor MCP de P32 está en beta: su funcionamiento y las herramientas disponibles pueden cambiar. Por ahora cubre solo una parte de P32 (ver «Qué no cubre todavía» más abajo).P32 incluye un servidor MCP (Model Context Protocol) para que apps de IA compatibles, como Claude, trabajen en tu cuenta en tu nombre. Cada app se autoriza con tu propia cuenta de P32, sin copiar claves a mano.
Para conectarla, añade en tu cliente de IA la dirección https://<dominio-de-P32>/api/mcp. La app te llevará a P32, te pedirá iniciar sesión si hace falta y mostrará una pantalla de consentimiento con los permisos que solicita. Tras iniciar sesión vuelves a esa pantalla de autorización.
| Permiso | Qué permite | Herramientas |
|---|---|---|
p32:read | Ver workspaces, proyectos, equipos, miembros, estados de tarea, tareas y trámites. | list_workspaces, list_projects, list_teams, list_members, list_task_statuses, list_tasks, get_task, list_procedures |
p32:write | Crear y editar tareas, equipos y trámites (incluye la lectura). | create_task, update_task, set_task_status, assign_task, create_team, add_team_member, create_procedure, update_procedure_status |
Límites que aplican siempre:
- La app actúa como tú: solo ve y modifica los proyectos a los que ya tienes acceso y nunca puede hacer más de lo que harías tú en P32.
- Los miembros con rol Client quedan excluidos; el portal del cliente se sigue usando desde su propio acceso.
- No puede eliminar nada.
- Los textos escritos por otras personas (títulos o descripciones de tareas) se tratan como datos, no como instrucciones.
Puedes ver las apps autorizadas en Perfil → Seguridad → Apps de IA conectadas (nombre, dirección de retorno, permisos, fecha de conexión y último uso) y revocar el acceso cuando quieras. Revocar corta el acceso de esa app al instante.
Qué no cubre todavía
Hitos, repositorios, comunicaciones y el portal del cliente (solicitudes, revisiones y recursos) no están disponibles por MCP, ni tampoco convertir un presupuesto en pago. Tampoco hay aún un registro de las acciones que realizan las apps.