# 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](/espacos/encomendas) ü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: <span class="tool-kind tool-kind-read">Nur lesen</span> ändert nichts, <span class="tool-kind tool-kind-write">Ändert</span> legt sofort etwas an oder ändert es, und <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> handelt erst nach deinem Ja zu einer Zusammenfassung. Siehe [Geld und Bestätigung](/mcp/dinheiro-e-confirmacao).

## Kurz gesagt

| Tool | Was es tut | Mindestrolle | Typ |
|---|---|---|---|
| [`get_parcels_overview`](#get-parcels-overview) | Der Bereich auf einen Blick: die Konfiguration und wie viele warten | Alle, die den Bereich sehen | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`get_parcel`](#get-parcel) | Ein Paket, mit den Fotos | Alle (deines); Team (jedes) | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`do_i_have_parcels`](#do-i-have-parcels) | Deine Pakete, offen und Verlauf, mit Ort und Code | Alle | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`mark_parcel_picked_up`](#mark-parcel-picked-up) | Markiert die Abholung | Alle (deine); Moderator oder Finanzen (andere) | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`search_parcel_recipients`](#search-parcel-recipients) | Findet den Empfänger über den Namen | Moderator oder Finanzen | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`register_parcel`](#register-parcel) | Erfasst das Paket und benachrichtigt den Empfänger per E-Mail | Moderator oder Finanzen | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`list_pending_parcels`](#list-pending-parcels) | Die Warteschlange der Pakete, die auf Abholung warten | Moderator oder Finanzen | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`list_parcels`](#list-parcels) | Der Verlauf, mit jedem Zustand | Moderator oder Finanzen | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`update_parcel`](#update-parcel) | Korrigiert die Daten und den Abholcode des Fachs | Moderator oder Finanzen (wartend); Administrator (abgeschlossen) | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`add_parcel_photo`](#add-parcel-photo) | Fügt ein Foto hinzu | Moderator oder Finanzen | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`replace_parcel_photo`](#replace-parcel-photo) | Ersetzt ein Foto | Moderator oder Finanzen | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`return_parcel`](#return-parcel) | Sendet an den Absender zurück | Moderator oder Finanzen | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`remove_parcel_photo`](#remove-parcel-photo) | Entfernt ein Foto endgültig | Moderator oder Finanzen | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`discard_parcel`](#discard-parcel) | Entsorgt ein nicht abgeholtes Paket | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`reopen_parcel`](#reopen-parcel) | Macht einen Abschluss rückgängig | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`delete_parcel`](#delete-parcel) | Löscht einen versehentlich angelegten Eintrag | Administrator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |

Der Bereich wird mit [`create_space`](/mcp/ferramentas-comunidade#create-space) und `module: "parcels"` angelegt, mit dem Argument `parcels` für die Konfiguration; [`update_space`](/mcp/ferramentas-comunidade#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`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**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`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**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`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**„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`

<span class="tool-kind tool-kind-write">Ändert</span>

**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`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**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`

<span class="tool-kind tool-kind-write">Ändert</span>

**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`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**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`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**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`

<span class="tool-kind tool-kind-write">Ändert</span>

**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`

<span class="tool-kind tool-kind-write">Ändert</span>

**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`

<span class="tool-kind tool-kind-write">Ändert</span>

**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`

<span class="tool-kind tool-kind-write">Ändert</span>

**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`

<span class="tool-kind tool-kind-confirm">Mit Bestätigung</span>

**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`

<span class="tool-kind tool-kind-write">Ändert</span>

**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`

<span class="tool-kind tool-kind-write">Ändert</span>

**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`

<span class="tool-kind tool-kind-confirm">Mit Bestätigung</span>

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

## Verwandte Artikel

- [Pakete](/espacos/encomendas)
- [Werkzeuge](/mcp/ferramentas)
- [Geld und Bestätigung](/mcp/dinheiro-e-confirmacao)
- [Rezepte](/mcp/receitas)