MCP
Referencia · tools

Tools de auth

El dominio auth son las tools del sistema de acceso de Dynamo: proyectos, usuarios, miembros, qué apps están habilitadas en cada proyecto y quién tiene acceso a cuáles. Corren en el gateway con tu propia sesión — nunca con una clave de servicio: el gate real vive en la base (RLS de pg-dynamo-<env>, resuelto vía Gateway.asUser con tu identidad de Entra ya traducida), no en el MCP.

gateway remoto 9 lectura 15 escritura

La confusión #1 de este dominio: varias tools de lectura no devuelven un error de permiso — devuelven una lista vacía. El gate está escrito dentro del WHERE de la función de base de datos (p. ej. AND is_global_admin(auth.uid())), así que un usuario sin permisos ve [], exactamente igual que si no hubiera datos. Si algo te devuelve vacío y esperabas resultados, lo primero que hay que revisar es tu propia identidad, no la base — pedile a Claude dynamo_session_status (documentada en tools de ops; reemplaza a auth_session_status, que existe en el MCP stdio pero no se compone en el gateway).

Las 15 tools de escritura tocan el sistema de permisos de TODOS los productos Dynamo (forms, analytics, crm, ai, legal, el propio auth). Necesitan un token de scope write — con un token read fallan antes de tocar la base — y además ser global-admin o, en las que lo aceptan, project-admin del proyecto que estás editando. Mirá siempre el ambiente antes de escribir: QA es para probar, PROD ⚠️ es gente real. Y auth_set_user_deactivated en PROD saca a esa persona de todas las apps — y, en ≤1h, del propio MCP: pg-gateway deja de resolver su identidad (auth_app.users.status ya no es active) en cuanto vence la cache de identidad/el access token vigente, y el connector queda muerto para esa persona en los tres clientes de Claude a la vez.

Lectura (9)

Tool Qué hace Inputs Qué permiso hace falta Ejemplo de prompt
auth_list_projects Todos los proyectos de la plataforma, con cuántos miembros y cuántas apps tiene cada uno. Es la forma de pasar de un nombre de proyecto a su project_id, que piden casi todas las demás tools. ninguno Token scope read. Gate real: solo global-admin, y es por filtro — si no lo sos, ves [], no un error. "Dame la lista de todos los proyectos de Dynamo, con cuántos miembros tiene cada uno."
auth_list_users Busca usuarios por coincidencia parcial en email o nombre. Devuelve rol, proyectos y si está desactivado. Tope duro de 100 filas ordenadas por email, sin paginación — sin search ves los primeros 100 alfabéticamente y hay más que no ves. search (opcional, texto) Token scope read. Gate real: global-admin only, por filtro. "Buscá usuarios cuyo email contenga 'acme'."
auth_list_project_members Quiénes son miembros de un proyecto y cuáles son administradores de ese proyecto (is_admin). project_id (uuid) Token scope read. Gate real: global-admin o project-admin de ese proyecto, por filtro. "¿Quiénes son los miembros del proyecto Acme, y cuáles son admins?"
auth_list_project_apps Qué apps están habilitadas en el proyecto (capa de arriba del modelo de acceso — sin esto, ninguna app se le puede dar a un usuario). La más estricta de las 5. project_id (uuid) Token scope read. Gate real: global-admin ONLY — acá ni siquiera un project-admin de ese proyecto ve algo distinto de []. "¿Qué apps están habilitadas en el proyecto Acme?"
auth_list_project_app_access Quién tiene acceso a qué app dentro de un proyecto (la capa de abajo). Los global-admins no aparecen acá — su acceso es por rol, no por fila. project_id (uuid) Token scope read. Gate real: global-admin o project-admin de ese proyecto, por filtro. "¿Quién tiene acceso a analytics en el proyecto Acme?"
auth_list_organizations Todas las organizaciones de la plataforma, con su branding completo (primary_color/primary_color_dark, logos). Es la forma de resolver un nombre de organización a su organization_id, que pide auth_create_project. ninguno Token scope read. Gate real: global-admin ONLY — a diferencia de las otras 5, acá el gate es DURO: un caller sin permiso recibe un error, no []. "Dame la lista de organizaciones con sus colores de marca."
auth_check_synthetic_username Verifica si un nombre de usuario sintético está libre antes de crearlo, sin crear nada. El nombre es único global. project_id · local_name Token scope read. Gate real: se evalúa en la RPC sobre el objeto, con tu identidad. "¿Está libre el usuario «porteria» en el proyecto Acme?"
auth_list_synthetic_users Lista los usuarios sintéticos: usuario, nombre, proyecto, estado, último login. Nunca devuelve clave, hash ni sobre. project_id o organization_id (opcionales) Token scope read. Gate real: se evalúa en la RPC sobre el objeto, con tu identidad. "Listame los usuarios sintéticos de la organización EGM."
auth_list_user_sessions Lista las sesiones activas de un usuario (Entra, Google o sintético). Nunca devuelve el refresh ni el device_id. user_id Token scope read. Gate real: se evalúa en la RPC sobre el objeto, con tu identidad. "¿Qué sesiones activas tiene este usuario?"

