Zum Inhalt springen
Agile KundensupportDoku
AnmeldenKostenlos startenStarten

In Claude und ChatGPT verbinden

Ihr KI-Assistent arbeitet dann direkt in Agile Kundensupport: offene Gespräche zusammenfassen, Antworten entwerfen, Artikel schreiben, Wissenslücken finden. Sie melden sich mit Ihrem Agile-Konto an und entscheiden, welcher Arbeitsbereich und welche Rechte. Das dauert etwa eine Minute.

Die Adresse des MCP-Servers

https://kundensupport.agiledeveloper.de/mcp

Anmeldung per OAuth. Sie geben kein Passwort an Claude oder ChatGPT weiter.

claude.ai und Claude Desktop

In Claude

  1. In Claude links unten auf Ihr Profil, dann Einstellungen › Konnektoren.
  2. Benutzerdefinierten Konnektor hinzufügen wählen.
  3. Name Agile Kundensupport, URL https://kundensupport.agiledeveloper.de/mcp. Die erweiterten Felder (Client-ID, Client-Secret) bleiben leer.
  4. Hinzufügen, dann beim neuen Konnektor auf Verbinden. Die Anmeldung bei Agile öffnet sich.
  5. Anmelden, Arbeitsbereich und Rechte wählen, Zugriff erlauben.
  6. Im Chat über das Werkzeug-Menü den Konnektor einschalten und loslegen.

In Team- und Enterprise-Konten fügt in der Regel eine Person mit Verwaltungsrechten den Konnektor für die Organisation hinzu. Verbinden tut sich danach jede Person selbst. Claude Desktop übernimmt Konnektoren aus Ihrem claude.ai-Konto.

Claude Code

Im Terminal

  1. Den Server eintragen. Mit --scope user gilt er in allen Projekten.
    claude mcp add --transport http agile-kundensupport https://kundensupport.agiledeveloper.de/mcp
  2. In Claude Code /mcp eingeben, agile-kundensupport wählen, dann Authentifizieren (Authenticate).
  3. Im Browser bei Agile anmelden und zustimmen. Fertig.

ChatGPT

In ChatGPT

  1. Einstellungen › Apps und Konnektoren › Erweiterte Einstellungen öffnen und den Entwicklermodus einschalten.
  2. Zurück unter Apps und Konnektoren auf Erstellen (App erstellen).
  3. Name Agile Kundensupport, MCP-Server-URL https://kundensupport.agiledeveloper.de/mcp, Authentifizierung OAuth.
  4. Bestätigen, dass Sie der Anwendung vertrauen, dann Erstellen. Die Anmeldung bei Agile öffnet sich.
  5. Anmelden, Arbeitsbereich und Rechte wählen, zustimmen. Im Chat über + den Konnektor auswählen.

Je nach Plan. Laut OpenAI-Hilfe ist der volle MCP-Zugriff mit schreibenden Aktionen als Beta für ChatGPT Business, Enterprise und Edu verfügbar, nur im Web. In Firmenkonten schaltet die Verwaltung den Entwicklermodus frei. Vor schreibenden Aktionen fragt ChatGPT bei Ihnen nach. Menünamen ändern sich gelegentlich; was für Ihr Konto gilt, steht in der Hilfe von OpenAI.

Alternativ

Mit API-Schlüssel, für Skripte und CI

Wo kein Browser für die Anmeldung da ist, nimmt der MCP-Server auch einen API-Schlüssel als Header an. Den Schlüssel legen Sie in der App unter Einstellungen › API und Integrationen an. Er beginnt mit agile_ks_ und arbeitet mit den Rechten, die Sie ihm dort geben.

Authorization: Bearer agile_ks_…

Für Claude Code sieht das so aus:

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

Behandeln Sie den Schlüssel wie ein Passwort: nicht in Repositories einchecken, bei Verdacht sofort widerrufen.

Beispiele

Was Sie Ihren Assistenten fragen können

  • „Fasse alle offenen Gespräche von heute zusammen und schreib Antwortentwürfe für die drei ältesten.“
  • „Welche Fragen konnte die KI diese Woche nicht beantworten? Schreib zu den wichtigsten einen Artikelentwurf.“
  • „Wie haben sich erste Antwortzeit und Zufriedenheit im letzten Monat entwickelt?“
  • „Weise alle offenen Gespräche zum Thema Rückgabe Jonas zu und setze das Schlagwort Rückgabe.“
  • „Was würde unsere KI auf die Frage nach Lieferzeiten in die Schweiz antworten, und mit welcher Quelle?“

Rechte bei der Zustimmung: Sie wählen Nur lesen (Gespräche, Kontakte, Artikel und Kennzahlen ansehen) oder Lesen und schreiben (zusätzlich antworten, Notizen schreiben, zuweisen, Artikel und Wissen pflegen).

Ihre Rolle gilt weiter: Was Sie als Agent nicht dürfen, darf auch der Assistent nicht. Werkzeuge mit „Admin“ brauchen die Rolle Admin oder Inhaber. Der Zugang gilt für genau einen Arbeitsbereich.

Werkzeuge

Alle 32 Werkzeuge des MCP-Servers

Werkzeuge mit der Marke „schreibt“ brauchen das Recht Lesen und schreiben. „Löscht endgültig“ lässt sich nicht rückgängig machen.

Suchen

search
Durchsucht Gespräche, Kontakte und Help-Center-Artikel.
fetch
Lädt den vollständigen Inhalt eines Suchtreffers.

