Claude MCP

Das Model Context Protocol (MCP) ist ein offener Standard, der es KI-Assistenten wie Claude ermöglicht, sicher auf externe Tools und Datenquellen zuzugreifen. Finn stellt einen MCP-Server bereit, sodass Sie Finn in Claude (oder einen beliebigen MCP-kompatiblen Client) einbinden und Ihren KI-Assistenten die Plattform im Dialog abfragen, konfigurieren und bedienen lassen können.

Für wen das gedacht ist. Für Power-User – Entwickler, Automatisierungs-Engineers und KI-affine Anwender, die Finn aus Claude Desktop, Claude Code oder einem anderen MCP-Client heraus steuern möchten. Wenn Sie mit Claude oder MCP nicht vertraut sind, brauchen Sie das nicht – das Dashboard kann alles, was auch das MCP bereitstellt.

Status: Der Finn MCP-Server befindet sich in der Public Beta. Die APIs sind stabil, es kommen jedoch regelmäßig weitere Tools hinzu.

Was Sie mit dem MCP tun können

Nach der Verbindung kann Ihre Claude-Instanz (oder eine andere MCP-kompatible KI) all dies in Ihrem Namen erledigen:

Lesevorgänge

• Status eines beliebigen Deployments abrufen.
• Ihre Finns, Zielgruppen und Telefonnummern auflisten.
• Gesprächstranskripte und Analysen für einen beliebigen Zeitraum abrufen.
• Anrufverlauf nach bestimmten Mustern durchsuchen („Zeig mir Anrufe, in denen der Anrufer ‚Erstattung‘ erwähnt hat“).
• Deployment-Kosten, Tarifnutzung und Abrechnungsübersichten lesen.

Schreibvorgänge

• Neues Deployment starten.
• Aktives Deployment pausieren oder stoppen.
• Kontakte zu einer Zielgruppe hinzufügen.
• Felder der Nachgesprächsanalyse eines Finn aktualisieren.
• Nummern sperren (auf die Do-not-call-Liste setzen).

Koordination

• Wochen- und Monatsberichte automatisch erstellen.
• Anrufergebnisse mit Ihrem CRM abgleichen, um Lücken in der Attribution zu erkennen.
• Automatisch ein neues Deployment anlegen, sobald eine CRM-Liste eine bestimmte Größe erreicht.
• Ein Deployment in verständlicher Sprache zusammenfassen, geeignet zur Weitergabe an fachfremde Stakeholder.

MCP-Server einrichten

Schritt 1 – MCP-Token erzeugen

Einstellungen → Integrationen → MCP → Token erzeugen.

Kopieren Sie das Token sofort – es wird nur einmal angezeigt. Bewahren Sie es in Ihrem Passwortmanager oder Secret Store auf.

Die Token-Berechtigungen sind konfigurierbar:

• Nur lesen – Daten abfragen, aber nicht ändern
• Lesen + schreiben – voller operativer Zugriff (mit Bedacht einsetzen)
• Auf bestimmte Finns/Zielgruppen beschränkt – Zugriff auf eine Teilmenge begrenzen

Für die meisten Nutzer empfiehlt sich der Start mit Nur lesen, um sich vertraut zu machen, und eine spätere Erweiterung.

Schritt 2 – MCP-Client konfigurieren

Claude Desktop (Mac, Windows):

Bearbeiten Sie Ihre Claude-Desktop-Konfigurationsdatei:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Fügen Sie den Finn-Server hinzu:

{
  "mcpServers": {
    "finnai": {
      "command": "npx",
      "args": ["-y", "@finnai/mcp-server"],
      "env": {
        "FINNAI_API_TOKEN": "your_token_here"
      }
    }
  }
}

Starten Sie Claude Desktop neu. Die Finn-Tools stehen dann in jeder Unterhaltung zur Verfügung.

Claude Code (CLI):

claude mcp add finnai \
  --command "npx -y @finnai/mcp-server" \
  --env FINNAI_API_TOKEN=your_token_here

Dann claude aus einem beliebigen Verzeichnis – Finn-Tools stehen zur Verfügung.

Andere MCP-Clients (Continue, Cursor, eigene):

Verwenden Sie denselben npx-Befehl in der MCP-Server-Konfiguration Ihres Clients. Der Server kommuniziert über Standard-MCP via stdio.

Schritt 3 – Verbindung testen

Fragen Sie in Claude (beliebiger Client):

„Welche Finns habe ich konfiguriert?“

Wenn die Verbindung funktioniert, ruft Claude das Tool list_finns auf und antwortet mit einem echten Ergebnis.

