McpConnect · Anleitung · Deutsch | English | Français | Italiano

Claude mit FreeScout verbinden

Zwei Wege, Schritt für Schritt erklärt – auch ohne technische Vorkenntnisse

Mit McpConnect arbeitet Claude, der KI-Assistent von Anthropic, mit Deinem FreeScout zusammen. Dafür gibt es zwei Wege. Sie schliessen sich nicht aus, viele Teams nutzen beide. Diese Anleitung erklärt zuerst den Unterschied und dann jeden Weg einzeln.

Zwei Wege im Überblick

Weg 1 – Claude als persönlicher Assistent

Du arbeitest wie gewohnt in Claude Desktop oder auf claude.ai und verbindest Claude dort mit FreeScout. Danach fragst Du Claude im Chat, zum Beispiel:

Claude arbeitet nur, wenn Du es fragst, und zwar in Deinem Namen mit Deinen FreeScout-Rechten. Jede Person verbindet ihr eigenes Claude.

Weg 2 – Claude als Agent in FreeScout

FreeScout bekommt einen eigenen KI-Kollegen, zum Beispiel «James». Er arbeitet selbständig im Hintergrund: Er liest jede neue Kundennachricht, fasst sie in einer Notiz zusammen, bereitet Antworten vor, weist Tickets nach Euren Regeln zu und kann – wenn Ihr es erlaubt – sichere Antworten selbst senden, auch im Live-Chat. Dazu erledigt er Aufträge Deines Teams im Menü «KI».

Der Agent arbeitet unter einem eigenen FreeScout-Benutzer und verbindet sich über die Programmierschnittstelle (API) von Anthropic. Ein Administrator richtet ihn einmal für alle ein.

Vergleich auf einen Blick

Weg 1: Persönlicher AssistentWeg 2: Agent in FreeScout
Wo arbeitest Du?in Claude Desktop oder auf claude.aiin FreeScout
Wann arbeitet Claude?nur auf Deine Frage hinrund um die Uhr, bei jeder neuen Nachricht und auf Auftrag
In wessen Namen?in Deinem, mit Deinen Rechtenals eigener Benutzer, z. B. «James»
Wer richtet ein?jede Person selbst (nach einer kurzen Vorbereitung durch den Administrator)einmal ein Administrator
Was braucht es?ein Claude-Konto (Free, Pro, Max, Team oder Enterprise)ein Konto auf der Claude-Plattform von Anthropic mit Guthaben und einen API-Schlüssel
Kostenim Claude-Abo enthaltennach Verbrauch, direkt bei Anthropic; typischerweise einige Rappen pro Durchlauf
Kann Kunden selbst antworten?nein – nur Entwürfe, die Du sendestja, wenn Ihr es erlaubt: nur geprüfte Antworten aus Euren Quellen, mit Verzögerung zum Stoppen
Live-Chatneinja
Einrichtungetwa 5 Minuten pro Personetwa 30 Minuten, dazu einige Tage Probebetrieb

Vor- und Nachteile

Weg 1 – Persönlicher Assistent

Weg 2 – Agent in FreeScout

Welcher Weg passt zu Euch?

Weg 1 passt, wenn Ihr ein kleines Team seid, jede Person ohnehin ein Claude-Abo hat und Ihr keine automatischen Abläufe wollt. Claude hilft dann auf Zuruf, und jede Person behält selbst die Kontrolle.

Weg 2 passt, wenn nicht jede Person ein Claude-Abo hat oder die Automatisierung im Vordergrund steht: Neue Anfragen sollen von selbst eingeordnet, vorbereitet oder beantwortet werden, auch im Live-Chat. Dafür braucht es nur ein einziges Konto bei Anthropic für die ganze Firma, und alle im Team profitieren – auch ohne eigenes Claude-Abo: über eine Notiz an den Agenten und, wenn Ihr es für alle freigebt, über das Menü «KI».

💡 Tipp

Beide Wege lassen sich auch kombinieren: der Agent für die Routine im Hintergrund, Claude Desktop für einzelne Personen, die zusätzlich Auswertungen und Entwürfe auf Zuruf wollen.

So ist diese Anleitung aufgebaut

TeilFür welchen Weg?Wer macht das?
Teil A – FreeScout vorbereitenbeideAdministrator, einmal
Teil B – Weg 1: Claude Desktop und claude.aiWeg 1Administrator (B1), dann jede Person
Teil C – Weg 2: Claude als AgentWeg 2Administrator
Teil D – Verbindungen prüfen oder beendenbeidejede Person bzw. Administrator
Teil E – Wenn etwas nicht klapptbeidealle

Bist Du nicht Administrator und willst nur Weg 1 nutzen? Dann frag Deine Administratorin oder Deinen Administrator, ob Teil A und Schritt B1 erledigt sind, lass Dir die Adresse des MCP-Servers geben und beginne bei B2.

Ein paar Begriffe vorab

Du musst diese Begriffe nicht kennen, um die Anleitung zu befolgen. Sie helfen aber, wenn sie Dir unterwegs begegnen.

