Agile Extract in Claude und ChatGPT (MCP)

Über das Model Context Protocol arbeitet Ihr KI-Assistent mit Ihrem Arbeitsbereich: Läufe durchsehen, Gründe für unvollständige Auslesungen finden, Vorlagen testen und verbessern, Dokumente auslesen. Das Auslesen selbst bleibt regelbasiert; Agile Extract nutzt keine generative KI.

Adresse

https://extract.agiledeveloper.de/mcp

Anmeldung per OAuth 2.1 (mit dynamischer Registrierung und PKCE): Beim Verbinden öffnet sich die Anmeldung von Agile Extract; Sie wählen den Arbeitsbereich und die Rechte. Alternativ geht ein API-Schlüssel als Bearer-Token (Authorization: Bearer agile_ex_…).

Claude (claude.ai, Desktop)

Einstellungen › Konnektoren › Benutzerdefinierten Konnektor hinzufügen.
Name „Agile Extract“, URL wie oben, hinzufügen.
Verbinden, bei Agile Extract anmelden, Arbeitsbereich und Rechte bestätigen.

ChatGPT

Einstellungen › Apps und Konnektoren › Entwicklermodus einschalten, dann „Erstellen“.
URL wie oben, Authentifizierung OAuth.
Bei Agile Extract anmelden und zustimmen. ChatGPT nutzt vor allem search und fetch.

Claude Code

claude mcp add --transport http agile-extract https://extract.agiledeveloper.de/mcp

Danach in Claude Code /mcp aufrufen und anmelden.

Rechte

Recht	erlaubt
lesen	Vorlagen, Läufe, Ergebnisse und Dokumente sehen, Vorlagen-Entwürfe testen
schreiben	Dokumente auslesen, Läufe wiederholen, Korrekturen melden, neue Vorlagenversionen speichern

Team, API-Schlüssel, Webhooks und Einstellungen sind über MCP nicht änderbar. Verbundene Apps trennen Sie unter Einstellungen › KI-Apps.

Werkzeuge

Werkzeug	Recht	Beschreibung
`search`	lesen	Sucht Vorlagen (Name, Dokumentart) und Läufe (Dateiname, Referenz, Lauf-ID). Liefert results mit id, title, url. Den Inhalt holt fetch.
`fetch`	lesen	Holt den Inhalt zu einer id aus search (vorlage:… oder lauf:…) als Text.
`vorlagen_auflisten`	lesen	Alle Vorlagen des Arbeitsbereichs mit aktiver Version, Anzahl Beispiele und Läufen der letzten 30 Tage.
`vorlage_anzeigen`	lesen	Vorlage mit Definition (aktive Version oder eine bestimmte), Versionsliste und Beispielen.
`vorlage_testen`	lesen	Testet eine Definition (Entwurf, ohne Speichern) oder die aktive Version gegen alle Beispiele der Vorlage. Je Beispiel: Erkennung (Punkte), Status, Felder mit Werten und Gründen.
`erkennung_testen`	lesen	Prüft die Erkennungsregeln einer Definition gegen die Dokumente der letzten Läufe ohne passende Vorlage (no_template); mit alle=true gegen alle Läufe.
`vorlage_version_speichern`	schreiben	Speichert eine geänderte Definition als neue Version (unveränderlich) und setzt sie aktiv (aktivieren=false: nur speichern). Vorher mit vorlage_testen prüfen und die Person fragen.
`laeufe_auflisten`	lesen	Läufe des Arbeitsbereichs, neueste zuerst, mit Filtern.
`lauf_anzeigen`	lesen	Ein Lauf mit vollem Protokoll: Vorlage und Version, Auswahl (auto mit Punkten und Kandidaten), jedes Feld mit Wert, Rohtext, Seite, Box, Sicherheit und Prüfung, Gründe, Zeiten, Vergleich zur Vorgängerversion.
`dokument_auslesen`	schreiben	Liest eine Datei (PDF oder Bild, als Base64, bis 8 MB) mit einer Vorlage aus (vorlage=auto wählt selbst) und wartet bis zu 50 Sekunden auf das Ergebnis.
`lauf_wiederholen`	schreiben	Liest das gespeicherte Dokument eines Laufs erneut aus (Vorgabe: gleiche Vorlage, aktive Version; oder vorlage/version angeben). Ergebnis mit Vergleich zum vorigen Lauf.
`rueckmeldung_geben`	schreiben	Meldet richtige Werte zu einem Lauf (Feldname → Wert). Hilft, die Vorlage später zu verbessern; ändert das Ergebnis des Laufs nicht.

Gut zu wissen

Eine neue Vorlagenversion speichert der Assistent erst, wenn Sie zustimmen. Läufe behalten ihre Version; mit lauf_wiederholen lesen Sie sie mit der neuen Version neu aus und sehen den Vergleich.
Werte erfindet der Assistent nicht: was die Vorlage nicht findet, bleibt leer.
Technik: Streamable HTTP (nur POST, JSON-Antworten), Discovery unter /.well-known/oauth-protected-resource und /.well-known/oauth-authorization-server.