Claude MCP

Das Model Context Protocol (MCP) ist ein offener Standard, über den KI-Assistenten wie Claude externe Tools aufrufen können. Finn betreibt einen MCP-Server. Sie können Claude also mit Ihrem Finn-Konto verbinden und Sprachagenten im Gespräch beschreiben, statt den Builder von Hand auszufüllen.

Was dieser Server kann. Er liest Ihre Finns und erstellt oder bearbeitet Entwürfe. Mehr nicht. Er kann keinen Finn starten, keine Nummer wählen, kein Guthaben ausgeben, keine Kontakte ändern und keine Transkripte lesen – das bleibt bewusst dem Dashboard vorbehalten. Warum, erklärt der Abschnitt Umfang weiter unten.

Für wen ist das gedacht? Für alle, die Claude bereits nutzen und einen Agenten lieber beschreiben, als ihn Klick für Klick zu erstellen. Programmierkenntnisse brauchen Sie nicht. Wenn Sie Claude nicht nutzen, entgeht Ihnen nichts – das Dashboard kann alles, was der Server bietet, und noch mehr.

Es gibt genau zwei Verbindungswege, und Sie brauchen nur einen:

Umfang – was der Server kann und was nicht

Das ist Absicht und wird an zwei Stellen durchgesetzt: Der Server stellt diese Tools nicht bereit, und das Backend lehnt die zugrunde liegenden Anfragen ab, selbst wenn etwas sie anfordert. Der Grund ist der unten beschriebene Connector-Link: Dieser Link ist selbst ein Zugangsnachweis. Gelangt er in falsche Hände, kann damit schlimmstenfalls jemand Ihre Finns lesen und Ihre Entwürfe bearbeiten. Das lässt sich beheben. „Meine Kunden anrufen und mein Guthaben ausgeben“ nicht.

Für Sie heißt das: Claude erstellt den Finn, Sie starten ihn. Jeder Finn kommt als Entwurf an, Sie prüfen ihn im Dashboard und klicken selbst auf den Button.

Schritt 1 – Schlüssel generieren

Im Dashboard: Einstellungen → Integrationen → KI-Assistenten (MCP) → Schlüssel generieren.

Unter dem Namen, den Sie dem Schlüssel geben, erscheint der Connector in Claude. Benennen Sie ihn also nach dem Ort, an dem Sie ihn nutzen wollen, etwa „Arbeitslaptop“ oder „Desktop zu Hause“. So lassen sich zwei Schlüssel als zwei Einträge unterscheiden statt als zwei identische Zeilen.

Ihr Schlüssel beginnt mit finn_mcp_, gefolgt von einer langen Zeichenfolge. Er wird nur ein einziges Mal angezeigt. Kopieren Sie, was Sie brauchen, bevor Sie den Dialog schließen. Falls Sie ihn verlieren, widerrufen Sie den Schlüssel und generieren einen neuen.

Wissenswertes zu Schlüsseln:

• Ein Schlüssel ist an Ihre Identität gebunden. Ein Finn, den Sie mit Ihrem Schlüssel erstellen, landet in Ihrer Organisation, und zwar unter Ihrem Namen. Wenn Sie den Schlüssel einer Kollegin oder eines Kollegen verwenden, erscheint der Finn in deren Konto und Sie finden ihn nicht.
• Es gibt keine Berechtigungsstufen. Jeder Schlüssel kann alles aus der Liste „Kann“ oben und nichts aus der Liste „Kann nicht“.
• Der Widerruf gilt sofort. Der Server prüft den Schlüssel bei jedem einzelnen Aufruf erneut gegen Ihr Konto. Ein widerrufener Schlüssel funktioniert also schon bei der nächsten Anfrage nicht mehr, nicht erst am Ende einer Sitzung.

Schritt 2 – Claude verbinden

Im Dialog mit Ihrem neuen Schlüssel finden Sie beide Optionen, jeweils mit einer eigenen Kopierschaltfläche. Wählen Sie die Option, die zu Ihrer Nutzung von Claude passt.

Option 1 – Claude-App (claude.ai oder Claude Desktop)

Diese Option ist für die meisten die richtige. Sie müssen nichts installieren und nichts bearbeiten.

Kopieren Sie Ihren Connector-Link aus dem Dialog. Er sieht so aus, mit Ihrem eigenen Schlüssel am Ende:

https://finn-mcp-73965536364.asia-southeast1.run.app/mcp/finn_mcp_YOUR_KEY_HERE

Anschließend in Claude:

