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.

Schnellnavigation

  1. Personal Access Token in Sally erstellen
  2. MCP-Verbindung in Langdock einrichten
  3. Zugriffsumfang
  4. Troubleshooting
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.

Token oder OAuth?

Langdock bietet für Remote-MCP-Server auch OAuth 2.0 (Dynamic Client Registration) als Authentifizierungsmethode an, und Sally unterstützt das. Wenn du das statt API Key wählst, kannst du Schritt 1 komplett überspringen: Langdock registriert sich selbst bei Sally und die Autorisierung läuft im Browser, du musst also keinen Token erstellen, einfügen oder erneuern. Die folgenden Schritte beschreiben den API-Key-Weg. Hintergrund im Abschnitt OAuth 2.1 mit Dynamic Client Registration.

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. Öffne unten links in der Seitenleiste die Einstellungen.
Sally-Seitenleiste mit hervorgehobenem Menüpunkt Einstellungen unten links
Einstellungen öffnen
  1. Wähle unter Konfiguration den Punkt Integrationen und dort den Reiter MCP. Klicke unter Sally MCP auf Token erstellen. Ist noch kein Token vorhanden, steht der Button in der Mitte, sonst oben rechts.
Reiter MCP in den Integrationen mit dem markierten Button Token erstellen
Im Reiter MCP einen Token erstellen

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

    • Name: Pflichtfeld. Wähle einen sprechenden Namen, an dem du den Token später wiedererkennst.
    • Ablaufdatum (optional): setze ein Datum, wenn der Token von selbst ungültig werden soll. Ohne Angabe läuft er nicht ab.

    Klicke dann auf Erstellen.

Dialog Sally MCP-Token erstellen mit den Feldern Name und Ablaufdatum
Name und optionales Ablaufdatum festlegen
  1. Sally zeigt den kompletten Token genau einmal an. Kopiere ihn sofort über das Symbol rechts im Feld und lege ihn in einem Passwortmanager oder einem sicheren Secret-Store ab. Sobald du den Dialog schließt, kommst du nicht mehr an ihn heran.
Dialog mit dem neu erzeugten Token, dem Kopier-Symbol und dem Hinweis, dass der Token nur einmal vollständig angezeigt wird
Token kopieren, bevor du den Dialog schließt
Behandle den Token wie ein Passwort

Der Token gibt Lese-Zugriff auf alle Termine, Aufzeichnungen und Zusammenfassungen, die dein Sally-Benutzer in diesem Unternehmenskonto sieht. Teile ihn nicht über Chat, E-Mail oder Tickets, sondern lege ihn in einem Passwortmanager ab.

  1. Klicke auf Fertig. Der Token steht danach unter Deine aktiven Tokens, mit seinem Anfang, dem Ablaufdatum und einem Papierkorb. Über den Papierkorb entziehst du dem Token den Zugriff. Einen ersetzten Token legst du danach einfach neu an.
Liste der aktiven Sally MCP Tokens mit dem Anfang des Tokens, dem Ablaufdatum und einem Papierkorb
Aktive Tokens ansehen und bei Bedarf löschen

2. MCP-Verbindung in Langdock einrichten​

  1. Klicke in Langdock links in der Seitenleiste 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 ein: 
    sally_user_mcp_DEINTOKEN
Das ist der Token aus Sally

Hier kommt genau der Token rein, den du gerade in Sally kopiert hast.

  1. Klicke auf Save.
Dialog Set up your New Integration connection mit dem Feld Name, das Sally MCP zeigt, sowie ausgefülltem API-Key-Feld
Namen vergeben und Sally-Token im API-Key-Feld 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.
MCP-Client-Konfigurationsseite mit erfolgreichem Verbindungstest und Liste der verfügbaren Sally-Tools mit Aktivierungshäkchen
Verbindung testen, gewünschte Tools aktivieren und speichern
Bis zu 50 Tools pro Integration

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

  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. Zugriffsumfang​

Der Sally MCP-Connector liefert nur Meetings, die zu deinem eigenen Sally-User gehören oder dir explizit freigegeben sind. Die folgende Tabelle fasst zusammen, was über deinen Token erreichbar ist und was nicht:

QuelleÜber MCP zugänglich?
Eigene Meetings (du bist Owner / Technical Owner)Ja
Meetings, die dir über einen Aufzeichnungsordner freigegeben sind (direkt oder über eines deiner Teams)Ja
Meetings von Personen, für die du als Vertretung eingetragen bistNein
Vertretungsrechte gelten nicht für MCP

Auch wenn du in Sally als Vertretung für andere Personen eingetragen bist, sind deren Meetings nicht über MCP verfügbar. Der Connector liefert aktuell nur deine eigenen Aufzeichnungen sowie Aufzeichnungen, die dir explizit über einen Ordner freigegeben wurden. Wenn du die Meetings einer Vertretungs-Person in deinem KI-Tool brauchst, lass sie dir vom Owner über einen Aufzeichnungsordner freigeben.

4. Troubleshooting​

ProblemLösung
Verbindungstest schlägt fehl mit 401 UnauthorizedDer Token ist falsch oder wurde inzwischen gelöscht. Prüfe, dass im API-Key-Feld nur der Sally-Token (Format sally_user_mcp_…) steht, ohne zusätzliches Präfix. Falls nötig, erstelle unter app.sally.io einen neuen Token.
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.