Werkzeuge · BesucherDemnächst
MCP-Tools für das Modul Besucher (Coworking): Gäste anmelden, auflisten, lesen, bearbeiten und stornieren, die heute Erwarteten, den Gastgeber suchen und die Ankunft am Empfang markieren oder rückgängig machen.
Das Modul Besucher über den Assistenten: den Gast vorab anmelden, bearbeiten und stornieren, sehen, wer heute am Empfang erwartet wird, und die Ankunft mit Benachrichtigung des Gastgebers markieren. Der Besucher-Kiosk ist ein Bildschirm auf dem iPad; der Assistent bedient ihn nicht.
Demnächst Kommt in die Communities: Diese 9 Tools gibt es auf dem Server, sobald das Update live geht. Bis dahin bietet der Assistent sie nicht an.
Jedes Tool hat ein Siegel: Nur lesen ändert nichts, Ändert legt sofort etwas an oder ändert es, und Mit Bestätigung handelt erst nach deinem Ja zu einer Zusammenfassung. Siehe Geld und Bestätigung.
Kurz gesagt
| Tool | Was es tut | Mindestrolle | Typ |
|---|---|---|---|
create_visitor_invitation | Meldet einen Gast an | Jede Rolle mit Zugriff auf den Bereich (die Konfiguration kann es einschränken); das Team, im Namen eines anderen Gastgebers | Ändert |
list_visitor_invitations | Listet und sucht Gäste | Jede (das Mitglied sieht die eigenen) | Nur lesen |
get_visitor_invitation | Eine Anmeldung | Inhaber der Anmeldung oder Team | Nur lesen |
update_visitor_invitation | Bearbeitet vor der Ankunft | Inhaber der Anmeldung oder Team | Ändert |
cancel_visitor_invitation | Storniert eine Anmeldung | Inhaber der Anmeldung oder Team | Mit Bestätigung |
list_visitors_today | Die Erwarteten und die Angekommenen von heute | Moderator oder Finanzen | Nur lesen |
search_visitor_hosts | Findet den Gastgeber | Moderator oder Finanzen | Nur lesen |
mark_visitor_arrived | Markiert die Ankunft | Moderator oder Finanzen | Ändert |
undo_visitor_arrival | Macht eine Ankunft rückgängig | Moderator oder Finanzen | Ändert |
Die Rollen sind die der Routen: Der Assistent tut nie mehr, als die angemeldete Person in der Oberfläche tun würde. Das Team ist hier Eigentümer, Administrator, Moderator und Finanzen; Moderator und Finanzen bearbeiten nur die Gäste von heute. Den Bereich legst du mit create_space und module: "visitors" an; update_space ändert nur, was du mitschickst.
Die Konfiguration des Bereichs
Das Argument visitors von create_space und update_space akzeptiert:
| Feld | Typ | Beschreibung |
|---|---|---|
attendance_space_id | ID | Der Anwesenheit-Bereich, in dem die Ankünfte erfasst werden. Beim Anlegen Pflicht (list_spaces) |
who_can_invite | members, staff oder group | Wer anmeldet: jedes Mitglied mit Zugriff, nur das Team oder die Gruppe aus inviter_group_id plus das Team |
inviter_group_id | ID oder null | Die Gruppe derer, die anmelden (list_groups); mit group Pflicht |
fields | {company, email, phone}, je off, optional oder required | Was das Formular vom Gast abfragt |
notify_host_on_register | wahr oder falsch | Bestätigt die Anmeldung per E-Mail an den Gastgeber (Voreinstellung: ja) |
email_guest | off, optional oder always | Die E-Mail an den Gast (Voreinstellung: off) |
arrival_instructions | Text bis 500 Zeichen, oder null | Wohin und nach wem fragen |
max_expected_per_host_per_day | 1 bis 1000, oder null | Limit an Gästen pro Gastgeber und Tag |
create_visitor_invitation
Ändert
Einen Gast anmelden. Legt kein Konto für den Gast an. Wen die Konfiguration lässt, meldet für sich an; das Team übergibt host_profile_id, um im Namen eines anderen anzumelden. Firma, E-Mail und Telefon folgen der Konfiguration (ein ausgeschaltetes Feld wird ignoriert; ein fehlendes Pflichtfeld wird abgelehnt). Der Gastgeber kann eine Bestätigungs-E-Mail erhalten und der Gast eine weitere, je nach notify_guest und Konfiguration; der Assistent sagt es der Person. Das sind personenbezogene Daten einer dritten Person. Rolle: jede mit Zugriff auf den Bereich.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
space | ID oder Link | Ja | Der Besucher-Bereich |
guest_name | Text | Ja | Bis 100 Zeichen |
expected_date | JJJJ-MM-TT | Ja | In der Zeitzone der Community; darf nicht in der Vergangenheit liegen |
start_time | HH:mm | Ja | Startzeit, in der Zeitzone der Community |
end_time | HH:mm | Nein | Nach dem Beginn |
guest_company, guest_email, guest_phone | Text | Je nach Konfiguration | |
notify_guest | wahr oder falsch | Nein | Benachrichtigt den Gast per E-Mail; gilt nur mit E-Mail und gemäß email_guest |
host_profile_id | ID | Nein | Nur das Team: der Gastgeber (search_visitor_hosts). Ohne ihn bist du es |
Frag so: „Melde Maria Souza ([email protected]) als meine Besucherin morgen von 14 bis 15 Uhr an.“
list_visitor_invitations
Nur lesen
Die Gäste auflisten. Nach erwarteter Uhrzeit. Das Mitglied sieht nur die eigenen (als Gastgeber oder als Anmeldender), von jedem Datum; Moderator und Finanzen sehen zusätzlich alle von heute; Administrator und Eigentümer sehen jedes Datum. Jeder Eintrag sagt, was du tun darfst (canEdit, canCancel, canArrive, canUndoArrival). Rolle: jede mit Zugriff auf den Bereich.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
space | ID oder Link | Ja | |
status | EXPECTED, ARRIVED, CANCELED oder NO_SHOW | Nein | EXPECTED gilt ab heute; NO_SHOW ist ein Erwarteter eines vergangenen Tages |
from, to | JJJJ-MM-TT | Nein | Zeitraum, einschließlich, in der Zeitzone der Community |
q | Text | Nein | Teil des Namens oder der Firma |
page, limit | Zahlen | Nein | Paginierung (bis 100) |
Frag so: „Welche Gäste habe ich für diese Woche angemeldet?“
get_visitor_invitation
Nur lesen
Eine Anmeldung. Der Gastgeber und wer angemeldet hat, lesen die eigene; das Team liest die von heute; Eigentümer und Administrator jede. Eine andere Anmeldung, eine andere Community oder eine unbekannte ID: 404. Rolle: jede.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
invitation_id | ID | Ja | Aus list_visitor_invitations oder list_visitors_today |
update_visitor_invitation
Ändert
Vor der Ankunft bearbeiten. Nach der Ankunft oder nach dem Stornieren lautet die Antwort 409. Schicke nur, was sich ändert; host_profile_id ist dem Team vorbehalten. Eine Änderung von Tag, Uhrzeit oder Gastgeber sendet eine neue Bestätigung an den Gastgeber, einmal pro Änderung. Der Inhaber der Anmeldung und das Team bearbeiten (Moderator und Finanzen nur die von heute). Rolle: jede, je nachdem, wer bearbeiten darf.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
invitation_id | ID | Ja | |
guest_name, guest_company, guest_email, guest_phone | Text | Nein | |
expected_date, start_time, end_time | Datum und Uhrzeiten | Nein | Dieselben Formate wie create_visitor_invitation |
notify_guest | wahr oder falsch | Nein | |
host_profile_id | ID | Nein | Nur das Team |
Frag so: „Ändere den Besuch von Maria auf 15 Uhr.“
cancel_visitor_invitation
Mit Bestätigung
Eine Anmeldung stornieren. Wird Storniert; nichts wird gelöscht. Wer angemeldet hat, der Gastgeber oder das Team (Moderator und Finanzen nur die von heute). Bereits storniert: Nichts ändert sich. Schon angekommen: 409, mach vorher die Ankunft rückgängig. Rolle: jede, je nachdem, wer stornieren darf.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
invitation_id | ID | Ja |
Liefert: beim ersten Aufruf die Zusammenfassung (Gast, Gastgeber, Tag und Uhrzeit) und den Bestätigungscode.
list_visitors_today
Nur lesen
Die Sicht des Empfangs. Die Erwarteten und die schon Angekommenen von heute (Zeitzone der Community), aller Gastgeber, mit den Zählungen. Stornierte und „nicht erschienen“ erscheinen nicht. alreadyMember zeigt an, dass die E-Mail des Gastes die eines Mitglieds ist. Mindestrolle: Moderator (oder Finanzen).
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
space | ID oder Link | Ja | |
q | Text | Nein | Name oder Firma, ohne Rücksicht auf Akzente und Groß-/Kleinschreibung |
Frag so: „Wen erwarte ich heute am Empfang?“
search_visitor_hosts
Nur lesen
Den Gastgeber finden. Mitglieder des Bereichs, deren Name (oder ein Wort davon) mit q beginnt, ab 3 Buchstaben. Liefert nur ID, Name, Foto und Initialen; die ID ist die host_profile_id von create_visitor_invitation. Mindestrolle: Moderator (oder Finanzen).
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
space | ID oder Link | Ja | |
q | Text | Ja | 3 bis 100 Zeichen |
mark_visitor_arrived
Ändert
Die Ankunft markieren. Legt den Besuch in der verknüpften Anwesenheit an (Methode Empfang, mit dem Namen der Anmeldung) oder verknüpft den, den das Team schon erfasst hatte. Der Gastgeber wird per E-Mail benachrichtigt, wenn die Anwesenheit darauf eingestellt ist; hostNotified sagt, ob die Benachrichtigung in die Warteschlange ging, und der Assistent sagt es der Person. Idempotent: Der zweite Aufruf liefert alreadyArrived: true. Nur am Tag der Anmeldung (anderer Tag: 409); außerhalb des Zeitfensters ist es erlaubt; storniert: 409. Mindestrolle: Moderator (oder Finanzen).
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
invitation_id | ID | Ja | Aus list_visitors_today |
Liefert: invitation, visit, hostNotified und alreadyArrived.
Frag so: „Maria Souza ist angekommen.“
undo_visitor_arrival
Ändert
Eine versehentlich markierte Ankunft rückgängig machen. Am selben Tag und vor dem Abgang des Gastes. Der Besuch verschwindet aus den Listen und der Auslastung (bleibt im Protokoll der Anwesenheit), und die Anmeldung kehrt zu Erwartet zurück. Ohne Ankunft, an einem anderen Tag oder schon gegangen: 409. Mindestrolle: Moderator (oder Finanzen).
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
invitation_id | ID | Ja |