Tools, die das MCP bereitstellt

Der Server bietet rund 30 Tools. Die wichtigsten:

Finn-Verwaltung

• list_finns – alle Finns im Konto auflisten.
• get_finn – die vollständige Konfiguration eines Finns abrufen.
• create_finn – einen neuen Finn anlegen (fortgeschritten).
• update_finn – Finn-Einstellungen ändern.

Zielgruppenverwaltung

• list_audiences – alle Zielgruppen auflisten.
• get_audience_stats – Anzahl, Validierungsstatus, letzte Importe.
• add_contacts – Kontakte per Massenimport hinzufügen.
• remove_contact – einen einzelnen Kontakt entfernen.

Deployment-Lebenszyklus

• list_deployments – vergangene und aktive Deployments auflisten.
• launch_deployment – ein neues starten.
• pause_deployment / resume_deployment / stop_deployment.
• get_deployment_status – Live-Status mit aktuellen Anrufzahlen.

Analytics

• get_deployment_analytics – vollständige Metriken für ein Deployment.
• search_calls – Anrufe finden, die inhaltlichen Mustern entsprechen.
• get_call – Transkript und Analyse eines einzelnen Anrufs abrufen.
• aggregate_calls – eigene Auswertungen nach beliebigem Feld über beliebige Zeiträume.

Compliance

• add_to_suppression_list – eine Nummer global sperren.
• remove_from_suppression_list – Sperre aufheben.
• check_suppression – steht eine Nummer auf der Liste?

Abrechnung

• get_usage_this_month – laufende Kosten.
• forecast_month_end – Prognose auf Basis des bisherigen Verlaufs.
• set_spend_cap – Limits anpassen.

Vollständiges Schema für jedes Tool: api.hirefinn.ai/academy/mcp.

Aufgaben, die Sie Claude stellen können

Prompts, die wirklich funktionieren:

„Zeig mir die Deployment-Ergebnisse von gestern und sag mir, welcher Finn am besten abgeschnitten hat."

„Finde alle Anrufe der letzten Woche, in denen der Anrufer ‚zu teuer' gesagt hat, und fasse den gemeinsamen Kontext zusammen."

„Starte dasselbe Deployment wie letzten Montag, aber mit der Zielgruppe, die ich heute Morgen hochgeladen habe."

„Wie viel haben wir letzte Woche ausgegeben, und liegen wir im Budget?"

„Füge diese Telefonnummern zur Sperrliste hinzu: [Liste einfügen]"

„Wie groß ist der Unterschied in der Erfolgsquote zwischen unseren Anrufen am Vormittag und am Nachmittag?"

„Erstelle eine einseitige Zusammenfassung der Terminerinnerungs-Kampagne des letzten Monats für die Praxisleitung."

Das MCP macht Finn dialogfähig. Vorgänge, die im Dashboard 5–10 Klicks brauchen, werden zu einer einzigen Anfrage in natürlicher Sprache.

Sicherheitsaspekte

Was das Token darf

Die Token-Scopes bestimmen, was erlaubt ist:

• Nur-Lesen-Token → kann alles abfragen, aber nichts ändern.
• Lesen + Schreiben → voller operativer Zugriff. Behandeln Sie es wie Ihr Dashboard-Passwort.
• Eingeschränkte Token → begrenzt auf Finn-ID, Zielgruppen-ID oder Vorgangstyp.

Best Practices

• Fügen Sie Token nicht in Chat-Nachrichten ein. Nutzen Sie Umgebungsvariablen in der Konfiguration Ihres MCP-Clients.
• Rotieren Sie Token regelmäßig. Einstellungen → Integrationen → MCP → Rotieren.
• Nutzen Sie eingeschränkte Token für Teammitglieder. Geben Sie einem externen Dienstleister kein Token mit Vollzugriff.
• Audit-Log. Jeder MCP-Aufruf wird protokolliert. Einstellungen → Integrationen → MCP → Aktivitätsprotokoll.
• Widerrufen Sie kompromittierte Token sofort. Einstellungen → Integrationen → MCP → Widerrufen.

Was Claude nicht kann

Das MCP stellt Folgendes nicht bereit:

• Konten anlegen/löschen
• Änderungen der Zahlungsmethode
• Tarif-Upgrades/-Downgrades
• Einladungen von Teammitgliedern
• SSO-Konfiguration

Dafür ist Zugriff auf das Dashboard nötig. Das ist Absicht – diese Entscheidungen sollen Menschen treffen.