BegriffBedeutung
ConnectorWeg 1: eine Verbindung zwischen Claude und einem anderen Programm, hier FreeScout. In Claude heisst das Menü «Connectors».
MCP-ServerDie Stelle in Deinem FreeScout, mit der Claude spricht. Ihre Internetadresse endet auf /mcp.
ZustimmungsdialogWeg 1: die Seite in FreeScout, auf der Du festlegst, was Claude darf.
API-SchlüsselWeg 2: ein langes Passwort, mit dem FreeScout Claude im Auftrag Deiner Firma nutzt. Es kostet Guthaben bei Anthropic.
DienstkontoWeg 2: der FreeScout-Benutzer, unter dem der Agent arbeitet, z. B. «James».
Dienst-ClientWeg 2: legt fest, was der Agent darf: Berechtigungen, Postfächer, erlaubte Adressen.
ProbebetriebWeg 2: Der Agent arbeitet zur Probe, schreibt aber nichts. Du siehst, was er getan hätte.
Widerrufeneine Verbindung beenden. Claude hat danach sofort keinen Zugriff mehr.

Teil A – FreeScout vorbereiten (beide Wege)

Diesen Teil erledigt einmal jemand mit Administratorrechten in FreeScout.

⚠️ Wichtig

Dein FreeScout muss aus dem Internet erreichbar sein, und zwar über eine Adresse mit https://. Bei beiden Wegen arbeitet Claude auf den Servern von Anthropic und verbindet sich von dort mit Deinem FreeScout. Läuft FreeScout nur im Firmennetz oder hinter einem VPN, klappt die Verbindung nicht.

A1 – Den Bereich «KI-Verbindungen» öffnen

  1. Melde Dich in FreeScout als Administrator an.
  2. Klicke oben in der blauen Leiste auf Verwalten.
  3. Klicke in der Liste auf KI-Verbindungen.
Im Menü «Verwalten» findest Du den Eintrag «KI-Verbindungen». Die übrigen Einträge können bei Dir anders aussehen – je nachdem, welche Module installiert sind.
Bild 1 Im Menü «Verwalten» findest Du den Eintrag «KI-Verbindungen». Die übrigen Einträge können bei Dir anders aussehen – je nachdem, welche Module installiert sind.

Links erscheint jetzt eine Spalte mit den Bereichen von McpConnect: Clients, Verbindungen, Rechte, Agent, Wissen und weitere.

A2 – Die Selbstprüfung laufen lassen

Die Selbstprüfung kontrolliert, ob Dein FreeScout bereit ist, zum Beispiel ob HTTPS eingerichtet ist und ob die Anmeldung richtig weitergeleitet wird.

  1. Klicke links auf Selbstprüfung.
  2. Klicke auf Jetzt prüfen.
  3. Warte einige Sekunden, bis die Liste erscheint.
Die Selbstprüfung startest Du mit «Jetzt prüfen».
Bild 2 Die Selbstprüfung startest Du mit «Jetzt prüfen».

So liest Du das Ergebnis:

FarbeBedeutungWas tun?
🟢 grünin Ordnungnichts
🟡 gelbfunktioniert, aber nicht idealHinweis lesen; die Verbindung klappt meist trotzdem
🔴 rotso klappt die Verbindung nichtzuerst beheben – die Zeile sagt, wie
⚪ grauliess sich von innen nicht prüfenkein Fehler, aber auch keine Bestätigung
💡 Tipp

Steht bei metadata rot, liegt es fast immer an einer fehlenden Zeile in der Datei .htaccess Deines FreeScout. Die Selbstprüfung zeigt die Zeile an. Gib sie Deinem Hoster oder Deiner IT, falls Du selbst keinen Zugriff auf die Dateien hast. Für Weg 2 muss zudem die Zeile Cron grün sein: Der Agent wird von FreeScouts Zeitplaner angestossen.

A3 – (Freiwillig) Die Rechte prüfen

Unter Rechte siehst Du, was eine KI in Deinem FreeScout höchstens darf. Das gilt für beide Wege, unabhängig davon, was jemand später ankreuzt. Ab Werk gilt:

Für den Anfang musst Du hier nichts ändern. ✅

Teil B – Weg 1: Claude Desktop und claude.ai

Was Du für Weg 1 brauchst

B1 – Claude zulassen und die Adresse weitergeben (Administrator, einmal)

Claude zulassen:

  1. Klicke unter Verwalten → KI-Verbindungen links auf Einstellungen.
  2. Suche das Feld Client-ID-Metadaten-Dokumente und schreibe hinein: claude.ai
  3. Prüfe gleich darüber, bei Wer KI-Clients verbinden darf, ob die richtigen Rollen angehakt sind: «Benutzer», «Administratoren» oder beide.
  4. Scrolle ganz nach unten und klicke auf Speichern.
In das Feld «Client-ID-Metadaten-Dokumente» kommt «claude.ai». Darüber legst Du fest, wer überhaupt verbinden darf.
Bild 3 In das Feld «Client-ID-Metadaten-Dokumente» kommt «claude.ai». Darüber legst Du fest, wer überhaupt verbinden darf.
ℹ️ Gut zu wissen