1. Öffnen Sie Customize → Connectors, klicken Sie auf + und wählen Sie Add custom connector.
2. Fügen Sie den Link als URL des Remote-MCP-Servers ein und klicken Sie auf Add. Er erscheint dann unter dem Namen Ihres Schlüssels.
3. Öffnen Sie in einem neuen Chat + → Connectors, aktivieren Sie Finn und bitten Sie Claude dann, einen Finn zu erstellen.

Zwei Hinweise zu den Tarifen: Im Free-Tarif ist ein benutzerdefinierter Connector möglich. In den Tarifen Team und Enterprise kann nur ein Owner einen Connector hinzufügen, und zwar unter Organization settings → Connectors. Alle anderen klicken dort anschließend auf Connect.

Der Nachteil: Ein benutzerdefinierter Connector besteht nur aus einem URL-Feld ohne Platz für ein Passwort. Der Link selbst ist also die Zugangsberechtigung. Behandeln Sie die gesamte URL wie Ihr Dashboard-Passwort und fügen Sie sie nicht in Chats, Tickets, Screenshots oder Repositorys ein.

Option 2 – Claude Code (Terminal)

Kopieren Sie den Befehl aus dem Dialog. Er besteht aus einer Zeile und lässt sich daher problemlos in bash, zsh, PowerShell und cmd einfügen:

claude mcp add --transport http finn https://finn-mcp-73965536364.asia-southeast1.run.app/mcp --header "Authorization: Bearer finn_mcp_YOUR_KEY_HERE"

1. Fügen Sie den Befehl in ein Terminal ein und führen Sie ihn aus.
2. Führen Sie claude aus.
3. Bitten Sie Claude, einen Finn zu erstellen.

Bei dieser Variante steht der Schlüssel in einem Header statt in der URL. Das ist die sicherere der beiden Optionen.

Andere MCP-Clients

Der Server nutzt Streamable HTTP, nicht stdio, und ist zustandslos. Es gibt also keine Sitzung, die geöffnet werden muss oder abläuft. Jeder Client mit Unterstützung für HTTP-MCP-Endpunkte funktioniert mit beiden oben genannten Zugängen: entweder mit dem Schlüssel in einem Authorization: Bearer-Header an /mcp oder mit dem Schlüssel als letztem Pfadsegment von /mcp/<key>.

claude_desktop_config.json ist keine der Optionen. Diese Datei konfiguriert lokale MCP-Server. Der Finn-Server läuft remote und wird deshalb als benutzerdefinierter Connector hinzugefügt.

Schritt 3 – Verbindung prüfen

Fragen Sie Claude:

„Welche Finns habe ich?“

Wenn die Verbindung funktioniert, nennt Claude die Namen Ihrer Finns. Falls Claude meldet, dass ihm dieses Tool nicht zur Verfügung steht, lesen Sie unten unter Fehlerbehebung nach.

Die Tools

Es gibt sechs Tools, zwischen denen Claude selbst auswählt. Sie müssen nie ein bestimmtes Tool nennen.

Einen Finn im Gespräch erstellen

Beschreiben Sie in einfachen Worten, was Sie möchten. Der Dialog bietet diese Anfrage als Ausgangspunkt an:

„Erstelle mit dem Finn-Connector einen Finn-Entwurf namens Maya, der Termine für eine Zahnarztpraxis vereinbart: freundlich, knapp, Englisch.“

Eine ausführlichere Anfrage sieht so aus:

„Erstelle einen Finn namens Skylar, der 15-minütige Demo-Termine für unser Vertriebsteam bucht. Herzlich und knapp, unterbricht nie und bestätigt dem Anrufer immer Datum und Uhrzeit. Er soll nur über Demos und Terminplanung sprechen – fragt jemand nach Preisen, bietet er an, an einen Mitarbeiter weiterzuleiten. Verwende eine freundliche weibliche englische Stimme.“

Dafür braucht Claude vier Angaben und fragt nach, wenn eine fehlt:

Optional können Sie außerdem eine Anwendungsfall-Bezeichnung, eine Sprache, eine Stimme, einen Begrüßungssatz und eine eigene Vokabelliste für Namen angeben, die er sonst falsch aussprechen würde.

Zurück erhalten Sie einen Link zum neuen Entwurf, dessen ID sowie die Organisation und das Konto, in dem er angelegt wurde. Danach können Sie:

1. Den Link öffnen und den Entwurf im Builder prüfen.
2. Claude um Änderungen bitten – „kürze den Begrüßungssatz“, „füge einen Zweig für die Mailbox hinzu“ – und Claude bearbeitet den Entwurf direkt.
3. Wenn alles passt, eine Nummer zuweisen und den Finn im Dashboard starten. Siehe Bereitstellungen.

