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