Mit diesem Eintrag erkennt FreeScout Claude an seiner veröffentlichten Identität. Im Zustimmungsdialog steht später «Identität bestätigt durch claude.ai». So weiss jede Person, dass wirklich Claude anfragt und nicht ein fremdes Programm.

Die Adresse weitergeben:

  1. Klicke links auf Clients.
  2. Ganz oben steht Adresse des MCP-Servers für den Client mit einer Adresse, die auf /mcp endet.
  3. Markiere die Adresse und kopiere sie (Mac: ⌘ + C, Windows: Strg + C).
  4. Gib sie allen Personen weiter, die Claude verbinden wollen, zum Beispiel per E-Mail.
Die Adresse des MCP-Servers steht oben auf der Seite «Clients».
Bild 4 Die Adresse des MCP-Servers steht oben auf der Seite «Clients».

B2 – Den Connector in Claude anlegen (Free, Pro, Max)

Hast Du ein Team- oder Enterprise-Konto Deiner Firma? Dann weiter mit B3.

ℹ️ Gut zu wissen

Die Bezeichnungen unten stammen aus der deutschen Oberfläche von claude.ai. Ist Dein Claude auf Englisch eingestellt, heissen die Stellen «Customize → Connectors → Add → Add custom connector», «Continue», «Use Claude's published identity» und «Connect».

  1. Öffne im Browser claude.ai und melde Dich an.
  2. Klicke links auf Anpassungen und oben auf den Reiter Konnektoren.
Unter «Anpassungen» findest Du den Reiter «Konnektoren».
Bild 5 Unter «Anpassungen» findest Du den Reiter «Konnektoren».
  1. Klicke rechts auf Hinzufügen und dann auf Benutzerdefinierten Connector hinzufügen.
«Hinzufügen» öffnet ein kleines Menü mit «Benutzerdefinierten Connector hinzufügen».
Bild 6 «Hinzufügen» öffnet ein kleines Menü mit «Benutzerdefinierten Connector hinzufügen».
  1. Fülle das Fenster aus:
    • Name: zum Beispiel FreeScout. Diesen Namen siehst Du später in Claude.
    • MCP-Server-URL: die Adresse aus B1, zum Beispiel https://support.deine-firma.ch/mcp. Achte darauf, dass sie mit https:// beginnt und mit /mcp endet, ohne Leerzeichen.
  2. Klicke auf Weiter.
Name und Adresse eintragen, dann «Weiter».
Bild 7 Name und Adresse eintragen, dann «Weiter».
  1. Claude prüft die Adresse und zeigt die Anmeldeeinstellungen. Sie sind bereits richtig vorausgewählt:
    • bei Authentifizierung: Jetzt anmelden – mit dem Hinweis «Erkannt»
    • bei OAuth-Client: Claudes veröffentlichte Identität verwenden – mit dem Hinweis «Empfohlen»
  2. Ändere nichts und klicke auf Hinzufügen.
  3. Claude zeigt jetzt die Seite des neuen Connectors mit dem Hinweis «Du bist noch nicht mit FreeScout verbunden». Klicke dort auf Verbinden.
Die Anmeldeeinstellungen erkennt Claude selbst. «Jetzt anmelden» und «Claudes veröffentlichte Identität verwenden» sind richtig – einfach «Hinzufügen».
Bild 8 Die Anmeldeeinstellungen erkennt Claude selbst. «Jetzt anmelden» und «Claudes veröffentlichte Identität verwenden» sind richtig – einfach «Hinzufügen».
⚠️ Wichtig

Wähle nicht «Automatisch registrieren» und nicht «Eigenen OAuth-Client verwenden», ausser Deine Administratorin oder Dein Administrator sagt es ausdrücklich. Diese beiden Wege brauchen eine zusätzliche Einrichtung in FreeScout. Erscheint bei «Authentifizierung» nicht «Erkannt», ist die Adresse falsch oder FreeScout nicht erreichbar – siehe Teil E.

Weiter mit B4.

B3 – Den Connector verbinden (Team, Enterprise)

Bei Team- und Enterprise-Konten legt eine Person mit Inhaberrechten (Owner) den Connector einmal für die ganze Organisation an:

  1. Owner: In den Organisationseinstellungen den Bereich Konnektoren öffnen → Hinzufügen → Benutzerdefiniert → Web wählen.
  2. Owner: Name FreeScout und die Adresse aus B1 eintragen → Weiter → die vorausgewählten Anmeldeeinstellungen lassen («Claudes veröffentlichte Identität verwenden») → Hinzufügen.

Danach verbindet sich jede Person selbst:

  1. Öffne Anpassungen → Konnektoren.
  2. Suche FreeScout in der Liste. Meist trägt der Eintrag die Markierung «Benutzerdefiniert».
  3. Klicke auf Verbinden.

B4 – In FreeScout anmelden

Nach dem Klick öffnet Claude ein neues Fenster oder einen neuen Tab mit Deinem FreeScout.

