Zum Hauptinhalt springen

Sally MCP mit Cursor

Cursor ist ein KI-gestützter Code-Editor, der MCP-Server über die integrierte Einstellungs-UI und eine projektweite Config-Datei 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 einträgst, kannst du deine Meetings, Zusammenfassungen und Transkripte direkt beim Coden abfragen, zum Beispiel um eine Entscheidung aus einem Sprint-Review nachzuschlagen, offene Aufgaben zu prüfen oder ein Transkript einzusehen, ohne die App zu wechseln.

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 Cursor einrichten
  3. Zugriffsumfang
  4. Troubleshooting
Voraussetzungen
  • Cursor installiert (Download unter cursor.com).
  • Einen aktiven Sally-Account mit Zugriff auf mindestens ein Unternehmenskonto.
  • Sally MCP aktiviert in deinem Unternehmenskonto (Admin-Einstellung).
Token oder OAuth?

Sally akzeptiert sowohl einen Personal Access Token als auch OAuth 2.1, und Cursor kann beides. Dieser Guide nimmt den Token-Weg, weil er in jeder Cursor-Version gleich funktioniert. Eine Sache solltest du erwarten: Cursor startet seinen eigenen OAuth-Flow, sobald ein Server OAuth-Discovery-Metadaten veröffentlicht, und genau das macht Sally. Cursor öffnet deshalb beim ersten Start eventuell ein Sally-Login-Fenster, obwohl ein Token-Header konfiguriert ist. In beiden Fällen steht am Ende eine funktionierende Verbindung. 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 Cursor 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 Cursor einrichten​

Option A: Über die Cursor-Einstellungen

  1. Öffne Cursor.
  2. Klicke unten links auf das Zahnrad-Icon, um die Einstellungen zu öffnen.
  3. Navigiere im linken Menü zu Tools & MCPs.
  4. Klicke unter User MCP Servers auf Add Custom MCP.
Cursor-Einstellungen mit der Seite Tools & MCPs und hervorgehobenem Button Add Custom MCP
Einstellungen → Tools & MCPs → Add Custom MCP

  1. Trage folgende Daten ein:

    • Name: sally
    • Type: http (oder Streamable HTTP, falls aufgelistet)
    • URL: https://app.sally.io/api/v1/McpExternal
    • Headers: Authorization: Bearer DEIN_SALLY_TOKEN

  2. Speichern. Der Sally MCP-Server erscheint nun unter User MCP Servers mit aktivierten Tools.

Cursor-Einstellungen mit dem sally MCP-Server unter User MCP Servers (5 Tools aktiviert) und der mcp.json-Datei rechts daneben
Sally MCP-Server konfiguriert mit 5 aktivierten Tools

Option B: Über die Projekt-Config-Datei

Erstelle oder bearbeite die Datei .cursor/mcp.json im Root deines Projekts:

{
  "mcpServers": {
    "sally": {
      "type": "http",
      "url": "https://app.sally.io/api/v1/McpExternal",
      "headers": {
        "Authorization": "Bearer DEIN_SALLY_TOKEN"
      }
    }
  }
}

Ersetze DEIN_SALLY_TOKEN durch den Token, den du in Schritt 1 erstellt hast. Speichere dann die Datei.

Global vs. Projekt-Config

Die Einstellungs-UI konfiguriert Sally global (in allen Projekten verfügbar). Die .cursor/mcp.json-Datei beschränkt den Server auf ein einzelnes Projekt. Wähle, was zu deinem Workflow passt. Wenn beides vorhanden ist, hat die Projekt-Config Vorrang.

Prüfe anschließend die Verbindung:

  1. Öffne ein neues Agent-Panel in Cursor.
  2. Klicke auf den +-Button und öffne MCP Servers. Prüfe, dass sally aufgelistet und aktiviert ist.
Cursor Agent-Panel mit geöffnetem MCP-Servers-Menü, der sally-Server ist aktiviert
Sally erscheint in der MCP-Servers-Liste und ist aktiviert
  1. Frage:

„Welche Sally-Tools sind verfügbar?“

Cursor sollte die fünf Sally-Tools auflisten. Probiere eine echte Abfrage:

"Suche meine Sally-Meetings der letzten 7 Tage, in denen es um die Q3-Planung ging."

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
Sally-Tools erscheinen nichtCursor nach dem Eintragen der Config neu starten. Prüfe, ob .cursor/mcp.json gültiges JSON ist.
Unauthorized oder Invalid tokenPrüfe, ob der Token komplett eingetragen ist, samt sally_user_mcp_ am Anfang. Bei Bedarf in Sally löschen und einen neuen anlegen.
MCP-Bereich nicht in den EinstellungenCursor auf die neueste Version aktualisieren. MCP-Unterstützung wurde Anfang 2025 hinzugefügt.
Ergebnisse sind leerStelle sicher, dass der Sally-User hinter dem Token zugängliche Meetings hat. Prüfe die Zugriffsregeln.

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