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. Kopiere den folgenden Schnipsel 1:1 und ersetze damit den kompletten Inhalt der Config-Datei. Falls die Datei bereits einen "preferences"-Block enthält, ist das kein Problem: Claude Desktop generiert ihn beim nächsten Start automatisch neu.

Windows:

{
  "mcpServers": {
    "sally": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "mcp-remote",
        "https://app.sally.io/api/v1/McpExternal",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": " Bearer sally_pat_HIER_DEINEN_TOKEN_EINSETZEN"
      }
    }
  }
}

macOS:

{
  "mcpServers": {
    "sally": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.sally.io/api/v1/McpExternal",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": " Bearer sally_pat_HIER_DEINEN_TOKEN_EINSETZEN"
      }
    }
  }
}

Ersetze HIER_DEINEN_TOKEN_EINSETZEN durch den kompletten Token, den du in Schritt 1 erstellt hast. Das Prefix sally_pat_, das Leerzeichen vor Bearer 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 VS Code mit der Sally MCP-Server-Konfiguration inklusive mcpServers- und env-Block
Die fertige Config mit dem Sally MCP-Server-Eintrag (Windows-Variante)
  1. Speichere die Datei und schließe Claude Desktop komplett.
Claude muss komplett beendet werden

Das Fenster zu schließen reicht nicht aus, Claude Desktop läuft im Hintergrund weiter. Öffne den Task-Manager (Strg + Umschalt + Esc), suche den Prozess "Claude" und klicke auf "Task beenden". Auf macOS: Rechtsklick auf das Claude-Icon im Dock und "Beenden" wählen. Starte Claude Desktop danach neu, die App liest die Config-Datei nur 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.