Die gewohnte Anmeldeseite Deines FreeScout. Hier gehören Deine FreeScout-Zugangsdaten hin – nicht die von Claude.
Bild 9 Die gewohnte Anmeldeseite Deines FreeScout. Hier gehören Deine FreeScout-Zugangsdaten hin – nicht die von Claude.
💡 Tipp

Öffnet sich kein Fenster, hat der Browser es vielleicht blockiert. Achte auf einen Hinweis in der Adresszeile («Pop-up blockiert») und erlaube Pop-ups für claude.ai.

B5 – Im Zustimmungsdialog festlegen, was Claude darf

Jetzt kommt der wichtigste Schritt. FreeScout zeigt die Seite «Darf Claude auf FreeScout zugreifen?». Hier entscheidest Du, was Claude darf. Nimm Dir einen Moment Zeit.

Der Zustimmungsdialog. Ganz oben steht, wer anfragt und wie Du angemeldet bist. Ganz unten erlaubst Du den Zugriff.
Bild 10 Der Zustimmungsdialog. Ganz oben steht, wer anfragt und wie Du angemeldet bist. Ganz unten erlaubst Du den Zugriff.

Gehe die Seite von oben nach unten durch:

1. Die Kopfzeile prüfen. Dort steht «Identität bestätigt durch claude.ai» und «Rückkehr zu: claude.ai». Steht dort etwas anderes, oder hast Du die Verbindung gar nicht selbst gestartet? Dann klicke auf Abbrechen.

2. Berechtigungen ankreuzen.

💡 Tipp

Für den Anfang reichen die vorausgewählten Leserechte und, wenn Du Entwürfe möchtest, «Antwortentwürfe anlegen». Mehr kannst Du später erlauben, indem Du Claude neu verbindest (siehe D3).

3. Postfächer wählen. Ab Werk gilt «Alle Postfächer, die ich sehe, auch künftige». Willst Du Claude nur einzelne Postfächer zeigen, wähle «Nur diese Postfächer:» und kreuze sie an.

4. Personendaten. Ist «Pseudonymisieren» angehakt, sieht Claude statt echter Namen, Adressen, Telefonnummern und E-Mail-Adressen nur Platzhalter wie «Vorname.1». Lass das Häkchen gesetzt, wenn Du unsicher bist. Hat Deine Administratorin oder Dein Administrator die Pseudonymisierung fest eingeschaltet, kannst Du sie hier nicht abwählen.

5. Erlaubte IP-Adressen – leer lassen. Dieses Feld ist für Sonderfälle gedacht.

⚠️ Wichtig

Trage bei «Erlaubte IP-Adressen» nicht Deine eigene Adresse ein. Claude greift nicht von Deinem Computer zu, sondern von den Servern von Anthropic. Mit Deiner eigenen Adresse würde FreeScout Claude aussperren.

6. Zugriff erlauben. Klicke ganz unten auf Zugriff erlauben. Das Fenster schliesst sich oder springt zurück zu Claude.

B6 – Prüfen, ob es geklappt hat

  1. Claude meldet kurz «Mit FreeScout verbunden». Auf der Seite des Connectors steht oben rechts jetzt Trennen statt «Verbinden», darunter die Liste der Werkzeuge, die Claude in FreeScout nutzen darf.
  2. Du bekommst von FreeScout eine E-Mail mit dem Betreff «Neue KI-Verbindung zu Ihrem FreeScout-Konto». Das ist normal und eine Sicherheitsmassnahme: Hast Du die Verbindung nicht selbst hergestellt, widerrufe sie sofort (siehe Teil D).
Verbunden: oben «Trennen», darunter die «Tool-Berechtigungen». Ab Werk steht alles auf «Genehmigung erforderlich» – Claude fragt also vor jedem Schritt.
Bild 11 Verbunden: oben «Trennen», darunter die «Tool-Berechtigungen». Ab Werk steht alles auf «Genehmigung erforderlich» – Claude fragt also vor jedem Schritt.

Die Tool-Berechtigungen. Für jedes Werkzeug gibt es rechts drei kleine Symbole: das Häkchen für Immer erlauben, die Hand für Genehmigung erforderlich und den durchgestrichenen Kreis für Blockiert. Mit dem Auswahlfeld neben einer Gruppe, etwa «Schreibgeschützte Tools» (das sind die lesenden), stellst Du alle Werkzeuge der Gruppe auf einmal um. Für den Anfang lässt Du alles, wie es ist.

ℹ️ Gut zu wissen

Diese Einstellung gilt nur in Claude. Was Claude in FreeScout überhaupt darf, hast Du in B5 im Zustimmungsdialog festgelegt. Ein Werkzeug, das Du dort nicht erlaubt hast, taucht in dieser Liste gar nicht auf.

B7 – Claude im Alltag nutzen

FreeScout im Chat einschalten:

  1. Starte in Claude einen neuen Chat.
  2. Klicke unten links im Eingabefeld auf +.
  3. Fahre mit der Maus auf Konnektoren. Daneben öffnet sich eine Liste.
  4. Schalte dort FreeScout ein (der Schalter wird blau).