Sensible Aktionen freigeben

Standardmäßig verlangt das MCP für jeden Schreibvorgang eine ausdrückliche Freigabe durch einen Menschen (über das Berechtigungssystem Ihres MCP-Clients):

• Deployments starten
• Kontakte hinzufügen/entfernen
• Finn-Konfigurationen ändern
• Geld ausgeben

Das wird auf Protokollebene durchgesetzt – Claude kann keinen Schreibvorgang ausführen, ohne dass Sie ihn in der Client-Oberfläche bestätigen. Lesevorgänge brauchen keine Freigabe.

Sie können dies pro Tool unter Einstellungen → Integrationen → MCP → Auto-Freigabeliste deaktivieren, wenn bestimmte Tools ohne Rückfrage laufen sollen. Sparsam einsetzen – die automatische Freigabe von "launch_deployment" ist ein sicherer Weg, schnell viel Geld auszugeben.

Gängige Muster

Tägliches Standup

Claude so einrichten, dass jeden Morgen die Kennzahlen des Vortags abgerufen werden:

"Fasse jeden Werktag um 9 Uhr die Deployment-Ergebnisse des Vortags zusammen, hebe Auffälligkeiten hervor und poste sie in meinen Slack."

(Erfordert Claude Code mit geplanten Aufgaben oder einen eigenen Cron- + MCP-Wrapper.)

Anomalieerkennung

"Prüfe, ob ein Deployment in den letzten 24 Stunden eine Erfolgsquote unter 50 % hatte oder mehr als das Doppelte seines 7-Tage-Durchschnitts gekostet hat. Markiere diese mit Details."

Massenprüfung

"Liste alle Finn auf, für die keine Post-Call-Analysefelder definiert sind. Schlage für jeden auf Basis der Identitätsbeschreibung sinnvolle Standardwerte vor."

Schnelle Exporte

"Rufe alle Anrufe aus Deployment X ab, bei denen qualified=true, exportiere sie als CSV und sende sie mir per E-Mail."

Fehlerbehebung

"Claude findet die Finn-Tools nicht"

• Claude Desktop nach dem Bearbeiten der Konfiguration neu starten.
• Prüfen, ob das Konfigurations-JSON gültig ist (Kommas, Anführungszeichen).
• npx -y @finnai/mcp-server --test im Terminal ausführen, um zu prüfen, ob der Server startet.

"Authentifizierung fehlgeschlagen"

• Token abgelaufen oder widerrufen. Neues Token erzeugen.
• Token-Umgebungsvariable wird nicht durchgereicht (Tippfehler in der Konfiguration).

"Zeitüberschreitung beim Tool-Aufruf"

• Große Abfragen (z. B. Suche im Anrufverlauf) können über 30 Sekunden dauern.
• Der Standard-Timeout liegt in den meisten Clients bei 30 s. Bei Bedarf erhöhen.

"Zugriff auf Tool X verweigert"

• Der Geltungsbereich Ihres Tokens umfasst dieses Tool nicht.
• Token mit größerem Geltungsbereich neu erzeugen oder den Vorgang im Dashboard ausführen.

Was kommt

Die MCP-Roadmap (Stand dieser Fassung):

• Workflow-Tools – visuelle Workflows über Claude erstellen und bearbeiten.
• Test-on-Call-Tool – Testanrufe aus Claude heraus starten.
• Streaming-Abonnements – Echtzeit-Event-Streams für Live-Deployments.
• Multi-Account-Unterstützung – mehrere Finn-Konten aus einer Claude-Sitzung verwalten.
• Aufzeichnungswiedergabe – Anrufaudio zum direkten Anhören an Claude streamen (Enterprise).

Gewünschte Tools vorschlagen unter [email protected].

Über Claude hinaus

Diese Seite konzentriert sich zwar auf Claude, der MCP-Server ist jedoch anbieterunabhängig. Er funktioniert mit:

• Continue.dev (VS Code KI-Erweiterung)
• Cursor (KI-first-IDE)
• OpenAI ChatGPT Desktop (sobald MCP-Unterstützung verfügbar ist)
• Eigene MCP-Clients auf Basis der offenen Spezifikation

Jeder Client, der MCP spricht, kann Finn über denselben Server nutzen.

Weiter

• Integrationen → REST API – die zugrunde liegende API, die MCP umschließt.
• Integrationen → Webhooks – Push-Benachrichtigungen für ereignisgesteuerte Workflows.
• Kapazität & Skalierung → – Rate Limits, die für MCP-Aufrufe gelten.