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.
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.