«+» → «Konnektoren» → Schalter bei «FreeScout». Ist er blau, kann Claude in diesem Chat auf FreeScout zugreifen.
Bild 12 «+» → «Konnektoren» → Schalter bei «FreeScout». Ist er blau, kann Claude in diesem Chat auf FreeScout zugreifen.

Fragen stellen. Schreib ganz normal, zum Beispiel:

Claude fragt um Erlaubnis. Bevor Claude etwas in FreeScout nachschlägt oder schreibt, fragt es Dich, zum Beispiel «Claude möchte List mailboxes von FreeScout verwenden». Die Namen der Werkzeuge sind englisch: «List mailboxes» heisst Postfächer auflisten, «Search conversations» Konversationen suchen, «Create reply draft» Antwortentwurf anlegen. Darunter stehen drei Knöpfe:

💡 Tipp

Erlaube lesende Aktionen ruhig dauerhaft. Bei schreibenden Aktionen wie Notizen oder Entwürfen ist «einmal erlauben» am Anfang die bessere Wahl. So siehst Du jedes Mal, was Claude tun will.

Die Rückfrage vor einem Werkzeug von FreeScout.
Bild 13 Die Rückfrage vor einem Werkzeug von FreeScout.

Nach der Erlaubnis holt Claude die Angaben aus FreeScout und antwortet im Chat. Mit einem Klick auf die graue Zeile über der Antwort siehst Du, welche Werkzeuge Claude dafür verwendet hat.

Claude antwortet mit den Angaben aus FreeScout. Die E-Mail-Adressen sind im Bild unkenntlich gemacht.
Bild 14 Claude antwortet mit den Angaben aus FreeScout. Die E-Mail-Adressen sind im Bild unkenntlich gemacht.

Was Claude auf diesem Weg nicht kann:

Claude Desktop. Nutzt Du die App Claude Desktop auf Mac oder Windows, musst Du nichts zusätzlich einrichten. Die App verwendet dasselbe Claude-Konto, der Connector «FreeScout» steht dort automatisch bereit. Schalte ihn im Chat wie oben ein.

Fertig mit Weg 1! ✅

Teil C – Weg 2: Claude als Agent in FreeScout

Diesen Teil erledigt ein Administrator. Plane etwa 30 Minuten ein und danach einige Tage Probebetrieb.

Was Du für Weg 2 brauchst

C1 – Einen API-Schlüssel bei Anthropic erstellen

Über den API-Schlüssel nutzt FreeScout Claude und bezahlt dafür aus Eurem Guthaben bei Anthropic. Mit einem eigenen Workspace samt Ausgabenlimit stellst Du sicher, dass der Agent nie mehr ausgibt als vorgesehen.

ℹ️ Gut zu wissen

Die Bezeichnungen unten stammen aus der deutschen Oberfläche der Claude-Plattform («Claude Console»). Ist sie auf Englisch eingestellt, heissen die Stellen «Billing», «Workspaces», «Spend limits», «API keys» und «Create key». Die Einstellungen erreichst Du über das Zahnrad links oder über Deinen Namen unten links.

  1. Öffne platform.claude.com und melde Dich an. Hast Du noch kein Konto, erstelle eines (Firma, Name, E-Mail).

Guthaben

  1. Öffne in den Einstellungen unter Organisationseinstellungen den Punkt Abrechnung.
  2. Unter Guthaben siehst Du, wie viel Geld auf dem Konto ist. Ist es leer, klicke auf Credits kaufen und kaufe zum Beispiel 20 USD. Mit Automatisches Aufladen verwalten kannst Du festlegen, dass das Guthaben von selbst nachgeladen wird, wenn es knapp wird. So bleibt der Agent nicht plötzlich stehen.
«Abrechnung»: links das Guthaben, daneben «Credits kaufen» und «Automatisches Aufladen verwalten». Beträge sind im Bild unkenntlich gemacht.
Bild 15 «Abrechnung»: links das Guthaben, daneben «Credits kaufen» und «Automatisches Aufladen verwalten». Beträge sind im Bild unkenntlich gemacht.
💡 Tipp

Habt Ihr ein Team- oder Max-Abo von Claude, ist darin monatlich API-Guthaben enthalten. Ein Hinweis oben auf der Seite «Abrechnung» zeigt das an. Dann musst Du für den Anfang oft gar nichts kaufen.

Workspace mit Ausgabenlimit

  1. Öffne unter Organisationseinstellungen den Punkt Arbeitsbereiche und klicke auf Workspace erstellen. Nenne ihn zum Beispiel FreeScout und bestätige.
  2. Klicke in der Liste auf den neuen Workspace. Rechts öffnet sich eine Übersicht.
  3. Klicke dort auf Ausgabenlimits und setze ein monatliches Limit, zum Beispiel 30 USD. Ist es erreicht, stoppt Anthropic die Anfragen bis zum nächsten Monat.
Die Übersicht des Workspace. Unter «Ausgabenlimits» siehst Du, wie viel diesen Monat verbraucht ist und wo das Limit liegt (Beispielwerte).
Bild 16 Die Übersicht des Workspace. Unter «Ausgabenlimits» siehst Du, wie viel diesen Monat verbraucht ist und wo das Limit liegt (Beispielwerte).