Escritura (15)

Antes de cualquiera de estas: confirmá el ambiente (dynamo_session_status, ver tools de ops) y, si es una de las que puede arrastrar a más gente de la esperada, listá el estado actual con las tools de lectura de arriba.

Tool Qué hace Inputs Qué permiso hace falta Ejemplo de prompt
auth_add_project_member Agrega a un usuario que ya existe como miembro de un proyecto y, opcionalmente, le da apps en la misma operación. Idempotente. Las apps que no estén habilitadas en el proyecto se saltean en silencio — verificá el resultado real con auth_list_project_app_access. Con is_admin:true el usuario hereda TODAS las apps habilitadas del proyecto, no solo las que pediste. project_id (uuid) · user_id o email (al menos uno) · is_admin (bool, default false) · apps (lista, default []) Token scope write. Gate real: global-admin o project-admin de ese proyecto — is_admin:true exige global-admin. "Agregá a juan@cliente.com como miembro del proyecto Acme, con acceso a forms."
auth_remove_project_member Saca a un usuario de un proyecto (no lo borra, no lo toca en otros proyectos). Bloqueo incondicional: no se puede sacar a un global-admin, ni siquiera otro global-admin puede saltearlo. project_id (uuid) · user_id o email (al menos uno) Token scope write. Gate real: global-admin o project-admin de ese proyecto. "Sacá a juan@cliente.com del proyecto Acme."
auth_set_app_access Da o quita el acceso de una persona a una app en un proyecto. Idempotente en los dos sentidos. La app auth es especial: dársela promueve a la persona a project-admin de ese proyecto (y le da todas las apps habilitadas); quitársela la degrada. project_id (uuid) · user_id o email (al menos uno) · app (enum) · granted (bool) Token scope write. Gate real: global-admin o project-admin de ese proyecto. "Dale acceso a analytics a juan@cliente.com en el proyecto Acme."
auth_set_project_app Habilita o deshabilita una app en el proyecto (la capa de arriba). Habilitarla se la da automáticamente a todos los project-admins del proyecto. Deshabilitarla borra todos los accesos de esa app en ese proyecto — volver a habilitarla no los restaura. Por eso enabled:false exige confirm_cascade:true, y sin ese flag la tool se niega antes de tocar la base. project_id (uuid) · app (enum) · enabled (bool) · confirm_cascade (bool, obligatorio si enabled:false) Token scope write. Gate real: global-admin ONLY — ni siquiera el project-admin del proyecto puede. "Habilitá la app crm en el proyecto Acme."
auth_invite_user Invita a alguien nuevo por email: bajo Entra/Google ya no hay cuenta de auth que crear — crea (o reactiva, si el email existía desactivado) su public.profiles, lo agrega al proyecto y le da las apps indicadas, todo vía la RPC admin_invite_project_member, gateada dentro de la DB con tu identidad ya resuelta — sin clave privilegiada de por medio. El primer login de esa persona (Microsoft o Google) vincula su identidad externa al perfil por email. El correo de aviso es best-effort y este MCP no lo manda — el acceso ya quedó otorgado, avisale por otra vía. email · project_id (uuid) · apps (lista, default []) · is_admin (bool, default false) Token scope write. Gate real: global-admin ONLY. "Invitá a nueva@cliente.com al proyecto Acme con acceso a forms y analytics."
auth_set_user_deactivated Desactiva o reactiva a un usuario en toda la plataforma (nunca borra — el sistema no hace hard-delete). Bloquea el refresh del token, no la sesión activa: puede seguir operando hasta que expire su access token vigente (≤1h). No podés desactivarte a vos mismo ni al último global-admin activo. email · action (deactivate | reactivate) · user_id (opcional) Token scope write. Gate real: global-admin ONLY. "Desactivá a juan@cliente.com en toda la plataforma."
auth_create_project Crea un proyecto nuevo dentro de una organización — el mismo camino que "Nuevo proyecto" en la consola. Hasta el 2026-09-06 el alta de proyecto estaba deliberadamente fuera del MCP; una doctrina puntual la habilitó con el mismo gate de siempre. No es idempotente: llamarla dos veces con el mismo nombre crea DOS proyectos — listá primero con auth_list_projects si te importa no duplicar. Se crea sin apps habilitadas y sin más miembros que los global-admin. name · description (opcional) · organization_id (uuid, obligatorio) Token scope write. Gate real: global-admin ONLY. "Creá un proyecto nuevo llamado 'Acme Fase 2' en la organización Acme."
auth_create_organization Crea una organización nueva — nunca pisa una existente (siempre inserta). No es idempotente: llamarla dos veces con el mismo name crea DOS organizaciones (con slug distinto, porque slug es único en toda la plataforma). No hay tool de borrado ni de renombrado. name · slug · primary_color (opcional) · primary_color_dark (opcional) Token scope write. Gate real: global-admin ONLY. "Creá la organización 'Acme' (slug acme) con color primario #6B21D9."
auth_set_organization_branding Cambia solo el color de marca que pasás (primary_color y/o primary_color_dark) de una organización existente — el otro color y el name/slug quedan intactos. No renombra la organización aunque el gate interno lo permita. organization_id (uuid) · primary_color (opcional) · primary_color_dark (opcional, al menos uno de los dos) Token scope write. Gate real: global-admin ONLY. "Cambiá el color primario oscuro de la organización Acme a #1a1a1a."
auth_set_organization_deactivated Desactiva o reactiva una organización entera — apaga (o restaura) el acceso de todos sus usuarios y proyectos. Reversible (deactivated: false la reactiva). El borrado duro es auth_delete_organization y exige que la organización esté desactivada antes. organization_id (uuid) · deactivated (boolean) Token scope write. Gate real: global-admin ONLY, dentro de la RPC. "Desactivá la organización Acme."
auth_delete_organization IRREVERSIBLE. Borra DEFINITIVAMENTE una organización — la fila de organizations y su backup de branding. Precondiciones evaluadas en orden, con lock atómico: ya desactivada, cero proyectos, sin ningún cliente apuntándole en legal-dynamo. Una segunda llamada sobre el mismo id devuelve organization_not_found. organization_id (uuid) · confirm_organization_id (uuid, debe repetir EXACTAMENTE organization_id) Token scope write. Gate real: global-admin ONLY, dentro de la RPC. "Borrá definitivamente la organización Acme (confirmá con el mismo organization_id)."
auth_set_user_name Fija el nombre visible de un usuario (el que ven los selectores de usuario de DynamoForms, los PDF y los correos). No migra respuestas ni PDF ya emitidos. user_id (uuid) o email · name (1–200 caracteres) Token scope write. Gate real: global-admin o project-admin de un proyecto compartido con el usuario, dentro de la RPC. "Poné el nombre 'Ana Pérez' al usuario ana@acme.co."
auth_create_synthetic_user Crea un usuario sintético dentro de un proyecto. La clave la genera el servidor y nunca se devuelve; se obtiene con el export. project_id · local_name · name · apps Token scope write. Gate real: se evalúa en la RPC sobre el objeto, con tu identidad. "Creá el usuario sintético «porteria» en el proyecto Acme con acceso a forms."
auth_reset_synthetic_password Resetea la clave de un usuario sintético y revoca todas sus sesiones. La clave nueva no se devuelve. user_id · project_id Token scope write. Gate real: se evalúa en la RPC sobre el objeto, con tu identidad. "Reseteá la clave del usuario egm.porteria."
auth_set_synthetic_user_status Bloquea, desactiva o reactiva un usuario sintético. Bloquear o desactivar revoca sus sesiones. user_id · status (locked, deactivated o active) Token scope write. Gate real: se evalúa en la RPC sobre el objeto, con tu identidad. "Bloqueá al usuario egm.porteria."
auth_export_synthetic_users Pide la descarga de los usuarios sintéticos de una organización: devuelve solo un link de un solo uso que vence en 5 minutos. organization_id Token scope write. Gate real: se evalúa en la RPC sobre el objeto, con tu identidad. "Dame el link de exportación de los usuarios sintéticos de EGM."
auth_set_org_login_prefix Fija el prefijo de login de una organización (por ejemplo «egm»). Único entre organizaciones e inmutable una vez usado. organization_id · prefix Token scope write. Gate real: se evalúa en la RPC sobre el objeto, con tu identidad. "Fijá el prefijo de login «egm» para la organización EGM."
auth_revoke_user_sessions Revoca una sesión (sid) o todas las de un usuario, de cualquier IdP. No lo desactiva ni lo bloquea. user_id · sid (opcional) Token scope write. Gate real: se evalúa en la RPC sobre el objeto, con tu identidad. "Cerrá todas las sesiones de este usuario."

Referencia completa del modelo de acceso (por-proyecto, capas app-en-proyecto vs. app-en-usuario, la app auth como interruptor de project-admin): skill global dynamo_auth. Para errores concretos de estas tools: Troubleshooting. Para correr los MCPs en stdio localmente en vez del gateway: Para desarrolladores.