Zum Hauptinhalt springen

Sally MCP mit Langdock

Langdock ist eine Enterprise-KI-Plattform, die MCP-Server als Integrationen unterstützt. Das Model Context Protocol (MCP) ist ein offener Standard, über den KI-Tools auf externe Datenquellen zugreifen können. Wenn du den Sally MCP-Endpoint in Langdock einrichtest, können alle Teammitglieder mit Zugriff Sally-Meeting-Daten aus ihren Assistenten abfragen, zum Beispiel vergangene Meetings durchsuchen, Zusammenfassungen einsehen oder Transkripte für Follow-ups abrufen. MCP-Tools werden automatisch in Langdock-Aktionen umgewandelt, ohne zusätzlichen Entwicklungsaufwand.

Hintergrundinformationen zum Sally MCP Connector, den verfügbaren Tools und Best Practices zur Sicherheit findest du im Allgemeinen Setup-Guide.

Voraussetzungen
  • Ein Langdock-Konto mit Berechtigung, Integrationen hinzuzufügen (Admin- oder Integrations-Manager-Rolle).
  • Einen aktiven Sally-Account mit Zugriff auf mindestens ein Unternehmenskonto.
  • Sally MCP aktiviert in deinem Unternehmenskonto (Admin-Einstellung).
Ein Token pro Team oder pro User?

Langdock-Integrationen sind typischerweise teamweit. Wenn du einen einzelnen Sally PAT nutzt, sehen alle Langdock-User die Meeting-Daten, auf die dieser spezifische Sally-User Zugriff hat. Für korrekte Zuordnung pro User sollte jeder seinen eigenen PAT erstellen und seine eigene Integrations-Instanz einrichten.


Schnellnavigation

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

1. Personal Access Token in Sally erstellen​

Ein Personal Access Token (PAT) ist der Schlüssel, mit dem sich Langdock 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. "Langdock").
    • 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 Langdock 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 Langdock einrichten​

  1. Klicke in Langdock links in der Sidebar auf Integrationen.
  2. Klicke oben rechts auf Integration hinzufügen.
  3. Wähle im Dropdown Neu erstellen aus.
Langdock-Integrationsseite mit geöffnetem Dropdown Integration hinzufügen und hervorgehobener Option Neu erstellen
Integrationen öffnen und neue Integration erstellen

Im Dialog "Integration hinzufügen":

  1. Wähle als Typ MCP Server verbinden aus.
  2. Trage bei Server URL ein: 
    https://app.sally.io/api/v1/McpExternal
  3. Wähle bei Authentifizierungsmethode den Wert API Key aus.
  4. Klicke auf Erstellen und verbinden.
Dialog Integration hinzufügen mit ausgewähltem Typ MCP Server verbinden, ausgefülltem Server-URL-Feld und gewählter API-Key-Authentifizierung
MCP Server auswählen, Sally-Endpoint-URL eintragen und API Key als Authentifizierung wählen

Es öffnet sich der Dialog "Set up your New Integration connection":

  1. Vergib bei Name einen Namen für die Verbindung (z. B. "Sally MCP").
  2. Füge im Feld API Key deinen Sally-Token in folgendem Format ein: 
    Bearer sally_pat_DEINTOKEN
Wichtig: Bearer-Präfix erforderlich

Vor dem Token muss Bearer (mit Leerzeichen dahinter) stehen. Ohne dieses Präfix lehnt Sally die Anfrage mit "401 Unauthorized" ab.

  1. Klicke auf Save.
Dialog Set up your New Integration connection mit dem Feld Name, das Sally MCP zeigt, und ausgefülltem API-Key-Feld
Namen vergeben und API-Key mit Bearer-Präfix einfügen

Du landest jetzt auf der Seite "MCP Client konfigurieren":

  1. Klicke auf Verbindung testen.
  2. Bei erfolgreicher Verbindung erscheint rechts daneben "Verbindung erfolgreich" in Grün.
  3. Unter Verfügbare Tools werden die Sally MCP-Tools angezeigt (aktuell 5: Search appointments, Get recordings, Get summary, Search summaries, ...).
  4. Setze bei jedem gewünschten Tool das Häkchen bei Aktion aktivieren (standardmäßig sind alle aktiviert).
  5. Optional: Aktiviere Bestätigung anfragen, falls der User das Tool vor jedem Aufruf manuell freigeben soll.
  6. Klicke oben rechts auf Speichern.
Bis zu 50 Tools pro Integration

Langdock unterstützt bis zu 50 Tools pro Integration gleichzeitig.

MCP-Client-Konfigurationsseite mit erfolgreichem Verbindungstest und Liste der verfügbaren Sally-Tools mit Aktivierungshäkchen
Verbindung testen, gewünschte Tools aktivieren und speichern
  1. Öffne einen neuen Chat oder führe einen bestehenden weiter.
  2. Tippe @ im Eingabefeld. Die Sally-Integration und ihre Tools erscheinen in der Auswahlliste.
  3. Sprich die Integration mit @Sally MCP an oder stelle eine natürliche Frage, z. B.:

"Was wurde in meinem letzten Termin besprochen?"

Das Modell ruft die passenden Sally-Tools (z. B. Get recordings, Get summary) automatisch auf und gibt eine Zusammenfassung zurück.

Langdock-Chat mit einer Anfrage über @Sally MCP, wobei das Modell Get recordings und Get summary aufruft und eine Meeting-Zusammenfassung zurückgibt
@Sally MCP in jedem Chat nutzen, um Meeting-Daten abzufragen
In Agenten verwenden

Du kannst die Sally-Integration auch in den Instructions eines Langdock-Agenten hinterlegen. Der Agent nutzt sie dann eigenständig bei passenden Anfragen, ohne dass der User @Sally MCP erwähnen muss.

3. Troubleshooting​

ProblemLösung
Verbindungstest schlägt fehl mit "401 Unauthorized"Vor dem Token fehlt das Bearer (mit Leerzeichen) oder der Token wurde inzwischen widerrufen. Korrigiere den API-Key-Wert oder erstelle einen neuen Token unter app.sally.io.
Verbindung erfolgreich, aber keine Tools sichtbarScrolle im Block "Verfügbare Tools" nach unten. Falls die Liste wirklich leer ist, kläre die MCP-Protokoll-Version mit dem Sally-Support ab.
Andere Workspace-Mitglieder können die Integration nicht nutzenDie Integration ist standardmäßig nur für den Ersteller sichtbar. Als Admin kannst du in den Integration-Einstellungen die Sichtbarkeit auf den gesamten Workspace umstellen.

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