Schlüssel erstellen

  1. Öffne unter Organisationseinstellungen den Punkt API-Schlüssel und klicke auf Schlüssel erstellen.
  2. Zuerst erscheint ein Fenster «Mit Identitätsföderation brauchst du keinen API-Schlüssel». Das ist für grosse IT-Umgebungen gedacht und passt nicht zu FreeScout. Klicke unten auf Mit einem API-Schlüssel fortfahren.
Dieses Fenster überspringst Du mit «Mit einem API-Schlüssel fortfahren».
Bild 17 Dieses Fenster überspringst Du mit «Mit einem API-Schlüssel fortfahren».
  1. Fülle das Fenster «API-Schlüssel erstellen» aus:
    • Name: zum Beispiel FreeScout Agent.
    • Läuft ab: Wähle Nie. Ab Werk steht hier «30 Tage» – dann hört der Agent nach einem Monat ohne Vorwarnung auf zu arbeiten. Die gelbe Warnung, die bei «Nie» erscheint, ist richtig: Darum bewahrst Du den Schlüssel sorgfältig auf (Schritt 11).
    • Verknüpftes Konto: Lass Deinen eigenen Namen stehen. Beachte den Hinweis darunter: Verlässt Du die Firma und wird Dein Zugang auf der Plattform entfernt, wird auch der Schlüssel deaktiviert. Dann braucht es einen neuen Schlüssel.
    • Geltungsbereich: Wähle den Workspace aus Schritt 4, also FreeScout. Dann gilt das Ausgabenlimit auch für diesen Schlüssel.
  2. Klicke auf Schlüssel erstellen.
Wichtig sind «Läuft ab: Nie» und der richtige «Geltungsbereich».
Bild 18 Wichtig sind «Läuft ab: Nie» und der richtige «Geltungsbereich».
  1. Kopiere den Schlüssel sofort. Er beginnt mit sk-ant- und wird nur dieses eine Mal angezeigt. Bewahre ihn bis Schritt C4 sicher auf, zum Beispiel in Deinem Passwortmanager – nicht in einer E-Mail und nicht in einem Chat.
⚠️ Wichtig

Der API-Schlüssel ist wie ein Passwort zu Eurem Guthaben. Gib ihn niemandem weiter. In FreeScout wird er verschlüsselt gespeichert und nie wieder angezeigt. Hast Du ihn verloren, lösche ihn auf der Plattform und erstelle einen neuen.

C2 – Ein Dienstkonto für den Agenten anlegen

Der Agent arbeitet als eigener FreeScout-Benutzer. Sein Name steht an jeder Notiz und jedem Entwurf, die er schreibt.

  1. Klicke in FreeScout auf Verwalten → Benutzer und dann auf Neuer Benutzer.
  2. Fülle aus:
    • Rolle: Benutzer (nicht Administrator)
    • Vorname: der Name des Agenten, zum Beispiel James
    • Nachname: zum Beispiel KI, damit alle sehen, dass hier eine KI schreibt
    • E-Mail: die Adresse für den Agenten, zum Beispiel james@deine-firma.ch
    • Postfächer: nur die, die der Agent bearbeiten soll
  3. Entferne das Häkchen bei Einladungs-E-Mail senden. Der Agent meldet sich nie selbst an.
  4. Klicke auf Benutzer erstellen.
Ein eigener Benutzer für den Agenten, mit der Rolle «Benutzer» und nur den Postfächern, die er bearbeiten soll.
Bild 19 Ein eigener Benutzer für den Agenten, mit der Rolle «Benutzer» und nur den Postfächern, die er bearbeiten soll.
💡 Tipp

Gib dem Dienstkonto ein Profilbild. Es erscheint im Menü «KI» neben jeder Antwort des Agenten. Und schalte in seinem Profil unter Benachrichtigungen alle E-Mail-Benachrichtigungen aus, sonst verschickt FreeScout Mails an eine Adresse, die niemand liest.

C3 – Den Dienst-Client anlegen

Der Dienst-Client legt fest, was der Agent darf.

  1. Klicke unter Verwalten → KI-Verbindungen links auf Agent.
  2. Scrolle zu Dienst-Clients und klicke auf Neuer Dienst-Client.
  3. Fülle das Fenster aus:
    • Name: zum Beispiel James
    • Dienstkonto: den Benutzer aus C2
    • Berechtigungen: Vorausgewählt ist, was der Agent für den Anfang braucht: lesen, Notizen, Entwürfe, Status und Spam vorschlagen. Lass es für den Start so. Weitere Rechte, etwa «Fragen in eigenen Worten beantworten» oder die Rechte anderer Module, kannst Du später ergänzen.
    • Postfächer: «Alle, die das Dienstkonto sieht» – die Auswahl hast Du schon in C2 getroffen.
    • Erlaubte IP-Adressen: so lassen. Vorbelegt sind die Adressen, von denen Claude bei Anthropic arbeitet.
    • Personendaten: «Pseudonymisieren» angehakt lassen.
  4. Klicke auf Dienst-Client anlegen.
