Werkzeuge · Pakete
MCP-Tools für das Modul Pakete (Coworking): Briefe und Pakete mit Foto erfassen, die Warteschlange, Abholung, Rücksendung, Entsorgung, Wiedereröffnung, Löschen und das „Habe ich ein Paket?“ des Mitglieds.
Das Modul Pakete über den Assistenten: das Paket mit Foto erfassen und das Mitglied benachrichtigen, die Warteschlange verfolgen, Fotos ändern, die Abholung markieren, zurücksenden, entsorgen, wieder öffnen und löschen, und das Mitglied fragen lassen, ob etwas auf es wartet. Es sind 16 Tools.
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 |
|---|---|---|---|
get_parcels_overview | Der Bereich auf einen Blick: die Konfiguration und wie viele warten | Alle, die den Bereich sehen | Nur lesen |
get_parcel | Ein Paket, mit den Fotos | Alle (deines); Team (jedes) | Nur lesen |
do_i_have_parcels | Deine Pakete, offen und Verlauf, mit Ort und Code | Alle | Nur lesen |
mark_parcel_picked_up | Markiert die Abholung | Alle (deine); Moderator oder Finanzen (andere) | Ändert |
search_parcel_recipients | Findet den Empfänger über den Namen | Moderator oder Finanzen | Nur lesen |
register_parcel | Erfasst das Paket und benachrichtigt den Empfänger per E-Mail | Moderator oder Finanzen | Ändert |
list_pending_parcels | Die Warteschlange der Pakete, die auf Abholung warten | Moderator oder Finanzen | Nur lesen |
list_parcels | Der Verlauf, mit jedem Zustand | Moderator oder Finanzen | Nur lesen |
update_parcel | Korrigiert die Daten und den Abholcode des Fachs | Moderator oder Finanzen (wartend); Administrator (abgeschlossen) | Ändert |
add_parcel_photo | Fügt ein Foto hinzu | Moderator oder Finanzen | Ändert |
replace_parcel_photo | Ersetzt ein Foto | Moderator oder Finanzen | Ändert |
return_parcel | Sendet an den Absender zurück | Moderator oder Finanzen | Ändert |
remove_parcel_photo | Entfernt ein Foto endgültig | Moderator oder Finanzen | Mit Bestätigung |
discard_parcel | Entsorgt ein nicht abgeholtes Paket | Administrator | Ändert |
reopen_parcel | Macht einen Abschluss rückgängig | Administrator | Ändert |
delete_parcel | Löscht einen versehentlich angelegten Eintrag | Administrator | Mit Bestätigung |
Der Bereich wird mit create_space und module: "parcels" angelegt, mit dem Argument parcels für die Konfiguration; update_space ändert nur, was du schickst, und behält den Rest.
Das Team ist hier Eigentümer, Administrator, Moderator und Finanzen. Die Rollen sind die der Routen: Der Assistent tut nie mehr, als die verbundene Person in der Oberfläche tun würde. Eigentümer und Administrator sehen die 16 Tools; Moderator und Finanzen 13 (ohne Entsorgen, Wiedereröffnen und Löschen); das Mitglied 4 (get_parcels_overview, get_parcel, do_i_have_parcels und mark_parcel_picked_up, bei den eigenen Paketen).
Der Abholcode des Fachs ist ein Geheimnis. Keine Antwort für das Team enthält ihn, und im Audit-Protokoll des MCP ist er verborgen; nur do_i_have_parcels und get_parcel zeigen ihn, dem Empfänger selbst. Wer erfasst oder korrigiert, kann den Code festlegen, aber nie lesen, und der Assistent wiederholt ihn nicht.
Die Konfiguration des Bereichs
Das Argument parcels von create_space und update_space akzeptiert:
| Feld | Typ | Beschreibung |
|---|---|---|
locker_mode | none oder free | none: alles liegt am Empfang; free: das Team notiert, wo es jedes Paket abgelegt hat |
locker_pickup_code | wahr oder falsch | Das Team kann einen Abholcode pro Paket festlegen; nur der Empfänger sieht ihn |
email_includes_photo | wahr oder falsch | Die Benachrichtigungs-E-Mail enthält eine Vorschau des Fotos (Voreinstellung: ja) |
require_staff_confirmation | wahr oder falsch | Wahr: Nur das Team markiert die Abholung. Falsch (Voreinstellung): auch das Mitglied |
reminder_after_days, reminder_max_count | Zahlen oder null | Frist bis „überfällig“ und Höchstzahl der Erinnerungen. Werden schon akzeptiert, aber die Erinnerung läuft noch nicht |
get_parcels_overview
Nur lesen
Der Bereich auf einen Blick. Die Konfiguration (Fach-Modus und ob das Mitglied die eigene Abholung bestätigt), wie viele Pakete auf dich warten (mine.pendingCount) und, für das Team, wie viele offen und überfällig sind. Mindestrolle: alle, die den Bereich sehen.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
space | ID oder Link | Ja | Der Pakete-Bereich |
Frag so: „Wie viele Pakete liegen im Standort Mitte zu lange?“
get_parcel
Nur lesen
Ein Paket. Mit den Fotos, in signierten Links, die 1 Stunde gelten. Das Team liest jedes Paket der Community, ohne den Code; der Empfänger liest seines, mit Ort und Code, solange es wartet. Jede andere Person erhält „nicht gefunden“. Mindestrolle: alle.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
parcel_id | ID | Ja | Das Paket (aus list_pending_parcels) |
Frag so: „Zeig mir das Paket von Maria.“
do_i_have_parcels
Nur lesen
„Habe ich ein Paket?“ Nur deine: die offenen (alle) und der Verlauf (die letzten), mit dem Abholort, dem Code des Fachs, solange es wartet, und den Fotos (Links für 1 Stunde). Zeige den Code nur der Person selbst. Mindestrolle: alle.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
space | ID oder Link | Nein | Ein bestimmter Bereich; ohne ihn alle |
history_limit | Zahl | Nein | Wie viele aus dem Verlauf (1 bis 100) |
Frag so: „Wartet ein Paket auf mich?“
mark_parcel_picked_up
Ändert
Die Abholung markieren. Das Team markiert als STAFF (Voreinstellung, mit dem Namen der gekommenen Person in picked_up_by_name, der standardmäßig der Empfänger ist) oder THIRD_PARTY (der Name ist Pflicht). Der Empfänger selbst markiert als SELF, nur wenn der Bereich die Bestätigung durch das Team nicht verlangt (sonst abgewiesen). Der Abholcode des Fachs wird gelöscht. Es ist idempotent: Bei einem bereits abgeschlossenen Paket liefert es already_closed: true. Mindestrolle: alle (deine); Moderator oder Finanzen (andere).
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
parcel_id | ID | Ja | Das Paket (aus list_pending_parcels) |
method | STAFF, SELF oder THIRD_PARTY | Nein | Wie es abgeholt wurde |
picked_up_by_name | Text | Nein | Wer gekommen ist (Pflicht bei THIRD_PARTY) |
Frag so: „Markiere das Paket von Maria als abgeholt.“ · „Ich habe mein Paket schon abgeholt.“
search_parcel_recipients
Nur lesen
Wer empfängt. Die Mitglieder des Bereichs, deren Name mit q beginnt (mindestens 3 Buchstaben, bis zu 8 Ergebnisse), nur mit ID, Namen und Initialen. Die id ist das recipient_profile_id von register_parcel. Mindestrolle: Moderator (oder Finanzen).
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
space | ID oder Link | Ja | Der Pakete-Bereich |
q | Text | Ja | Der Namensanfang |
Frag so: „Such Maria Souza, um ein Paket zu erfassen.“
register_parcel
Ändert
Das Paket erfassen. Für ein Mitglied mit Zugriff auf den Bereich. Sendet dem Empfänger die Benachrichtigungs-E-Mail (mit der Vorschau, wenn der Bereich so eingestellt ist), in der Zeitzone der Community: Der Assistent sagt das. kind ist LETTER, PACKAGE oder OTHER (dieses verlangt kind_label). locker_label und locker_pickup_code (4 bis 12 Zeichen, ein Geheimnis) gelten nur, wenn der Bereich es erlaubt. Mit client_request_id liefert ein wiederholter Aufruf dasselbe Paket, ohne zweite E-Mail. Derselbe Empfänger, dieselbe Art und Sendungsnummer innerhalb von 24 Stunden wird abgewiesen (409), außer force ist wahr. Mindestrolle: Moderator (oder Finanzen).
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
space | ID oder Link | Ja | Der Pakete-Bereich |
recipient_profile_id | ID | Ja | Aus search_parcel_recipients |
kind | LETTER, PACKAGE oder OTHER | Ja | Die Art |
kind_label | Text | Mit OTHER | Bis zu 60 Zeichen |
sender_name, carrier, tracking_code | Text | Nein | Absender, Transportunternehmen und Sendungsnummer |
notes | Text | Nein | Bis zu 200 Zeichen |
locker_label, locker_pickup_code | Text | Nein | Wo es liegt und der Code |
photos | Liste | Nein | Bis zu 5, jedes mit image_url oder image_base64 |
client_request_id, force | Text, wahr/falsch | Nein | Idempotenz und Erfassung trotz Duplikat |
Frag so: „Ein Amazon-Paket für Maria Souza ist angekommen, in Fach 12. Foto: [Link].“
list_pending_parcels
Nur lesen
Die Warteschlange. Die Pakete, die auf Abholung warten, vom neuesten zum ältesten, mit Empfänger, Art, Absender, Ort, wie lange sie warten und stalled_days, wenn sie die Frist überschritten haben. Filter: kind, q (Empfänger, Absender, Transportunternehmen oder Sendungsnummer), stalled, recipient_profile_id, from und to (JJJJ-MM-TT, in der Zeitzone der Community). Nie der Code (nur has_locker_code). Mindestrolle: Moderator (oder Finanzen).
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
space | ID oder Link | Ja | Der Pakete-Bereich |
kind, q, stalled, recipient_profile_id, from, to | verschiedene | Nein | Die Filter |
page, limit | Zahlen | Nein | Paginierung (bis 100) |
Frag so: „Was liegt seit mehr als 3 Tagen am Empfang?“
list_parcels
Nur lesen
Der Verlauf. Wie list_pending_parcels, aber mit jedem Zustand (RECEIVED, PICKED_UP, RETURNED, DISCARDED), filterbar über status. Mindestrolle: Moderator (oder Finanzen).
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
space | ID oder Link | Ja | Der Pakete-Bereich |
status | Zustand | Nein | Filtert nach dem Zustand |
die Filter von list_pending_parcels | verschiedene | Nein |
Frag so: „Welche Pakete wurden diesen Monat zurückgesendet?“
update_parcel
Ändert
Korrigieren. Art, Absender, Transportunternehmen, Sendungsnummer, Hinweis, Ort und Abholcode des Fachs (der neu festgelegt, nie gelesen wird) eines wartenden Pakets. Ein abgeschlossenes Paket korrigieren nur Eigentümer oder Administrator, und nie den Code. Jede Korrektur kommt ins Protokoll. Mindestrolle: Moderator (oder Finanzen).
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
parcel_id | ID | Ja | Das Paket (aus list_pending_parcels) |
kind, kind_label, sender_name, carrier, tracking_code, notes, locker_label, locker_pickup_code | verschiedene | Nein | Nur, was sich ändert |
Frag so: „Korrigiere die Sendungsnummer des Pakets von Maria auf BR123456789.“
add_parcel_photo
Ändert
Ein Foto hinzufügen. Bis zu 5 pro Paket, in privatem Speicher. Das Team; bei einem abgeschlossenen Paket nur Eigentümer und Administrator. Mindestrolle: Moderator (oder Finanzen).
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
parcel_id | ID | Ja | Das Paket (aus list_pending_parcels) |
image_url oder image_base64 (+ image_type) | Text | Ja | Das Foto: ein öffentlicher Link oder die Datei in Base64. Es liegt in privatem Speicher |
Frag so: „Hänge dieses Foto an das Paket von Maria.“
replace_parcel_photo
Ändert
Ein Foto ersetzen. Ersetzt ein Foto durch die neue Datei; die alte wird gelöscht. Mindestrolle: Moderator (oder Finanzen).
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
parcel_id | ID | Ja | Das Paket (aus list_pending_parcels) |
photo_id | ID | Ja | Das Foto (aus get_parcel) |
image_url oder image_base64 (+ image_type) | Text | Ja | Das Foto: ein öffentlicher Link oder die Datei in Base64. Es liegt in privatem Speicher |
Frag so: „Ersetze das erste Foto des Pakets durch dieses.“
return_parcel
Ändert
An den Absender zurücksenden. Verlangt den Grund. Nichts wird gelöscht: Das Paket bleibt als RETURNED im Verlauf, und der Abholcode des Fachs wird gelöscht. Ein bereits abgeschlossenes Paket antwortet 409. Mindestrolle: Moderator (oder Finanzen).
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
parcel_id | ID | Ja | Das Paket (aus list_pending_parcels) |
reason | Text | Ja | Der Grund, bis zu 200 Zeichen; er kommt ins Protokoll |
Frag so: „Sende das Paket von Maria an den Absender zurück: abgelehnt.“
remove_parcel_photo
Mit Bestätigung
Ein Foto entfernen. Die Datei wird endgültig gelöscht. Beim ersten Aufruf liefert es die Zusammenfassung und den Bestätigungscode. Mindestrolle: Moderator (oder Finanzen).
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
parcel_id | ID | Ja | Das Paket (aus list_pending_parcels) |
photo_id | ID | Ja | Das Foto (aus get_parcel) |
Frag so: „Entferne das zweite Foto des Pakets; es zeigt die Adresse.“
discard_parcel
Ändert
Entsorgen. Für ein Paket, das niemand abgeholt hat. Verlangt den Grund. Nichts wird gelöscht: Es bleibt als DISCARDED im Verlauf, und reopen_parcel macht es rückgängig. Verlangt keine Bestätigung, weil es umkehrbar ist. Mindestrolle: Administrator (Eigentümer oder Administrator).
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
parcel_id | ID | Ja | Das Paket (aus list_pending_parcels) |
reason | Text | Ja | Der Grund, bis zu 200 Zeichen; er kommt ins Protokoll |
Frag so: „Entsorge das Paket von Maria: abgelaufen, nicht abgeholt.“
reopen_parcel
Ändert
Wieder öffnen. Macht eine versehentliche Abholung, Rücksendung oder Entsorgung rückgängig: Es geht zurück auf RECEIVED, mit dem Grund. Der gelöschte Code kommt nicht zurück; lege mit update_parcel einen neuen fest. Mindestrolle: Administrator (Eigentümer oder Administrator).
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
parcel_id | ID | Ja | Das Paket (aus list_pending_parcels) |
reason | Text | Ja | Der Grund, bis zu 200 Zeichen; er kommt ins Protokoll |
Frag so: „Öffne das Paket von Maria wieder: Die Abholung wurde versehentlich markiert.“
delete_parcel
Mit Bestätigung
Einen versehentlich angelegten Eintrag löschen. Er verschwindet aus den Listen, und die Fotos werden gelöscht; das Protokoll hält fest, wer und warum. Um ein Paket wirklich abzuschließen, nutze mark_parcel_picked_up, return_parcel oder discard_parcel. Beim ersten Aufruf liefert es die Zusammenfassung und den Bestätigungscode. Mindestrolle: Administrator (Eigentümer oder Administrator).
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
parcel_id | ID | Ja | Das Paket (aus list_pending_parcels) |
reason | Text | Ja | Der Grund, bis zu 200 Zeichen; er kommt ins Protokoll |
Frag so: „Lösche den Eintrag des Pakets von João: Ich habe ihn für die falsche Person erfasst.“