# Personen und Organisationen

## Wo fange ich an: `list_organisations` und `list_projects`

Die meisten Werkzeuge brauchen eine ID. Diese beiden liefern sie, ohne Umweg über die App.

`list_organisations` hat keine Argumente. Jede Zeile nennt ID, Name, Subdomain und `scope`:
`all_projects`, oder `selected_projects` für einen Token, der nur einzelne Projekte erreicht.

`list_projects` nennt die Projekte, die der Token erreicht und du lesen darfst.

| Argument | Bedeutung |
|---|---|
| `organisation_id` | nur diese Organisation |
| `include_archived` | auch archivierte Projekte |
| `page`, `per_page` | Seite, höchstens 100 je Seite |

Archivierte Projekte sieht nur ein Konto-Administrator.

## Personen suchen: `find_people`

Durchsucht das [Personen-Verzeichnis](https://lalabase.com/docs/de/guides/people/directory) einer Organisation:
Mitglieder mit Anmeldung und Kontakte ohne, etwa bei Kunden oder Lieferanten.

| Argument | Bedeutung |
|---|---|
| `organisation_id` | Pflicht, die Organisation |
| `query` | ein kurzer Wortstamm, etwa `techn` oder ein Firmenname |
| `kind` | `all` (Standard), `members` oder `contacts` |

Die Suche prüft Name, Funktion, Abteilung, Firma, E-Mail und Zusatzangaben, ohne auf
Groß- und Kleinschreibung zu achten. Die Antwort enthält höchstens 20 Personen. Steht dort
`truncated`, hilft ein längerer Wortstamm.

## Eine Person lesen: `get_person`

Nimmt `organisation_id` und die `id` aus `find_people`, also `person:<uuid>` oder
`member:<uuid>`, und liefert Kontaktdaten wie E-Mail und Telefon.

## Grenzen

- Das Verzeichnis liest nur ein Token, der **alle Projekte** der Organisation erreicht. Für einen
  Token mit einzelnen Projekten gilt die Organisation hier als nicht gefunden.
- Notizen zu einer Person kommen über MCP nie.
- Es gilt, was du selbst im Verzeichnis sehen darfst.
