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/mcpClaude (claude.ai, Desktop und Mobil)
- Öffnen Sie Einstellungen › Konnektoren und wählen Sie Benutzerdefinierten Konnektor hinzufügen.
- Name „Agile Workflows“, URL https://workflows.agiledeveloper.de/mcp, dann Hinzufügen.
- Klicken Sie auf Verbinden. Agile Workflows öffnet sich: anmelden, Rechte prüfen, Erlauben.
- 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
- Öffnen Sie Einstellungen › Apps und Konnektoren › Erweitert und schalten Sie den Entwicklermodus ein.
- Wählen Sie Konnektor erstellen: Name „Agile Workflows“, URL https://workflows.agiledeveloper.de/mcp, Authentifizierung OAuth.
- 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/mcpDann 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
| Werkzeug | Was es tut | Recht |
|---|---|---|
| workflows_auflisten | Workflows 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_anzeigen | Workflow 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_erstellen | Workflow 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_aendern | Workflow ä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_aktivieren | Workflow 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_ausfuehren | Workflow 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_auflisten | Lä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_anzeigen | Lauf anzeigen. Zeigt einen Lauf mit Eingangsdaten und dem Protokoll jedes Schritts (Eingabe, Ausgabe, Fehler, Dauer). Große Daten sind gekürzt. | lesen |
| apps_suchen | Apps 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_auflisten | Vorlagen 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_anzeigen | Nutzung und Tarif anzeigen. Tarif, verbrauchte und enthaltene Ausführungen im laufenden Monat, angehaltene Läufe und Abo-Status. | lesen |
| search, fetch | Suche 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
- 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.