MCP
Referencia · tools

Tools de pqrs

El dominio pqrs es el flujo de peticiones, quejas, reclamos, sugerencias y denuncias de un cliente: clasificar un radicado, responderlo, aprobarlo o devolverlo, y el carril aparte para casos de Recursos Humanos. Cada tool es una cáscara fina sobre una RPC — la máquina de estados y las validaciones viven en la base (pqrs.*), nunca acá. Corre con tu propia sesión, nunca con una clave de servicio: ctx.db solo expone asUser, así que ninguna tool puede saltear la RLS de pg-dynamo-<env>.

gateway remoto 20 lectura 27 escritura

La bandeja y el detalle (pqrs_list_requests, pqrs_get_request, pqrs_get_request_events, pqrs_list_roles) son SECURITY INVOKER: el gate lo aplica la RLS de la tabla, no un WHERE a mano en la función. Un caller sin acceso ve una lista vacía o null, nunca un error — "no existe" y "no tenés acceso" son indistinguibles, igual que en las transiciones de estado. Antes de pqrs_initialize_project, la app pqrs tiene que estar habilitada en el proyecto y el usuario tener acceso — eso es auth_set_project_app y auth_set_app_access (ver tools de auth), los pasos 1-2 del alta de un cliente.

Cada rol ve un carril distinto, y algunos son mutuamente excluyentes por diseño. Un radicado de Recursos Humanos (pqrs_route_to_hr) deja de ser visible para el asistente y para gerencia — son datos laborales, solo el rol hr los toca. Y quien responde un radicado (pqrs_answer_request) no puede aprobar su propia respuesta: pqrs_approve_request es del asistente de procesos. Ninguna de las 27 de escritura es idempotente en el sentido de "corrila dos veces sin efecto" — la única excepción es pqrs_grant_role, que sí tolera otorgar el mismo (usuario, rol, área) más de una vez sin duplicar ni fallar. La nueva pqrs_create_smoke_request es aparte: crea un radicado marcado is_synthetic, invisible para el semáforo, los indicadores y el rastreo público — pensada para que un smoke automático ejercite el resto de las transiciones sin ensuciar datos de cliente, y exige global-admin, igual que pqrs_initialize_project.

Lectura (20)

Ve solo lo que la RLS (o, en los indicadores, el filtro por project_id) deja pasar — pedir el proyecto o el radicado de otro cliente no es un error, es [] o null.