Der Dienst-Client legt fest, was der Agent darf. Die Vorauswahl passt für den Start.
Bild 20 Der Dienst-Client legt fest, was der Agent darf. Die Vorauswahl passt für den Start.

Der neue Dienst-Client erscheint in der Liste.

Der Dienst-Client in der Liste. «Neues Geheimnis» brauchst Du für den Agenten in FreeScout nicht.
Bild 21 Der Dienst-Client in der Liste. «Neues Geheimnis» brauchst Du für den Agenten in FreeScout nicht.

C4 – Den Agenten einrichten und im Probebetrieb starten

Oben auf derselben Seite, im Abschnitt Läufer:

  1. Kreuze Jede neue Kundennachricht bearbeiten an.
  2. Kreuze Probebetrieb an. Wichtig für den Anfang: Der Agent arbeitet dann zur Probe, schreibt aber nichts in FreeScout.
  3. Wähle bei Dienst-Client den Client aus C3.
  4. Füge bei Anthropic-API-Schlüssel den Schlüssel aus C1 ein (Mac: ⌘ + V, Windows: Strg + V).
Läufer einschalten, mit Probebetrieb, Dienst-Client wählen und den API-Schlüssel einfügen.
Bild 22 Läufer einschalten, mit Probebetrieb, Dienst-Client wählen und den API-Schlüssel einfügen.

C5 – Modell, Anrede und Hausregeln

Gleich darunter:

Modell, Anrede und Hausregeln. Hausregeln sind einfache Sätze – Du musst nichts programmieren.
Bild 23 Modell, Anrede und Hausregeln. Hausregeln sind einfache Sätze – Du musst nichts programmieren.

C6 – Grenzen setzen und speichern

Unter Grenzen legst Du fest, wie viel der Agent höchstens arbeitet und ausgibt:

Die Grenzen für Durchläufe und Kosten. Das Tagesbudget ist die wichtigste.
Bild 24 Die Grenzen für Durchläufe und Kosten. Das Tagesbudget ist die wichtigste.

Klicke anschliessend unten auf Speichern. ✅

C7 – Den Probebetrieb beobachten

Lass den Agenten einige Tage zur Probe laufen. Bei jeder neuen Kundennachricht entscheidet er, was er tun würde, schreibt aber nichts.

  1. Öffne Verwalten → KI-Verbindungen → Protokoll und dort den Reiter Durchläufe des Agenten.
  2. Dort siehst Du zu jeder Nachricht, was der Agent getan hätte: den vollen Text von Notiz und Entwurf, die Zuweisung und die Kosten.
  3. Passt etwas nicht, ergänze die Hausregeln (C5).
  4. Bist Du zufrieden, entferne in C4 das Häkchen bei Probebetrieb und speichere. Ab jetzt arbeitet der Agent wirklich.

C8 – Der Notaus

Ganz oben auf der Seite Agent steht der Notaus. Ein Klick auf Agent stoppen hält den Agenten sofort an, alle seine Zugänge werden gesperrt. Mit Agent freigeben läuft er wieder.

Der Notaus stoppt den Agenten sofort.
Bild 25 Der Notaus stoppt den Agenten sofort.

C9 – Mit dem Agenten arbeiten

Ist der Agent in Betrieb, arbeitet er von selbst. Dazu könnt Ihr ihm Aufträge geben:

Im Menü «KI» gibst Du dem Agenten Aufträge wie in einem Chat – hier ein wiederkehrender Wochenbericht.
Bild 26 Im Menü «KI» gibst Du dem Agenten Aufträge wie in einem Chat – hier ein wiederkehrender Wochenbericht.
Eine Aktion des Agenten wartet auf die Freigabe durch einen Menschen.
Bild 27 Eine Aktion des Agenten wartet auf die Freigabe durch einen Menschen.
ℹ️ Gut zu wissen

Was der Agent noch alles kann – selbständig aus Euren Quellen antworten, im Live-Chat helfen, Rückrufe eintragen, FAQ-Artikel pflegen, mit anderen Modulen arbeiten –, erklärt die Benutzeranleitung zu McpConnect im Abschnitt «Der KI-Agent».

Fertig mit Weg 2! ✅

Teil D – Verbindungen prüfen oder beenden

D1 – Weg 1: Deine Verbindungen in FreeScout ansehen

  1. Klicke in FreeScout oben rechts auf Deinen Namen und dann auf Ihr Profil.
  2. Klicke links auf KI-Verbindungen.
Im eigenen Profil findest Du links den Bereich «KI-Verbindungen».
Bild 28 Im eigenen Profil findest Du links den Bereich «KI-Verbindungen».

Du siehst jede Verbindung mit Erstellungsdatum, letzter Nutzung, den erlaubten Berechtigungen, den Postfächern und ob Pseudonymisierung an ist.

Deine Verbindung zu Claude im Profil. Mit «Widerrufen» beendest Du sie sofort.
Bild 29 Deine Verbindung zu Claude im Profil. Mit «Widerrufen» beendest Du sie sofort.

