MCP-Konnektor

Agile Workflows in Claude und ChatGPT

Verbinden Sie Ihren KI-Assistenten mit Agile Workflows. Dann baut er Workflows aus einer Beschreibung, startet sie, findet Fehler in Läufen und nutzt Ihre eigenen Workflows als Werkzeuge. Sie melden sich dabei ganz normal bei Agile Workflows an und entscheiden, was der Assistent darf.

Ihre Konnektor-Adresse

Diese URL tragen Sie in jedem Assistenten ein. Die Anmeldung läuft über OAuth; Sie kopieren kein Passwort und keinen Schlüssel in den Assistenten.

https://workflows.agiledeveloper.de/mcp

Claude (claude.ai, Desktop und Mobil)

  1. Öffnen Sie Einstellungen › Konnektoren und wählen Sie Benutzerdefinierten Konnektor hinzufügen.
  2. Name „Agile Workflows“, URL https://workflows.agiledeveloper.de/mcp, dann Hinzufügen.
  3. Klicken Sie auf Verbinden. Agile Workflows öffnet sich: anmelden, Rechte prüfen, Erlauben.
  4. Im Chat über das Werkzeug-Menü den Konnektor einschalten und loslegen.

In Team- und Enterprise-Organisationen fügt meist die Verwaltung den Konnektor einmal für alle hinzu; danach verbindet sich jede Person selbst.

ChatGPT

  1. Öffnen Sie Einstellungen › Apps und Konnektoren › Erweitert und schalten Sie den Entwicklermodus ein.
  2. Wählen Sie Konnektor erstellen: Name „Agile Workflows“, URL https://workflows.agiledeveloper.de/mcp, Authentifizierung OAuth.
  3. Bei Agile Workflows anmelden und Erlauben. Danach steht der Konnektor im Chat unter den Werkzeugen zur Auswahl.

Für die Suche in ChatGPT (Deep Research, Konnektor-Suche) gibt es die Werkzeuge search und fetch: Sie finden Workflows, Läufe, Apps und Vorlagen und liefern deren Inhalt als Text.

Ob und in welchem Umfang der Entwicklermodus in Ihrem ChatGPT-Tarif verfügbar ist, legt OpenAI fest. Die Menünamen können sich bei OpenAI ändern.

Claude Code

Im Terminal hinzufügen:

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

Dann in Claude Code /mcp eingeben, agile-workflows wählen und Authentifizieren. Der Browser öffnet die Anmeldung.

Ohne Browser, mit API-Schlüssel

Für Server und Skripte: einen Schlüssel unter Einstellungen › Entwickler anlegen und als Header mitgeben.

claude mcp add --transport http agile-workflows https://workflows.agiledeveloper.de/mcp --header "Authorization: Bearer agile_wf_…"

Andere MCP-Clients (Cursor, VS Code, MCP Inspector)

Streamable HTTP mit OAuth 2.1 (Discovery, dynamische Registrierung, PKCE). Typische Konfiguration:

{ "mcpServers": { "agile-workflows": { "type": "http", "url": "https://workflows.agiledeveloper.de/mcp" } } }

Beispiele

So können Sie mit dem Assistenten sprechen:

„Bau mir einen Workflow: Wenn jemand unser Kontaktformular abschickt, leg den Kontakt in Agile CRM an und schick mir eine E-Mail.“

„Welche Workflows sind in den letzten 7 Tagen fehlgeschlagen, und woran lag es?“

„Führe den Workflow „Angebot erstellen“ für die Muster GmbH mit 12 Stunden Beratung aus.“

„Schalte den Workflow „Newsletter-Anmeldungen“ aus, bis ich Bescheid gebe.“

„Wie viele Ausführungen habe ich diesen Monat noch?“

Workflows, die der Assistent baut, sind immer Entwürfe und nie eingeschaltet. Er schickt Ihnen den Link zum Editor; dort wählen Sie die Verbindungen (Zugangsdaten gibt der Assistent nie ein und sieht sie nie) und schalten den Workflow ein.

Werkzeuge