Gespräche

list_conversations
Listet Gespräche nach Ansicht und Status.
get_conversation
Lädt ein Gespräch mit Nachrichten, Notizen und Kontakt.
reply_to_conversationschreibt
Sendet eine Antwort an den Kunden.
add_noteschreibt
Schreibt eine interne Notiz, auf Wunsch mit Erwähnungen.
update_conversationschreibt
Ändert Status, Wiedervorlage, Zuweisung oder Priorität.
tag_conversationschreibt
Fügt ein Schlagwort hinzu.
suggest_reply
Lässt die KI einen Antwortentwurf schreiben (wird nicht gesendet).
summarize_conversationschreibt
Fasst ein Gespräch zusammen und speichert die Zusammenfassung.

Kontakte

list_contacts
Listet Kontakte nach Segment.
get_contact
Lädt einen Kontakt mit Attributen, Seiten und Gesprächen.
update_contactschreibt
Ändert Name, E-Mail, Telefon, Unternehmen oder Attribute.
export_contact
Exportiert alle Daten eines Kontakts (DSGVO Art. 15 und 20). Admin.
delete_contactlöscht endgültig
Löscht einen Kontakt endgültig (DSGVO Art. 17). Admin.

Help Center

list_articles
Listet Artikel, Entwürfe und veröffentlichte.
get_article
Lädt einen Artikel mit Inhalt.
create_articleschreibt
Legt einen Artikel an. Veröffentlichte lernt die KI sofort.
update_articleschreibt
Ändert Titel, Inhalt, Thema oder Status.
delete_articlelöscht endgültig
Löscht einen Artikel endgültig. Admin.
list_collections
Listet die Themen des Help Centers.

Wissen der KI

list_knowledge_sources
Listet Websites, Dateien und Texte mit Status.
add_knowledge_websiteschreibt
Lässt die KI eine Website einlesen. Admin.
add_knowledge_textschreibt
Fügt einen Text zur Wissensbasis hinzu. Admin.
ask_knowledge
Fragt den KI-Agenten wie ein Besucher, mit Quellen und Konfidenz.
list_knowledge_gaps
Fragen, die die KI nicht beantworten konnte.

Arbeitsbereich

get_metrics
Kennzahlen eines Zeitraums.
list_team
Teammitglieder und offene Einladungen.
list_tags
Alle Schlagworte.
list_macros
Gespeicherte Antworten.
get_workspace
Einstellungen des Arbeitsbereichs.
update_workspace_settingsschreibt
Ändert Einstellungen wie Begrüßung oder KI an und aus. Admin.

Fehlerbehebung

Wenn es hakt

Ihre Frage ist nicht dabei? Schreiben Sie uns über agiledeveloper.de.

„Verbindung fehlgeschlagen“ oder die Anmeldung öffnet sich nicht

Prüfen Sie die Adresse: genau https://kundensupport.agiledeveloper.de/mcp, ohne Leerzeichen und ohne Zusatz. Erlauben Sie Pop-ups für claude.ai bzw. chatgpt.com, damit sich das Anmeldefenster öffnen kann, und versuchen Sie es erneut.

Ich sehe den falschen Arbeitsbereich

Ein Zugang gilt für genau einen Arbeitsbereich. Trennen Sie die App unter Einstellungen › API und Integrationen › Verbundene Apps und verbinden Sie neu; bei der Anmeldung wählen Sie den richtigen Arbeitsbereich.

Der Assistent darf nichts ändern

Dann wurde bei der Zustimmung „Nur lesen“ gewählt. Trennen und neu verbinden, diesmal „Lesen und schreiben“. Auch Ihre Rolle zählt: Werkzeuge mit „Admin“ brauchen die Rolle Admin oder Inhaber.

Nach einiger Zeit fragt der Assistent erneut nach der Anmeldung

Der Zugang verlängert sich bei Nutzung von selbst. Er endet, wenn er 60 Tage nicht benutzt wurde oder wenn Sie ihn trennen. Dann einfach neu verbinden.

ChatGPT zeigt keinen Entwicklermodus

Den gibt es nicht in jedem ChatGPT-Plan, und in Firmenkonten schaltet ihn die Verwaltung frei. Siehe die Hilfe von OpenAI. Claude oder Claude Code funktionieren unabhängig davon.

Claude Code meldet „needs authentication“

Das ist richtig so: Geben Sie /mcp ein, wählen Sie agile-kundensupport und dann Authenticate. Ohne Browser verwenden Sie den API-Schlüssel als Header.

Trennen

Verbindung beenden

In der App unter Einstellungen › API und Integrationen › Verbundene Apps auf Trennen. Das wirkt sofort, der Assistent kommt danach nicht mehr an Ihre Daten. Zusätzlich können Sie den Konnektor in Claude oder ChatGPT entfernen.

Zur AppAPI-Doku

Für Entwickler

Technische Angaben

  • Transport Streamable HTTP, POST https://kundensupport.agiledeveloper.de/mcp (JSON-RPC).
  • Anmeldung OAuth 2.1 mit PKCE und dynamischer Client-Registrierung, Scopes read und write.
  • Access-Tokens gelten eine Stunde, Refresh-Tokens 60 Tage.
  • Alternativ API-Schlüssel als Authorization: Bearer agile_ks_….
  • REST-API v1 mit OpenAPI-Beschreibung unter /docs.