D2 – Weg 1: Eine Verbindung beenden

Am sichersten machst Du beides.

D3 – Weg 1: Mehr oder weniger erlauben

Die Berechtigungen einer bestehenden Verbindung lassen sich nicht nachträglich ändern. So gehst Du vor:

  1. Widerrufe die Verbindung in FreeScout (D2).
  2. Verbinde den Connector in Claude neu, oder entferne ihn und lege ihn wie in Teil B neu an.
  3. Setze im Zustimmungsdialog die gewünschten Häkchen.

D4 – Weg 2: Den Agenten pausieren oder beenden

Teil E – Wenn etwas nicht klappt

Weg 1 – Claude Desktop und claude.ai

Was Du siehstWas es bedeutetWas hilft
«Dieser KI-Client ist nicht registriert oder gesperrt.»FreeScout kennt Claude nicht.Administrator: B1 prüfen – steht claude.ai im Feld «Client-ID-Metadaten-Dokumente»? In Claude Claudes veröffentlichte Identität verwenden gewählt?
«Dieser KI-Client liess sich nicht bestätigen (…)»FreeScout konnte die Angaben zu Claude nicht von claude.ai abrufen.Administrator: Selbstprüfung, Zeile outbound. Der Server muss Verbindungen ins Internet aufbauen dürfen.
«Diese FreeScout-Installation ist nicht über HTTPS erreichbar.»Die Adresse beginnt mit http:// statt https://.Administrator oder Hoster: ein HTTPS-Zertifikat einrichten (zum Beispiel Let's Encrypt).
«Ihre Rolle darf keine KI-Clients verbinden.»Deine Rolle ist nicht freigeschaltet.Administrator: B1, Feld «Wer KI-Clients verbinden darf».
Claude meldet, dass es den Server nicht erreicht, oder bei «Authentifizierung» fehlt «Erkannt»Claude kommt nicht an Dein FreeScout heran.Adresse prüfen (https:// am Anfang, /mcp am Ende, kein Leerzeichen). FreeScout muss aus dem Internet erreichbar sein, nicht nur im Firmennetz. Selbstprüfung: Zeile «Metadaten» muss grün sein.
Nach «Zugriff erlauben» passiert nichtsBetraf ältere Fassungen von McpConnect in Safari.McpConnect im LaStore aktualisieren oder einen anderen Browser verwenden.
«Diese Anfrage ist abgelaufen.»Zwischen dem Start in Claude und dem Klick ist zu viel Zeit vergangen.In Claude den Connector noch einmal verbinden und zügig abschliessen.
Claude hatte Zugriff, jetzt nicht mehrDie Verbindung wurde beendet, etwa weil Du Dein FreeScout-Passwort geändert hast, sie widerrufen wurde oder ein Zugriff von einer nicht erlaubten Adresse kam.In Claude den Connector neu verbinden und zustimmen. Hast Du IP-Adressen eingetragen, lösche sie (B5, Punkt 5).
Du möchtest die Adresse des Connectors ändernClaude erlaubt kein Bearbeiten.Connector in Claude entfernen und neu anlegen.

Weg 2 – Agent in FreeScout

Was Du siehstWas es bedeutetWas hilft
Der Agent tut nichtsEr ist aus, gestoppt, oder der Zeitplaner läuft nicht.Auf der Seite «Agent» prüfen: Steht beim Läufer «läuft»? Ist der Notaus gelöst? Selbstprüfung: Zeile «Cron» grün?
Er schreibt keine Notizen und EntwürfeDer Probebetrieb ist noch an.Unter «Protokoll → Durchläufe des Agenten» sehen, was er getan hätte; Probebetrieb in C4 ausschalten.
«Die KI-Schnittstelle hat die Anfrage abgelehnt (…)»Anthropic hat den Aufruf abgewiesen, etwa weil das Guthaben aufgebraucht, das Ausgabenlimit erreicht oder der Schlüssel ungültig ist.Auf platform.claude.com Guthaben und Limit prüfen; notfalls einen neuen Schlüssel erstellen (C1) und in C4 einfügen.
Er pausiert bis morgenDas Tagesbudget in FreeScout ist aufgebraucht.Budget in C6 erhöhen oder bis zum nächsten Tag warten.
Er weist falsch zu oder schreibt im falschen TonDie Hausregeln sind zu ungenau.Hausregeln (C5) mit einfachen, klaren Sätzen ergänzen.
Er reagiert nicht auf meine NotizDie Notiz spricht ihn nicht an.Die Notiz mit seinem Namen beginnen oder ihn mit «@» erwähnen.
ℹ️ Gut zu wissen

Kommst Du nicht weiter, schick Deiner Administratorin oder Deinem Administrator ein Bildschirmfoto der Meldung. Unter Verwalten → KI-Verbindungen → Protokoll steht jeder Verbindungsversuch und jeder Durchlauf des Agenten mit Grund. Dort lässt sich meist schnell erkennen, woran es liegt.

Sicherheit in Kürze