Tool Qué hace Inputs Qué permiso hace falta Ejemplo de prompt
pqrs_list_catalog Los catálogos activos de un proyecto (tipos de solicitud, causas, áreas, propiedades y perfiles del peticionario) — de ahí salen los ids que piden pqrs_classify_request y pqrs_submit_request. Filtro por kind opcional. project_id (uuid) · kind (enum, opcional) Token scope read. SECURITY INVOKER — cualquier staff del proyecto. "Dame el catálogo de causas del proyecto Acme."
pqrs_list_requests La bandeja: los radicados visibles para el caller en un proyecto, con semáforo y días transcurridos ya calculados (misma definición que los indicadores). Filtros de status/routing opcionales, sobre lo que la RLS ya dejó pasar — un asistente ve lo externo, un responder solo sus áreas, RRHH solo lo suyo. project_id (uuid) · status (enum, opcional) · routing (enum, opcional) Token scope read. SECURITY INVOKER — la RLS decide qué filas llegan. "Mostrame los radicados abiertos del proyecto Acme."
pqrs_get_request El expediente completo de UN radicado: datos del solicitante, descripción, respuesta, semáforo y estado. Si se cerró por traslado a un tercero trae close_kind="third_party_transfer" y los datos del traslado (transfer_third_party, transfer_informed_detail, transfer_informed_at). Mismo gate que la bandeja. Para la bitácora está pqrs_get_request_events, aparte. request_id (uuid) Token scope read. SECURITY INVOKER — sin acceso, lista vacía, nunca un error. "Mostrame el detalle del radicado X."
pqrs_get_request_events La bitácora de un radicado: quién hizo qué y cuándo, en orden cronológico. Hereda EXACTAMENTE el gate de pqrs_get_request — quien no ve el radicado tampoco ve su bitácora. request_id (uuid) Token scope read. SECURITY INVOKER, mismo gate que pqrs_get_request. "Dame la bitácora de eventos del radicado X."
pqrs_list_roles Quién tiene qué rol (y qué área, si aplica) en el equipo interno de PQRS de un proyecto — visible para cualquier staff, no solo el asistente: que un responder sepa a quién escalar es parte del trabajo. project_id (uuid) Token scope read. SECURITY INVOKER — cualquier staff del proyecto. "¿Quién es responder del área de Cartera en el proyecto Acme?"
pqrs_list_project_users Los usuarios del proyecto con la app pqrs habilitada (project_app_users), con su email y nombre — de acá sale a quién ofrecer en pqrs_grant_role en vez de pedir un user_id a mano. Solo usuarios activos (deactivated_at nulo). project_id (uuid) Token scope read. Rol asistente de procesos o global-admin — mismo gate que pqrs_grant_role/ pqrs_list_roles. "¿A quién le puedo asignar un rol de PQRS en el proyecto Acme?"
pqrs_indicadores_resumen Resumen ejecutivo de cumplimiento de un proyecto: total, abiertas, cerradas, incumplidas, porcentaje de cumplimiento y promedio de días de respuesta, opcionalmente en una ventana de fechas. INCUMPLIDA incluye la cerrada fuera de término Y la abierta y vencida — contar solo la cerrada tarde haría que el cumplimiento mejorara cuanto menos se cierra. Los trasladados a un tercero (pqrs_transfer_request) cuentan en el total y en las cerradas pero NO en el cumplimiento (ni incumplidas, ni porcentaje, ni promedio); trasladadas dice cuántos hubo. Sin radicados que cuenten en la ventana, el porcentaje es null, no 100. Los tipos que no miden plazo (sugerencias y felicitaciones, tipos sin investigación) también cuentan en el total y en las cerradas pero no en el cumplimiento; total_con_plazo y total_sin_plazo los separan. project_id (uuid) · desde/hasta (fecha, opcional) Token scope read. Ve solo los proyectos del usuario — el id de otro cliente devuelve ceros, no un error. "¿Cómo va el cumplimiento de PQRS del proyecto Acme este mes?"
pqrs_indicadores_por_catalogo El mismo cumplimiento, cortado por tipo de solicitud, causa, área, propiedad o perfil del peticionario (requester_profile) — una fila por ítem del catálogo, incluidos los que tienen total 0 (omitirlos no deja distinguir "no hubo" de "no se midió"). Misma definición de incumplimiento que el resumen. Mide SOLO el cliente externo: los radicados del carril de RRHH no cuentan acá, y los que no declararon perfil no suman fila. project_id (uuid) · kind (enum) · desde/hasta (fecha, opcional) Token scope read. Ve solo los proyectos del usuario. "Desglosá el cumplimiento por causa del proyecto Acme."
pqrs_indicadores_por_estado Total de radicados por los 8 valores de pqrs.request_status (received/assigned/in_review/ returned/closed/hr_pending/hr_in_progress/hr_closed), opcionalmente en una ventana de fechas. Incluye los estados SIN radicados, con total 0 — completa la familia "total por estado" que pqrs_indicadores_resumen no cubre entera (ese da solo abiertas/cerradas). project_id (uuid) · desde/hasta (fecha, opcional) Token scope read. Ve solo los proyectos del usuario. "¿Cuántos radicados hay en cada estado del proyecto Acme?"
pqrs_indicadores_por_canal Conteo, incumplidas, porcentaje de cumplimiento del término y promedio de días por CANAL DE ORIGEN: canal público (QR o enlace), teléfono, WhatsApp, correo electrónico, visita y "panel (canal no registrado)" para los radicados del panel anteriores al registro del canal. SIEMPRE las 6 filas, con total 0 y porcentaje null si no hubo casos. Mismo criterio de incumplida que pqrs_indicadores_por_catalogo; mide SOLO el cliente externo (routing=external) y un traslado a un tercero suma al total pero no al cumplimiento. project_id (uuid) · desde/hasta (fecha, opcional) Token scope read. Ve solo los proyectos del usuario. "¿Por qué canal llegan más radicados al proyecto Acme y en cuál se cumple menos el término?"
pqrs_indicadores_cruce_causa Matriz de causa contra un segundo eje: property (propiedad/copropiedad) o month (mes de recepción). Con eje property incluye TODAS las propiedades del catálogo, incluso con total 0 en cada causa; con eje month solo entran los meses que tuvieron al menos un radicado. project_id (uuid) · eje (enum: property|month) · desde/hasta (fecha, opcional) Token scope read. Ve solo los proyectos del usuario. "Cruzá causa contra propiedad para el proyecto Acme."
pqrs_indicadores_internos Conteos del carril INTERNO (colaboradores, routing=hr, a cargo de Gestión de la Felicidad), aparte de los del cliente externo: total, abiertas, cerradas, anónimas (sin correo) y total por estado hr_pending, hr_in_progress y hr_closed, opcionalmente en una ventana de fechas de radicación. SIN porcentaje de cumplimiento: el término legal del PQRS externo no aplica a este carril. Los cuatro indicadores de arriba miden SOLO el cliente externo (routing=external). project_id (uuid) · desde/hasta (fecha, opcional) Token scope read. Lo ven hr y global-admin; para cualquier otro rol da ceros (RLS), nunca un error. "¿Cuántos casos internos de RRHH hay abiertos en el proyecto Acme?"
pqrs_indicadores_plazo_interno_por_area Cumplimiento del PLAZO INTERNO del área (el segundo reloj, no el término al peticionario), por área: total, incumplidas y porcentaje, sobre los radicados CON plazo interno recibidos en la ventana de fechas. Cuenta para el área que tiene el caso HOY (un caso redirigido cuenta para el área nueva). INCUMPLIDA incluye la abierta y vencida en plazo interno. Lista el catálogo de áreas COMPLETO: un área sin casos sale con total 0 y porcentaje null, no 100. No cambia ninguna cifra de pqrs_indicadores_resumen. project_id (uuid) · desde/hasta (fecha, opcional) Token scope read. Ve solo los proyectos del usuario — el id de otro cliente devuelve cero filas, no un error. "¿Qué áreas están incumpliendo su plazo interno en el proyecto Acme?"
pqrs_list_alert_recipients Los destinatarios configurados hoy para las alertas internas de un proyecto (quién recibe aviso por rol o área). project_id (uuid) Token scope read. SECURITY INVOKER — cualquier staff del proyecto. "¿Quién recibe las alertas de PQRS del proyecto Acme?"
pqrs_list_intake_channels Los canales de intake configurados en un proyecto (incluido el QR client-side de cada uno). project_id (uuid) Token scope read. SECURITY INVOKER — cualquier staff del proyecto. "Dame los canales de intake activos del proyecto Acme."
pqrs_list_policy_documents Historial de versiones de la Política de Tratamiento de Datos publicadas para el proyecto — quién subió cada una, cuándo, su sha256 y cuál es la vigente hoy. La carga del PDF es binaria y no tiene tool: la hace un humano desde el panel (Configuración → Política de datos). project_id (uuid) Token scope read. SECURITY INVOKER — la RLS de pqrs.policy_documents (is_staff) es el gate, mismo criterio que pqrs_list_alert_recipients. "¿Qué versiones de la política de datos tiene publicadas el proyecto Acme?"
pqrs_list_sla_policies Las políticas de SLA VIGENTES de un proyecto: días de término, si se cuentan en calendario o hábiles, con qué calendario de festivos, umbrales de alerta. Un proyecto puede tener MÁS de una vigente a la vez — la general (sin tipo de solicitud) y una por cada tipo que la sobreescriba — las dos salen, nunca una sola oculta a la otra. Es la lectura que faltaba junto a pqrs_upsert_sla_policy, que solo publica. project_id (uuid) Token scope read. SECURITY INVOKER — la RLS pqrs.is_staff es el gate, solo el staff del proyecto ve esta lista. "¿Qué política de SLA tiene vigente el proyecto Acme?"
pqrs_list_form_fields Los campos del formulario público de un proyecto: field_key, etiqueta, ayuda, si es obligatorio, si es visible y su orden. Es la lectura que hace falta ANTES de pqrs_update_form_field para mostrar el estado actual. project_id (uuid) Token scope read. SECURITY INVOKER — la RLS pqrs.is_staff es el gate, staff del proyecto ve los campos. "¿Qué campos tiene el formulario público del proyecto Acme?"
pqrs_list_channel_form_fields Los campos del formulario de UN canal de intake con su obligatoriedad: la del proyecto, el override del canal (null = hereda), la efectiva que exige el radicado y si el campo es intocable para la audiencia del canal. Es la lectura que hace falta ANTES de pqrs_set_channel_form_field. project_id (uuid) · channel_id (uuid) Token scope read. Rol asistente de procesos, o global-admin. "¿Qué campos del formulario son obligatorios en el canal de la sede Norte del proyecto Acme?"
pqrs_get_requester_profile_config Estado del campo "perfil del peticionario" del formulario público: si se pide (enabled), si es obligatorio (required), qué perfil se envía automáticamente al carril de RRHH (hr_profile_id, null = ninguno), si el carril de RRHH está habilitado, cuántos perfiles activos hay en el catálogo y cuántos correos del rol hr recibirían un caso enrutado (hr_destinatarios: 0 con una regla puesta = nadie se entera). Es la lectura que hace falta ANTES de pqrs_set_requester_profile_config. project_id (uuid) Token scope read. Rol asistente de procesos, o global-admin. "¿Está encendido el perfil del peticionario en el formulario del proyecto Acme y adónde enruta?"