WerkzeugWas es tutRecht
workflows_auflistenWorkflows auflisten. Listet die Workflows des Arbeitsbereichs mit Status, Auslöser, beteiligten Apps, letztem Lauf und Läufen und Fehlern der letzten 30 Tage.lesen
workflow_anzeigenWorkflow anzeigen. Zeigt einen Workflow vollständig: Entwurf (Auslöser und Schritte als JSON), veröffentlichte Version, Versionen, Webhook- und Formular-URL und den Link zum Editor.lesen
workflow_erstellenWorkflow erstellen (Entwurf). Legt einen neuen Workflow als ENTWURF an, nie eingeschaltet. Genau einen Weg wählen: „beschreibung“ (deutsch; der KI-Builder baut Auslöser und Schritte), „vorlage“ (Schlüssel aus vorlagen_auflisten) oder „definition“ (WorkflowDef als JSON). Die Antwort enthält editor_url: Dort wählt die Person die Verbindungen und schaltet den Workflow ein.schreiben
workflow_aendernWorkflow ändern. Ändert Name, Beschreibung oder Entwurf eines Workflows. Mit „aenderung“ (deutsch, z. B. „Schick die Mail zusätzlich an buchhaltung@…“) passt der KI-Builder den Entwurf an; alternativ „entwurf“ als vollständige WorkflowDef. Der eingeschaltete Workflow ändert sich erst nach dem Veröffentlichen (Editor oder workflow_aktivieren).schreiben
workflow_aktivierenWorkflow ein- oder ausschalten. Schaltet einen Workflow ein (aktiv=true: veröffentlicht den Entwurf, falls nötig; ab dann reagiert er auf echte Ereignisse) oder aus (aktiv=false). Nur auf ausdrücklichen Wunsch der Person einschalten.schreiben
workflow_ausfuehrenWorkflow ausführen. Startet die veröffentlichte Version eines Workflows mit optionalen Eingangsdaten (zählt als Ausführung) und wartet bis zu warten_s Sekunden auf das Ergebnis. Wirkt nach außen (z. B. E-Mails), daher bei Zweifeln vorher nachfragen.ausführen
laeufe_auflistenLäufe auflisten. Listet Läufe (neueste zuerst) mit Status, Quelle, Dauer und Fehler. Filter nach Workflow, Status und Zeitpunkt, z. B. status=fehler für die Fehlersuche.lesen
lauf_anzeigenLauf anzeigen. Zeigt einen Lauf mit Eingangsdaten und dem Protokoll jedes Schritts (Eingabe, Ausgabe, Fehler, Dauer). Große Daten sind gekürzt.lesen
apps_suchenApps suchen. Durchsucht den App-Katalog (eingebaute Apps wie HTTP, E-Mail, Code und KI sowie Dienste wie Slack, Google Sheets oder Agile CRM). Ohne „app“: Liste mit Aktionen und Auslösern. Mit „app“: alle Felder dieser App.jeder Zugang
vorlagen_auflistenVorlagen auflisten. Listet fertige Vorlagen, zum Beispiel „Formular an Google Sheets und E-Mail“. Mit workflow_erstellen und „vorlage“ entsteht daraus ein Entwurf.jeder Zugang
nutzung_anzeigenNutzung und Tarif anzeigen. Tarif, verbrauchte und enthaltene Ausführungen im laufenden Monat, angehaltene Läufe und Abo-Status.lesen
search, fetchSuche und Abruf für ChatGPT.lesen
wf_…Ihre eigenen Workflows mit dem Auslöser „KI-Werkzeug“, siehe unten.ausführen

Eigene Workflows als KI-Werkzeuge

Wählen Sie im Editor den Auslöser KI-Werkzeug, beschreiben Sie, wofür das Werkzeug da ist, und legen Sie die Eingabefelder fest (zum Beispiel „Firma“ und „Stunden“). Sobald der Workflow eingeschaltet ist, sieht Ihr Assistent ein eigenes Werkzeug wf_angebot_erstellen mit genau diesen Feldern.

  • Der Assistent ruft es auf, wenn Ihre Bitte zur Beschreibung passt. Agile Workflows startet einen Lauf und wartet bis zu 60 Sekunden auf das Ergebnis.
  • Das Ergebnis ist die Antwort des Schritts „Webhook antworten“, sonst die Ausgabe des letzten Schritts.
  • Jeder Aufruf zählt als Ausführung. Ausgeschaltete Workflows erscheinen nicht.
  • Manche Assistenten laden die Werkzeugliste erst nach einem neuen Chat oder nach dem erneuten Verbinden neu.

Rechte und Sicherheit

LesenWorkflows, Läufe mit Protokoll, Verbindungen (ohne Zugangsdaten), Speicher, Nutzung.
SchreibenWorkflows anlegen und ändern, ein- und ausschalten, Verbindungen, Speicher, Team, Webhooks.
AusführenWorkflows starten und eigene KI-Werkzeuge nutzen, Läufe wiederholen und abbrechen.
  • Der Assistent arbeitet nur im Arbeitsbereich, mit dem Sie sich verbinden, und nie mit mehr Rechten als Ihre Rolle im Team.
  • Zugangsdaten von Verbindungen gibt es über den Konnektor nie, auch nicht mit allen Rechten.
  • Tarif und Zahlungen ändert nur ein Mensch in der App.
  • Unter Einstellungen › Verbundene Apps sehen Sie jede Verbindung mit ihren Rechten und trennen sie mit einem Klick. Der Zugriff endet sofort.

Fehlerbehebung

  • Anmeldefenster öffnet sich nicht: Pop-up-Blocker prüfen oder die Verbindung im Assistenten neu starten.
  • „Diesem Zugang fehlt das Recht …“: Verbindung trennen und neu verbinden, dabei das passende Recht anhaken.
  • Neues KI-Werkzeug fehlt: Workflow eingeschaltet? Dann einen neuen Chat beginnen oder den Konnektor neu verbinden.
  • Verbindung abgelaufen: Unbenutzte Verbindungen enden nach 60 Tagen. Einfach neu verbinden.
  • Falsches Konto: Unter Verbundene Apps trennen, abmelden und mit dem richtigen Konto neu verbinden.

Für Entwickler: OAuth-Metadaten unter /.well-known/oauth-authorization-server, geschützte Ressource unter /.well-known/oauth-protected-resource, REST-API unter /docs.

Agile Workflows in Claude und ChatGPT verbinden (MCP) · Agile Workflows