Herramientas · Presencia
Herramientas MCP del módulo Presencia (coworking): el aforo, Llegué y Me fui, quién está aquí, visitantes, historial, corrección y eliminación de visitas y los enlaces de quiosco de la recepción.
El módulo Presencia con el asistente: ver el aforo, marcar la llegada y la salida (tuya, de un miembro o de un visitante), listar quién está en el espacio y el historial, corregir o eliminar visitas y generar y revocar los enlaces de quiosco. El quiosco en sí es una pantalla del visitante en el iPad de la recepción; el asistente gestiona los enlaces, no maneja el quiosco.
Cada herramienta lleva un sello: Solo consulta no cambia nada, Modifica crea o cambia algo al momento, y Pide confirmación solo actúa después de tu sí a un resumen. Consulta Dinero y confirmación.
En resumen
| Herramienta | Qué hace | Rol mínimo | Tipo |
|---|---|---|---|
get_attendance_overview | El aforo y tu visita abierta | Cualquiera que vea el espacio | Solo consulta |
check_in | Registra la llegada, la tuya o la de un miembro | Cualquiera (la tuya); moderador o financiero (de otro) | Modifica |
check_out | Registra la salida | Cualquiera (la tuya); moderador o financiero (de otro) | Modifica |
list_present | Quién está en el espacio ahora | Moderador o financiero | Solo consulta |
list_visits | El historial de visitas, con filtros | Moderador o financiero (hoy); administrador (cualquier día) | Solo consulta |
list_my_visits | Tus visitas y el resumen del mes | Cualquiera | Solo consulta |
update_visit | Corrige la llegada o la salida de una visita | Moderador o financiero (hoy); administrador (cualquier día) | Modifica |
delete_visit | Elimina una visita | Administrador | Pide confirmación |
check_guest_in | Registra la llegada de un visitante | Moderador o financiero | Modifica |
list_attendance_kiosks | Los dispositivos de quiosco del espacio | Moderador o financiero | Solo consulta |
create_attendance_kiosk | Genera el enlace de un quiosco (aparece una vez) | Moderador | Modifica |
revoke_attendance_kiosk | Revoca el enlace de un quiosco | Moderador | Pide confirmación |
El espacio se crea con create_space y module: "attendance", con el argumento attendance para la configuración; update_space cambia solo lo que envíes y mantiene el resto.
El equipo, aquí, es el propietario, el administrador, el moderador y el financiero; el financiero lee y marca, pero no genera ni revoca enlaces de quiosco. Los roles son los de las rutas: el asistente nunca hace más de lo que la persona conectada haría en la pantalla.
La configuración del espacio
El argumento attendance de create_space y update_space acepta:
| Campo | Tipo | Descripción |
|---|---|---|
self_check_in | off, button o code | Quién marca la llegada: off, solo el equipo; button, el miembro, con el botón Llegué (code aún no está disponible) |
capacity | número de 1 a 100000, o null | El aforo, informativo. null quita el límite |
auto_checkout_time | HH:MM | La salida automática, en la zona horaria de la comunidad (por defecto 23:59) |
show_who_is_here | staff | Quién ve los nombres: solo el equipo |
kiosk.guest_fields | {company, phone}, cada uno off, optional o required | Lo que la pantalla del quiosco pide además del nombre |
kiosk.notify_host | verdadero o falso | Avisa al anfitrión por correo cuando llega el visitante (por defecto: sí) |
kiosk.reset_seconds | 5 a 60 | En cuántos segundos la pantalla del quiosco vuelve al inicio (por defecto: 10) |
get_attendance_overview
Solo consulta
Aforo del espacio. Solo el número de personas y el aforo (nunca nombres), la visita abierta de quien pregunta y el modo de check-in (off, button o code). Rol mínimo: cualquiera que vea el espacio.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
space | id o enlace | Sí | El espacio de Presencia |
Pídelo así: "¿Cuántas personas hay ahora en la Unidad Centro?"
check_in
Modifica
Registrar la llegada. Sin profile_id, es tu llegada, y solo si el espacio deja marcar al miembro (el equipo siempre puede marcarse). Con profile_id, el equipo registra la llegada de otro miembro; al miembro común se le rechaza. A quien no tiene acceso al espacio (plan vencido, fuera del grupo) se le rechaza, incluso por el equipo. Es idempotente: con una visita ya abierta, devuelve esa visita (already_checked_in: true). Un visitante sin cuenta es check_guest_in. Rol: cualquiera (la tuya); moderador o financiero (de otro).
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
space | id o enlace | Sí | |
profile_id | id | No | Solo el equipo: el miembro a marcar (list_members). Sin él, eres tú |
Devuelve: visit y already_checked_in.
Pídelo así: "Registra mi llegada a la Unidad Centro." · "Marca la llegada de María al coworking."
check_out
Modifica
Registrar la salida. Sin parámetros además del espacio, cierra tu visita abierta. El equipo cierra la de un miembro (profile_id) o cualquier visita abierta (visit_id, de list_present). Sin visita abierta, la respuesta es 409. Rol: cualquiera (la tuya); moderador o financiero (de otro).
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
space | id o enlace | Sí | |
profile_id | id | No | Solo el equipo: el miembro cuya visita cerrar |
visit_id | id | No | La visita abierta a cerrar (el equipo; el miembro, solo la suya) |
Pídelo así: "Me voy."
list_present
Solo consulta
Quién está aquí. Las visitas abiertas, de miembros y de visitantes, de la más reciente a la más antigua, con el nombre y la hora de llegada, más el recuento y el aforo. El miembro ve solo el número, en get_attendance_overview. Rol mínimo: moderador (o financiero).
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
space | id o enlace | Sí | |
page, limit | números | No | Paginación (hasta 100 por página) |
Pídelo así: "¿Quién está ahora en la casa?"
list_visits
Solo consulta
El historial. Las visitas del espacio, de la más reciente a la más antigua: quién, llegada, salida, el tipo (miembro o visitante) y si está abierta o se cerró automáticamente. El administrador y el propietario leen cualquier período; el moderador y el financiero ven solo hoy (la API reduce el intervalo). Rol mínimo: moderador (o financiero).
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
space | id o enlace | Sí | |
profile_id | id | No | Solo este miembro |
kind | member o guest | No | Miembros o visitantes |
open | verdadero o falso | No | true: solo quien sigue aquí |
from, to | fecha | No | AAAA-MM-DD o ISO 8601, leídos en la zona horaria de la comunidad |
page, limit | números | No | Paginación |
Pídelo así: "¿Cuántos visitantes vinieron la semana pasada?"
list_my_visits
Solo consulta
Tus visitas. Tu historial, de la más reciente a la más antigua, con el resumen del mes (visitas, días y minutos) en la zona horaria de la comunidad. Rol mínimo: cualquiera.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
space | id o enlace | No | Solo este espacio de Presencia |
page, limit | números | No | Paginación |
Pídelo así: "¿Cuántos días he ido al coworking este mes?"
update_visit
Modifica
Corregir una visita. Cambia la llegada (check_in_at) y/o la salida (check_out_at). La salida no puede ser anterior a la llegada ni estar en el futuro; enviar la salida en una visita abierta la cierra. El administrador y el propietario corrigen cualquier día; el moderador y el financiero, solo la visita de hoy y con las fechas dentro de hoy (ayer devuelve 403). La corrección entra en el registro de actividad con quién la hizo. Rol mínimo: moderador (o financiero).
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
visit_id | id | Sí | De list_visits o list_present |
check_in_at | fecha y hora | No | ISO 8601 |
check_out_at | fecha y hora | No | ISO 8601 |
Pídelo así: "Pedro olvidó marcar la salida: se fue a las 18:00. Cierra su visita."
delete_visit
Pide confirmación
Eliminar una visita. La visita sale de las listas y de los números (una abierta deja de contar en el aforo) y la eliminación entra en el registro de actividad. No elimina al miembro. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
visit_id | id | Sí | De list_visits |
Devuelve: en la primera llamada, el resumen y el código de confirmación.
check_guest_in
Modifica
Registrar un visitante. El equipo registra la llegada de quien no tiene cuenta, con el miembro que lo recibe (el anfitrión, que tiene que tener acceso al espacio). La empresa y el teléfono se piden o se rechazan según la configuración del quiosco. Es idempotente por nombre y anfitrión: con la visita abierta, devuelve already_checked_in: true. Si el espacio avisa a los anfitriones, este recibe un correo. El visitante cuenta en el aforo. Rol mínimo: moderador (o financiero).
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
space | id o enlace | Sí | |
guest_name | texto | Sí | El nombre del visitante (hasta 100 caracteres) |
host_profile_id | id | Sí | El miembro que lo recibe (list_members) |
guest_company | texto | No | La empresa |
guest_phone | texto | No | El teléfono |
Pídelo así: "Registra al visitante Pedro Alves, de Acme, que viene a ver a Ana."
list_attendance_kiosks
Solo consulta
Los quioscos. Los dispositivos del espacio, activos y revocados: nombre, quién lo creó, cuándo, el último uso y el estado. Nunca el enlace, que solo aparece al crearlo. Rol mínimo: moderador (o financiero).
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
space | id o enlace | Sí |
create_attendance_kiosk
Modifica
Generar el enlace de un quiosco. Uno por iPad o lugar. Devuelve kiosk, la url y un warning: la URL aparece una sola vez y es secreta, como una contraseña. Quien la tiene registra visitantes. El asistente pide a la persona que la abra en el dispositivo y no la comparta; si se pierde, hay que revocar y generar otra. Rol mínimo: moderador (propietario, administrador o moderador; el financiero no).
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
space | id o enlace | Sí | |
name | texto | Sí | El nombre del dispositivo, hasta 80 caracteres (por ejemplo, "Tablet de la recepción") |
Pídelo así: "Genera el enlace del quiosco del iPad de la recepción de la Unidad Centro."
revoke_attendance_kiosk
Pide confirmación
Revocar un quiosco. El enlace deja de funcionar al instante y no vuelve (genera otro). Las visitas ya registradas se mantienen. Rol mínimo: moderador (propietario, administrador o moderador).
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
space | id o enlace | Sí | |
kiosk_id | id | Sí | De list_attendance_kiosks |
Devuelve: en la primera llamada, el resumen (el nombre y el último uso del dispositivo) y el código de confirmación.