Ein bereits geöffneter Dashboard-Tab zeigt den neuen Finn erst nach dem Neuladen an.

Stimmen

Beschreiben Sie die gewünschte Stimme – „eine ruhige männliche englische Stimme“ – und Claude durchsucht den Katalog für Sie.

Eine Sache sollten Sie beachten: Neue Finns werden auf Cartesia erstellt. Eine Stimmen-ID eines anderen Anbieters wird ohne Fehlermeldung gespeichert, schlägt dann aber bei einem echten Anruf fehl. Wenn Sie einen bestimmten Anbieter anfordern, stellen Sie sicher, dass Ihr Finn tatsächlich diesen verwendet. In der Stimmengalerie finden Sie den vollständigen Katalog.

Sicherheit

Der Connector-Link ist ein Passwort. Bei der Einrichtung mit nur einem Link steht der Schlüssel in der URL – wer die URL sieht, hat also Ihren Zugriff. Machen Sie keine Screenshots davon, fügen Sie ihn nicht in einen geteilten Chat ein und committen Sie ihn nicht.

Gehen Sie davon aus, dass alles, was Sie einfügen, offengelegt ist. Wenn ein Schlüssel in einem Chatfenster, einem Ticket oder einer E-Mail stand, widerrufen Sie ihn und generieren Sie einen neuen. Das kostet nichts.

Widerrufen unter Einstellungen → Integrationen → KI-Assistenten → Widerrufen. Der Widerruf gilt ab der nächsten Anfrage. Bereits erstellte Finns bleiben unberührt – das Widerrufen eines Schlüssels löscht nichts, was damit erstellt wurde.

Ein Schlüssel pro Ort. Mit separaten Schlüsseln für Ihren Laptop, Ihren Desktop-Rechner und jede Kollegin oder jeden Kollegen können Sie einen widerrufen, ohne die anderen zu beeinträchtigen, und am Connector-Namen erkennen Sie, welcher welcher ist.

Prüfen Sie, in wessen Konto Sie sind. Wenn Sie mehreren Organisationen angehören, fragen Sie Claude „In welcher Finn-Organisation bin ich?“, bevor Sie etwas erstellen. Neue Finns werden in der Organisation angelegt, der Sie zuletzt beigetreten sind.

Fehlerbehebung

„Claude hat keine Finn-Tools“

• Öffnen Sie in der Claude-App im Chat + → Connectors und prüfen Sie, ob Finn aktiviert ist. Connectors werden pro Unterhaltung aktiviert.
• Starten Sie Claude Code neu – die MCP-Konfiguration wird beim Start eingelesen.
• Prüfen Sie im Free-Tarif, ob Sie Ihren einzigen Platz für einen benutzerdefinierten Connector nicht bereits anderweitig belegt haben.

„Dieser Connector-Link ist ungültig“

Der Schlüssel in der URL ist fehlerhaft. Er muss vollständig sein, mit finn_mcp_ beginnen, darf am Ende nicht gekürzt sein und keinen abschließenden Schrägstrich oder kein Leerzeichen enthalten.

„Dieser Connector-Link wurde widerrufen“

Dieser Schlüssel existiert nicht mehr. Generieren Sie einen neuen und aktualisieren Sie den Connector.

„Das Finn-Backend konnte zur Überprüfung Ihres Schlüssels nicht erreicht werden“

Ein vorübergehendes Problem auf unserer Seite, kein Fehler in Ihrer Einrichtung. Versuchen Sie es erneut; wenn das Problem weiterhin besteht, wenden Sie sich an den Support.

Claude hat einen Finn erstellt, aber Sie finden ihn nicht

Fast immer liegt es am falschen Konto. Fragen Sie Claude „In welcher Organisation wurde er erstellt?“ – die Antwort nennt die Organisation und die E-Mail-Adresse, zu der der Schlüssel gehört. Wenn es nicht Ihre ist, verwenden Sie den Schlüssel einer anderen Person.

Claude sagt, dass es einen Finn nicht bearbeiten kann

Der Finn wurde bereits live geschaltet. Der Server bearbeitet nur Entwürfe; ein Live-Finn wird im Dashboard bearbeitet.

Weiter

• Einen Finn erstellen → – der Dashboard-Builder und die Bedeutung der einzelnen Persona-Felder.
• Deployments → – eine Nummer zuweisen und einen Entwurf live schalten.
• Voice Gallery → – der vollständige Stimmenkatalog.
• Integrationen → – Webhooks und alle weiteren Integrationsmöglichkeiten.