Zum Hauptinhalt springen

Sally MCP mit Claude Desktop

Claude Desktop ist die Desktop-App von Anthropic für macOS und Windows. Das Model Context Protocol (MCP) ist ein offener Standard, über den KI-Tools auf externe Datenquellen zugreifen können. Claude Desktop unterstützt MCP-Server nativ per JSON-Config-Datei, die Einrichtung von Sally dauert nur wenige Minuten. Danach kannst du deine Sally-Meetings durchsuchen, Zusammenfassungen lesen und Transkripte direkt in einer Claude-Unterhaltung abrufen, zum Beispiel um dich auf einen anstehenden Termin vorzubereiten, offene To-dos nachzuschlagen oder ein vergangenes Meeting zu rekapitulieren.

Voraussetzungen
  • Claude Desktop installiert auf macOS oder Windows (Download unter claude.ai/download).
  • Node.js 18 oder neuer installiert. Im Terminal mit node -v prüfen. Falls nicht installiert, von nodejs.org herunterladen.
  • Ein aktiver Sally-User mit Zugriff auf mindestens ein Unternehmenskonto.
  • Sally MCP aktiviert in deinem Unternehmenskonto (Admin-Einstellung).

Schnellnavigation

  1. Personal Access Token in Sally erstellen
  2. MCP-Verbindung in Claude Desktop einrichten
  3. Troubleshooting

1. Personal Access Token in Sally erstellen​

Ein Personal Access Token (PAT) ist der Schlüssel, mit dem sich Claude Desktop am Sally MCP-Endpoint authentifiziert. Du erstellst ihn einmal.

  1. Melde dich in Sally an unter app.sally.io.
  2. Öffne unten links in der Sidebar die Einstellungen.
Sally-Sidebar mit hervorgehobenem Menüpunkt Einstellungen unten links
Einstellungen öffnen
  1. Wähle in den Einstellungen den Punkt "Integrationen". Klicke unter "Deine persönlichen Integrationen" auf "+ Integration hinzufügen".
Sally-Sidebar mit ausgewähltem Menüpunkt Integrationen und hervorgehobenem Button Integration hinzufügen
Integrationen öffnen und neue Integration hinzufügen
  1. Im Integrations-Dialog findest du den Eintrag "Sally MCP". Klicke dort auf "Token erstellen".
Integrations-Dialog mit dem Eintrag Sally MCP und hervorgehobenem Button Token erstellen
Sally MCP auswählen

  1. Fülle den Dialog "Neuen Sally MCP Token erstellen" aus:

    • Bezeichnung: ein sprechender Name, an dem du den Token später erkennst (z. B. "Claude Desktop").
    • Läuft ab: wähle eine Laufzeit: 30 Tage, 90 Tage, 1 Jahr, 2 Jahre oder Nie.

    Klicke dann auf "Token erstellen".

Dialog Neuen Sally MCP Token erstellen mit Bezeichnung Claude Desktop und Laufzeit
Bezeichnung und Laufzeit festlegen
  1. Sally zeigt dir den kompletten Token genau einmal an. Kopiere ihn sofort und lege ihn in einem Passwort-Manager oder einem sicheren Secret-Store ab. Sobald du den Dialog schließt, ist der Klartext-Wert weg. Du kannst ihn nicht noch einmal einsehen, sondern nur neu generieren.
Behandle den Token wie ein Passwort

Der Token gibt Lese-Zugriff auf alle Termine, Aufzeichnungen und Zusammenfassungen, die dein Sally-User in diesem Unternehmenskonto sieht. Teile ihn nicht in Slack, Mail oder Tickets. Lege ihn in einem Passwort-Manager ab.

Dialog mit dem neu erzeugten Sally MCP Token, Copy-Button und Hinweis, dass der Token nur einmal angezeigt wird
Token kopieren, bevor du den Dialog schließt
  1. Klicke auf "Fertig".

Du kannst jederzeit unter Einstellungen → Integrationen → Sally MCP → "Tokens verwalten" zurückkehren, um Tokens neu zu generieren, zu widerrufen oder zusätzliche anzulegen. Beim Neugenerieren wird der alte Token sofort ungültig, tausche ihn also in jedem Client aus, der ihn noch verwendet.

Sally MCP Dialog zum Verwalten der Tokens mit aktivem Token, Prefix, Ablaufdatum sowie Regenerieren- und Löschen-Icon
Aktive Tokens verwalten, einzeln neu generieren oder widerrufen

