Mit dem Agenten arbeiten
Was ein Agent über MCP in deiner Instanz kann, was er nie kann und was er von dir wissen muss.
Deine Instanz ist ein MCP-Server unter /mcp. Ein Agent wie Claude Code erreicht darüber Struktur, Daten, Rechte und die Dateien der Werkzeuge. Er meldet sich mit deinem Zugriffstoken an und hat höchstens deine Rechte.
So beginnst du
- Richte den Arbeitsplatz ein und starte den Agenten dort.
- Bitte ihn, zuerst
start_hereaufzurufen. Die Antwort nennt die Instanz, den Raum, die Reihenfolge der Schritte und die Regeln, die sich später nicht korrigieren lassen. - Beschreibe, was du brauchst: welche Angaben, wer damit arbeitet, wer was sehen darf.
Der Agent arbeitet dann in dieser Reihenfolge: Collection anlegen, mit ein paar Zeilen prüfen, Werkzeug erzeugen, Werkzeug einer Rolle freigeben, Besitzer nennen.
Was der Agent von dir wissen muss
- Zweck und Aufbewahrungsfrist. Eine neue Collection nennt beides. Der Agent fragt dich danach und erfindet keine Frist. Die Frist ist eine Anzahl Monate oder unbegrenzt.
- Besitzer des Werkzeugs. Das ist die Person, die man zu dem Werkzeug fragt. Sie muss Administratorin oder Administrator sein. Der Agent trägt sie ein, solange noch niemand dasteht. Ändern kann sie danach nur ein Mensch im Adminbereich.
- Wer Rechte bekommt. Rechte hängen an Rollen. Nenne die Rolle, die das Werkzeug benutzen soll.
Die MCP-Werkzeuge
| Gruppe | Werkzeuge |
|---|---|
| Einstieg | start_here, whoami, get_agent_instructions |
| Struktur | list_collections, describe_collection, describe_types, ensure_collection, ensure_index, discard_field, discard_collection |
| Daten | query_records, count_records, aggregate_records, create_record, update_record, delete_record, describe_api |
| Rollen und Rechte | list_roles, describe_role, ensure_role, find_people, add_role_member, set_collection_grant, set_tool_grant |
| Gruppen und Kontexte | list_person_groups, ensure_person_group, add_person_group_member, give_person_group_role, list_contexts, ensure_context, map_context_value |
| Werkzeugdateien | list_tools, scaffold_tool, read_tool_file, put_tool_files, check_tool, set_tool_owner, list_tool_errors, resolve_tool_error |
| Buckets | ensure_bucket, list_buckets |
Einige davon lohnt es sich zu kennen:
ensure_collectionnimmt den Zielzustand. Ein zweiter Aufruf mit demselben Inhalt ändert nichts. MitgrantTobekommt eine Rolle im selben Aufruf Lese- und Schreibrecht. Ohne Grant sieht niemand die Daten, auch nicht, wer die Collection angelegt hat.scaffold_toolerzeugt ein lauffähiges Werkzeug für eine Collection im Entwurf. Formular und Tabelle entstehen aus dem Schema.check_toolsagt, ob sich ein Werkzeug veröffentlichen lässt, und sonst, was in welcher Datei fehlt.describe_apinennt die HTTP-Aufrufe für eine Collection mit ihren echten Feldnamen.list_tool_errorszeigt Fehler, die ein Werkzeug in den Browsern seiner Benutzer hatte.
query_records liefert höchstens 20 Zeilen je Aufruf. Dateien gehen nicht über MCP in einen Bucket, sondern über HTTP.
Was der Agent nie kann
- Rechte entziehen. Ein Grant, den der Agent gesetzt hat, lässt sich nur im Adminbereich zurücknehmen. Lass ihn deshalb mit
describe_rolenachsehen, bevor er ein Recht gibt. - Struktur der Produktion löschen. Es gibt kein Werkzeug, das eine Collection oder ein Feld aus der Produktion entfernt.
discard_fieldunddiscard_collectionwirken nur im Übungsraum und nur auf das, was nie in die Produktion kam. - Ein Werkzeug veröffentlichen. Alles, was der Agent schreibt, landet im Entwurf.
- Fähigkeiten geben.
mail.sendundpeople.readvergibt ein Mensch im Adminbereich an eine Rolle. - Einen Index, einen Bucket oder einen Besitzer entfernen.
Einzelne Zeilen löscht der Agent mit delete_record, wenn du Schreibrecht auf die Collection hast.
Wo der Agent arbeitet
Mit einem Token für den Übungsraum sieht der Agent nur, was dort entstanden ist. Struktur, die er anlegt, wartet danach auf einen Menschen, der sie in die Produktion überträgt. Personen sieht er unter Pseudonymen.
Struktur ändern und Rechte geben kann der Agent nur, wenn du selbst Administratorin oder Administrator bist. Antwortet die Instanz mit „kein Zugriff“, hilft zuerst whoami: Meist fehlt ein Grant, nicht eine Struktur.
Die Anweisungen aktuell halten
get_agent_instructions liefert die aktuellen Regeln für den Bau von Werkzeugen als Markdown mit einer Version. Lege den Block in die Datei, die dein Agent liest (CLAUDE.md, AGENTS.md, README.md). Ruft der Agent das Werkzeug mit der Version auf, die er schon hat, erfährt er, ob sie noch gilt.