Escritura (27)

Todas actúan sobre un radicado (o el proyecto entero, la primera) ya existente y devuelven el estado resultante. Confirmá el ambiente con dynamo_session_status (ver tools de ops) antes de cualquiera de estas.

Tool Qué hace Inputs Qué permiso hace falta Ejemplo de prompt
pqrs_initialize_project Pone en marcha PQRS en un proyecto ya habilitado: materializa los 5 tipos de solicitud, los campos del formulario público, las plantillas de correo, un SLA por defecto de 15 días calendario y los destinatarios de alertas por rol. Paso 3 del alta de un cliente (1-2 son de auth). Idempotente y NO destructiva: si el proyecto ya estaba inicializado devuelve initialized:false y no toca nada — no sirve para resetear la configuración que el cliente editó después. project_id (uuid) Token scope write. Gate real: global-admin ONLY. "Inicializá PQRS en el proyecto Acme."
pqrs_classify_request Clasifica un radicado nuevo: le asigna causa y área responsable, y lo pasa de received a assigned — recién ahí es visible para el área. La causa y el área tienen que ser del mismo proyecto del radicado; de otro cliente se rechaza aunque seas asistente legítimo. Solo desde received: un radicado ya clasificado no se re-clasifica. request_id (uuid) · cause_id (uuid) · area_id (uuid) Token scope write. Rol asistente de procesos del proyecto. "Clasificá el radicado X con causa 'Facturación' y área 'Cartera'."
pqrs_close_by_notification Cierra NOTIFICANDO un radicado de un tipo que NO requiere investigación (sugerencia y felicitación por defecto; configurable por proyecto con requires_investigation en pqrs_upsert_catalog_item): lo pasa de received o assigned a closed SIN respuesta formal ni aprobación, y avisa al solicitante y a los responders del área. Si el radicado todavía no está clasificado (received), area_id es obligatorio y cause_id opcional; en assigned se usa el área ya asignada y ambos se ignoran. Un radicado de un tipo con plazo (petición, queja, reclamo) se RECHAZA sin tocar nada: se cierra por el flujo de respuesta y aprobación. Estos radicados quedan fuera del indicador de cumplimiento pero cuentan en el total. No se reabre. request_id (uuid) · area_id (uuid, opcional) · cause_id (uuid, opcional) Token scope write. Rol asistente de procesos del proyecto. "Cerrá notificando la sugerencia X y asignala al área de Cartera."
pqrs_route_to_hr Marca un radicado como presentado por un colaborador de la organización y lo saca del flujo de cliente externo hacia el carril de Recursos Humanos (hr_pending). Solo desde received. A partir de ahí deja de ser visible para el asistente y para gerencia. Exige que el carril esté habilitado en el proyecto (settings.hr_lane_enabled). request_id (uuid) Token scope write. Rol asistente de procesos del proyecto. "Este radicado lo presentó un empleado, mandalo al carril de RRHH."
pqrs_transfer_request Cierra un radicado que NO es del alcance de la organización trasladándolo a un tercero (otra entidad o empresa), y deja registro de a quién se trasladó y de qué se le informó al peticionario. Solo radicados externos en received, assigned o returned (uno en in_review se devuelve primero). Queda closed con close_kind="third_party_transfer": entra al total y a las cerradas pero NO al cumplimiento del plazo, y suma en trasladadas de pqrs_indicadores_resumen. El peticionario recibe el aviso por correo y lo ve en su link de seguimiento. No se reabre. request_id (uuid) · third_party (texto, no vacío) · informed_detail (texto, no vacío) Token scope write. Rol asistente de procesos del proyecto — no el responder del área. "El radicado X no es de nuestra competencia: trasladalo a la Superintendencia e informale al peticionario a dónde fue."
pqrs_answer_request Registra la respuesta de un área a un radicado. Por defecto NO cierra: queda en in_review esperando la aprobación del asistente (ciclo de dos pasos) — si el proyecto tiene settings.requires_approval:false, cierra directo. Válida desde assigned o returned. La respuesta no puede estar vacía. request_id (uuid) · answer (texto, no vacío) Token scope write. Rol responder DEL ÁREA de ese radicado — no alcanza con ser responder del proyecto. "Respondé el radicado X: 'Se realizó el ajuste solicitado en la próxima facturación.'"
pqrs_approve_request Aprueba la respuesta de un área y cierra el radicado. Quien respondió no puede aprobar su propia respuesta. Solo desde in_review. Al cerrar calcula los días de respuesta con la política de SLA congelada en el radicado (no la vigente hoy) y, si se pasó del término, registra el incumplimiento — cerrar no lo borra. request_id (uuid) Token scope write. Rol asistente de procesos del proyecto. "Aprobá la respuesta del radicado X."
pqrs_return_request Devuelve una respuesta al área responsable para que la corrija, con el motivo. Solo desde in_review. El motivo es obligatorio y no puede ser espacios en blanco. El radicado vuelve a returned; el semáforo NO se reinicia — los días siguen corriendo desde la recepción original. request_id (uuid) · reason (texto, no vacío) Token scope write. Rol asistente de procesos del proyecto. "Devolvé la respuesta del radicado X, falta adjuntar el soporte."
pqrs_reassign_request Reasigna un radicado ya clasificado a OTRA área del mismo proyecto, con el motivo. Solo desde assigned o returned. El motivo es obligatorio y queda en la bitácora junto con el área anterior y la nueva. El área destino tiene que ser un área activa del proyecto y distinta de la actual. El estado NO cambia y el plazo NO se reinicia — los días siguen corriendo desde la recepción original. Se avisa a los responders del área nueva y a los asistentes; el responder saliente deja de ver el radicado. request_id (uuid) · area_id (uuid) · reason (texto, no vacío) Token scope write. Rol responder del área que hoy tiene el radicado, o asistente de procesos. Gerencia no: es de solo lectura. "Pasá el radicado X al área de Cartera, lo clasificamos mal en Facturación."
pqrs_update_hr_case Actualiza el estado de un radicado del carril de Recursos Humanos. Estados válidos: hr_pending, hr_in_progress, hr_closed. No aplica a radicados de cliente externo. request_id (uuid) · status (enum: hr_pending | hr_in_progress | hr_closed) Token scope write. Rol hr — ni el asistente ni gerencia ven estos radicados. "Pasá el caso de RRHH X a 'en progreso'."
pqrs_submit_request Radica una PQRS EN NOMBRE de un tercero desde el panel: llegó por teléfono, WhatsApp, correo electrónico o en una visita y el equipo la carga — distinto del canal anónimo del ciudadano, sin captcha/throttle/dedupe porque el caller YA está autenticado. Mismo consecutivo y mismo término que el canal público. Exige el canal de origen (origin_channel), la declaración de que el solicitante autorizó el tratamiento de sus datos (submitter_authorized), una política de datos publicada en el proyecto, el tipo de solicitud, los campos obligatorios configurados del formulario y una política de SLA vigente. Registra el canal, quién radicó y la versión de la política. Devuelve el consecutivo y el tracking_token del radicado nuevo. project_id (uuid) · submitter_name · submitter_email · submitter_phone (opcional) · description · request_type_id (uuid) · origin_channel (enum: phone|whatsapp|email|visit) · submitter_authorized (siempre true) · property_id (uuid, opcional) · property_text (texto, hasta 200, opcional) · extra_fields (objeto de texto, opcional) Token scope write. Rol asistente de procesos o comercial (solo radica) del proyecto. "Radicá una PQRS a nombre de Juan Pérez (juan@correo.com): 'no me llegó la factura de agosto'."
pqrs_grant_role Da de alta a un usuario en el equipo interno de PQRS de un proyecto (asistente, responder de un área, gerencia, RRHH o comercial: solo radica, sin área). Un responder EXIGE área; los demás roles la rechazan — el área tiene que ser del MISMO proyecto. IDEMPOTENTE: otorgar el mismo (usuario, rol, área) dos veces no duplica ni falla. Esto da acceso al DOMINIO pqrs — la app en sí (project_app_users) la habilita auth_set_app_access, aparte. project_id (uuid) · user_id (uuid) · role (enum: assistant|responder|management|hr|commercial) · area_id (uuid, opcional) Token scope write. Rol asistente de procesos del proyecto, o global-admin. "Agregá a María como responder del área de Cartera en el proyecto Acme."
pqrs_create_smoke_request Crea un radicado SINTÉTICO en un proyecto, para que el smoke automático pueda ejercitar las transiciones sin ensuciar los datos del cliente. La marca is_synthetic es INMUTABLE: excluye el radicado del semáforo, los indicadores, las alertas de SLA y el rastreo público desde el instante en que se crea, y nunca dispara correo. Se descarta a las 24 horas. Devuelve el id del radicado, que es la única forma de consultarlo — por token no es visible. project_id (uuid) Token scope write. Gate real: global-admin ONLY — mismo criterio que pqrs_initialize_project. "Creá un radicado sintético en el proyecto de pruebas para el smoke."
pqrs_revoke_role Retira a un usuario del equipo interno de PQRS de un proyecto (incluido comercial) — cierra el trío junto a grant_role/list_roles. project_id (uuid) · user_id (uuid) Token scope write. Rol asistente de procesos del proyecto, o global-admin. "Sacá a Juan del equipo de PQRS del proyecto Acme."
pqrs_upsert_catalog_item Crea o edita un ítem del catálogo (tipo de solicitud, causa, área, propiedad o perfil del peticionario) de un proyecto — desde el panel, sin SQL manual. Idempotente por (proyecto, kind, code). requires_investigation (solo request_type): false = el tipo se cierra notificando (pqrs_close_by_notification) y queda fuera del indicador de cumplimiento; omitido conserva el valor vigente (un tipo nuevo nace en true). No afecta radicados ya creados. project_id (uuid) · kind (enum: request_type|cause|area|property|requester_profile) · code · label · sort_order (int, opcional) · is_active (booleano, opcional) · requires_investigation (booleano, opcional) Token scope write. Rol asistente de procesos del proyecto, o global-admin. "Agregá la causa 'Facturación duplicada' al catálogo del proyecto Acme."
pqrs_deactivate_catalog_item Da de baja (lógica, no borra) un ítem del catálogo de un proyecto. project_id (uuid) · item_id (uuid) Token scope write. Rol asistente de procesos del proyecto, o global-admin. "Desactivá la causa 'Otros' del catálogo del proyecto Acme."
pqrs_upsert_sla_policy Define la política de SLA de un proyecto: términos al peticionario en días calendario o hábiles, con umbrales de alerta. Publica una versión NUEVA: los radicados ya abiertos conservan su fecha de vencimiento. Opcionalmente un plazo INTERNO del área (segundo reloj) con internal_term_days y sus internal_*: van todos o ninguno, y OMITIRLOS publica una versión SIN plazo interno (es versión nueva, no merge) — para cambiar solo el término al peticionario, leé la vigente con pqrs_list_sla_policies y reenviá sus internos. El plazo interno no cuenta para el cumplimiento al peticionario. project_id (uuid) · name · term_days (int) · day_basis (enum: calendar|business) · alert_offsets (array de int) · offset_basis (enum: elapsed|before_due) · request_type_id (uuid, opcional) · holiday_calendar (opcional) · internal_term_days, internal_day_basis, internal_alert_offsets, internal_offset_basis, internal_start (enum: assigned|received) (opcionales) Token scope write. Rol asistente de procesos del proyecto, o global-admin. "Cambiá el SLA de PQRS del proyecto Acme a 20 días."
pqrs_set_alert_recipients Reemplaza la lista COMPLETA de destinatarios de alerta interna de un proyecto — no agrega, pisa. clock elige DE QUÉ RELOJ es la lista: requester (default, término al peticionario) o internal (plazo interno del área); reemplaza solo la lista de ese reloj y la del otro queda intacta. project_id (uuid) · recipients (array) · clock (enum: requester|internal, opcional) Token scope write. Rol asistente de procesos del proyecto, o global-admin. "Poné a estas 3 personas como destinatarias de alerta en el proyecto Acme."
pqrs_upsert_email_template Crea o edita una plantilla de correo del proyecto (las que salen a clientes/staff en cada transición), incluidos los dos avisos del cierre sin investigación (submitter_notice al ciudadano, internal_notice al área) y la alerta del plazo interno (internal_term_alert). project_id (uuid) · template_key (enum) · asunto/cuerpo (texto) Token scope write. Rol asistente de procesos del proyecto, o global-admin. "Editá el correo de cierre de radicado del proyecto Acme."
pqrs_update_settings Actualiza los settings generales de PQRS de un proyecto. project_id (uuid) · settings propios Token scope write. Rol asistente de procesos del proyecto, o global-admin. "Actualizá la configuración general de PQRS del proyecto Acme."
pqrs_create_intake_channel Crea un canal de intake nuevo para un proyecto, con su QR client-side — no idempotente, cada llamada crea un canal distinto. audience es external (por defecto: cliente externo, nombre y correo siempre obligatorios) o internal (colaboradores: nombre, correo y celular opcionales; lo radicado entra directo al carril de RRHH y no cuenta en los indicadores del cliente externo). Un canal internal exige hr_lane_enabled en el proyecto y no puede existir sin captcha, ni siquiera para un global-admin. La audiencia no se cambia después: se revoca el canal y se crea otro. project_id (uuid) · label (texto) · property_id (uuid, opcional) · requires_captcha (booleano, opcional) · audience (enum: external|internal, opcional) Token scope write. Rol asistente de procesos del proyecto, o global-admin. "Creá un canal de intake nuevo para recepción presencial en el proyecto Acme."
pqrs_revoke_intake_channel Revoca un canal de intake de un proyecto. project_id (uuid) · channel_id (uuid) Token scope write. Rol asistente de procesos del proyecto, o global-admin. "Revocá el canal de intake viejo del proyecto Acme."
pqrs_update_form_field Edita la etiqueta, el texto de ayuda y la obligatoriedad de un campo del formulario público. NUNCA cambia field_key, sort_order ni is_visible — solo texto y obligatoriedad. Los 4 campos que sostienen el resto del dominio (description, accepts_policy, submitter_email, request_type) no se pueden volver opcionales: el servidor rechaza el intento aunque seas global-admin. help es de TRES ESTADOS: omitido no toca la ayuda actual, "" la borra, texto la reemplaza. Sin required, la obligatoriedad actual no se toca. project_id (uuid) · code (texto) · label (1-120 caracteres) · help (opcional, hasta 300 caracteres) · required (booleano, opcional) Token scope write. Rol asistente de procesos del proyecto, o global-admin. "Marcá como obligatorio el campo de teléfono del formulario público del proyecto Acme."
pqrs_set_channel_form_field Fija la obligatoriedad de un campo del formulario en UN canal de intake, por encima de la del proyecto (pqrs_update_form_field). required true/false fija el override del canal; null lo borra y el canal vuelve a heredar lo del proyecto. Etiqueta, ayuda y visibilidad siguen siendo del proyecto. En un canal external nombre y correo nunca se vuelven opcionales; en uno internal, description, request_type y accepts_policy tampoco: el servidor rechaza el intento aunque seas global-admin. El canal tiene que ser del mismo proyecto y no estar revocado. Devuelve la fila efectiva del campo. project_id (uuid) · channel_id (uuid) · field_key (texto) · required (booleano o null) Token scope write. Rol asistente de procesos del proyecto, o global-admin. "En el canal interno del proyecto Acme, hacé opcional el campo de celular."
pqrs_set_requester_profile_config Enciende o apaga el campo "perfil del peticionario" del formulario público y fija qué perfil va SOLO al carril de RRHH (Gestión de la Felicidad). ESTADO COMPLETO, no parcial: cada llamada fija el campo Y la regla, así que omitir hr_profile_id BORRA la regla. Para enrutar a los colaboradores, hr_profile_id es el id del ítem "colaborador" del catálogo requester_profile (pqrs_list_catalog). Encender exige al menos un perfil activo (se cargan con pqrs_upsert_catalog_item, kind requester_profile); la regla exige el carril de RRHH habilitado; apagar exige hr_profile_id vacío. El campo nace obligatorio; pqrs_update_form_field puede volverlo opcional. Queda auditado. Leé el estado antes con pqrs_get_requester_profile_config. project_id (uuid) · enabled (booleano) · hr_profile_id (uuid o null, opcional) Token scope write. Rol asistente de procesos del proyecto, o global-admin. "Encendé el perfil del peticionario en el proyecto Acme y mandá los colaboradores a RRHH."
pqrs_return_hr_to_external Devuelve al canal externo un radicado del carril de RRHH que no es un caso laboral (típicamente un peticionario que se declaró "colaborador" por error y el sistema lo enrutó solo). Solo desde hr_pending o hr_in_progress. El motivo es obligatorio (hasta 1000 caracteres) y queda en la bitácora con quién lo devolvió. El radicado vuelve a received para que el asistente lo clasifique, y el asistente recibe el aviso. El plazo NO se reinicia: los días siguen corriendo desde la recepción original. Después de devolverlo, quien solo tiene el rol hr deja de ver el caso. request_id (uuid) · reason (texto, no vacío) Token scope write. Rol hr — ni el asistente ni gerencia pueden hacerlo. "Este caso de RRHH no es laboral, devolvelo al canal externo: lo radicaron por error como colaborador."

Para errores concretos de estas tools: Troubleshooting. Para correr los MCPs en stdio localmente en vez del gateway: Para desarrolladores.