2. MCP-Verbindung in Claude Desktop einrichten​

  1. Öffne Claude Desktop.
  2. Klicke auf das Hamburger-Menü (oben links) und dann auf "Einstellungen...".
Claude Desktop Hamburger-Menü mit hervorgehobenem Eintrag Einstellungen
Einstellungen über das Hamburger-Menü öffnen
  1. Navigiere in der linken Seitenleiste zu Entwickler.
  2. Klicke auf "Config bearbeiten". Das öffnet die Datei claude_desktop_config.json in deinem Standard-Texteditor.
Claude Desktop Entwickler-Einstellungen mit hervorgehobenem Button Config bearbeiten
Config bearbeiten im Bereich Entwickler klicken

Der Speicherort der Config-Datei hängt vom Betriebssystem ab:

BetriebssystemPfad
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json
Windows Explorer mit der Datei claude_desktop_config.json im Claude-AppData-Ordner
Speicherort unter Windows (AppData → Roaming → Claude)
Datei existiert noch nicht?

Falls die Datei nicht existiert oder leer ist, legt Claude Desktop sie beim ersten Klick auf "Config bearbeiten" an. Du kannst sie auch manuell am oben genannten Pfad erstellen.

  1. Füge folgenden Schnipsel in die Config-Datei ein. Wenn die Datei schon Inhalte hat (z. B. einen "preferences"-Block), hänge "mcpServers" als Geschwister-Eigenschaft mit Komma dazwischen an.
{
  "mcpServers": {
    "sally": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.sally.io/api/v1/McpExternal",
        "--header",
        "Authorization: Bearer sally_pat_HIER_DEINEN_TOKEN_EINSETZEN"
      ]
    }
  }
}

Ersetze HIER_DEINEN_TOKEN_EINSETZEN durch den Token, den du in Schritt 1 erstellt hast. Das Prefix sally_pat_ und die Anführungszeichen bleiben stehen.

Hinweis

Claude Desktop öffnet die Config-Datei in deinem Standard-Texteditor, das kann Notepad, TextEdit, VS Code oder ein anderer Editor sein. Welcher es ist, spielt keine Rolle. Der folgende Screenshot zeigt VS Code als Beispiel.

claude_desktop_config.json geöffnet in einem Texteditor mit der Sally MCP-Server-Konfiguration
Die fertige Config mit dem Sally MCP-Server-Eintrag

Beispiel mit vorhandenem preferences-Block:

{
  "preferences": {
    "theme": "dark"
  },
  "mcpServers": {
    "sally": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.sally.io/api/v1/McpExternal",
        "--header",
        "Authorization: Bearer sally_pat_abc123..."
      ]
    }
  }
}
  1. Speichere die Datei, schließe Claude Desktop komplett (aus dem System Tray / der Menüleiste beenden, nicht nur das Fenster schließen) und öffne die App erneut. Claude Desktop liest die Config-Datei beim Start ein.

Starte eine neue Unterhaltung und tippe:

"Welche Sally-Tools sind verfügbar?"

Claude sollte die fünf Sally-Tools auflisten (search_appointments, search_summaries, get_recordings, get_summary, get_transcription). Probiere auch eine echte Abfrage:

"Suche meine Sally-Meetings der letzten 7 Tage."

3. Troubleshooting​

ProblemLösung
Sally-Tools erscheinen nichtPrüfe, ob die Config-Datei gültiges JSON ist (keine Kommas hinter dem letzten Element, alle Klammern korrekt). Claude Desktop komplett neu starten.
"Unauthorized" oder "Invalid token"Stelle sicher, dass der komplette Token inklusive sally_pat_-Prefix korrekt eingefügt ist, ohne zusätzliche Leerzeichen oder Zeilenumbrüche.
Connector ist rot / kein StatusMCP-Log prüfen:
macOS: ~/Library/Logs/Claude/mcp-server-sally.log
Windows: %APPDATA%\Claude\logs\mcp-server-sally.log
Fehlermeldung "command not found: npx" oder "npx is not recognized"Node.js ist nicht installiert oder nicht im PATH. Node.js (Version 18 oder neuer) von nodejs.org installieren und Claude Desktop neu starten.
Sally-Tools werden nach Token-Wechsel nicht aktualisiertmcp-remote cached Verbindungsdaten lokal. Den Ordner ~/.mcp-auth (macOS/Linux) bzw. %USERPROFILE%\.mcp-auth (Windows) löschen und Claude Desktop neu starten.

Weitere Tipps findest du im Allgemeinen Setup-Guide → Troubleshooting.