Zum Hauptinhalt springen

Sally MCP mit GitHub Copilot in VS Code

Das Model Context Protocol (MCP) ist ein offener Standard, über den KI-Tools auf externe Datenquellen zugreifen können. Mit dem Microsoft 365 Agents Toolkit und GitHub Copilot Chat in Visual Studio Code kannst du den Sally MCP-Endpoint anbinden und Meetings, Zusammenfassungen und Transkripte direkt im Copilot-Chat-Agent-Modus abfragen, zum Beispiel um nachzuschlagen, was in einem Meeting entschieden wurde, offene Aufgaben zu prüfen oder ein Transkript parallel zu einer Aufgabe einzusehen.

Schnellnavigation

  1. Personal Access Token in Sally erstellen
  2. MCP-Verbindung in GitHub Copilot einrichten
  3. Zugriffsumfang
  4. Troubleshooting
Warum Visual Studio Code?

Das Microsoft 365 Agents Toolkit ist aktuell nur als Visual-Studio-Code-Extension verfügbar. Das ist eine Vorgabe von Microsoft, keine Einschränkung von Sally. Sollte Microsoft das Toolkit künftig für weitere IDEs anbieten, funktioniert das Setup auch dort.

Voraussetzungen
  • Visual Studio Code installiert.
  • Node.js (Version 18 oder neuer). Im Terminal mit node -v prüfen.
  • Microsoft 365 Agents Toolkit Extension installiert (im Extensions Marketplace nach Microsoft 365 Agents suchen).
  • GitHub Copilot Chat installiert mit einer aktiven GitHub Copilot-Lizenz.
  • Ein aktiver Sally-User mit Zugriff auf mindestens ein Unternehmenskonto.
  • Sally MCP aktiviert in deinem Unternehmenskonto (Admin-Einstellung).

1. Personal Access Token in Sally erstellen​

Ein Personal Access Token (PAT) ist der Schlüssel, mit dem sich der Copilot-Agent 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 in GitHub Copilot einrichten​

  1. Öffne Visual Studio Code.
  2. Klicke auf das Extensions-Icon in der Activity Bar (oder drücke Strg+Shift+X).
  3. Suche nach Microsoft 365 Agents.
  4. Installiere die Extension Microsoft 365 Agents Toolkit von Microsoft.
VS Code Extensions Marketplace mit der Extension Microsoft 365 Agents Toolkit von Microsoft
Microsoft 365 Agents Toolkit im Extensions Marketplace installieren
  1. Klicke in der linken Activity Bar auf das Microsoft 365 Agents Toolkit-Icon (M365-Logo).
  2. Klicke auf Create a New Agent/App.
Microsoft 365 Agents Toolkit Willkommensseite mit hervorgehobenem Button Create a New Agent/App
Auf Create a New Agent/App klicken
  1. Wähle Declarative Agent.
  2. Wähle Add an Action.
  3. Wähle Start with an MCP server.
Create an Action Dialog mit hervorgehobener Option Start with an MCP server
Start with an MCP server auswählen
  1. Bei der Frage nach dem MCP-Server-Typ Remote MCP server auswählen.
  2. Gib die Sally MCP-Endpoint-URL ein:
https://app.sally.io/api/v1/McpExternal
MCP Server URL Eingabefeld mit der Sally-Endpoint-URL
Sally MCP-Endpoint-URL eingeben
  1. Wähle einen Speicherort für das Projekt.
  2. Vergib einen Namen für den Agent (z. B. „Sally MCP“).
  3. Bestätigen. VS Code öffnet ein neues Fenster mit dem fertig angelegten Projekt.

Im neuen Projektfenster ist die Datei .vscode/mcp.json bereits geöffnet. Der Grundeintrag enthält keine Authentifizierung, daher musst du ihn ersetzen.

Ersetze den kompletten Inhalt der Datei .vscode/mcp.json durch:

{
  "servers": {
    "appsallyio": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.sally.io/api/v1/McpExternal",
        "--header",
        "Authorization: Bearer ${input:sally_pat}"
      ]
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "sally_pat",
      "description": "Sally Personal Access Token",
      "password": true
    }
  ]
}

Speichern mit Strg+S.

Warum mcp-remote?

Sally akzeptiert sowohl OAuth 2.1 als auch Bearer-Token. Diese Anleitung geht den Weg über den mcp-remote-Proxy mit einem Personal Access Token, weil er sich über alle Versionen von VS Code gleich verhält und den Token in der Secret Storage von VS Code ablegt. Wenn du lieber OAuth nutzt, trag stattdessen die URL https://app.sally.io/api/v1/McpExternal als HTTP-Server ein und lass VS Code die Autorisierung durchlaufen, siehe OAuth 2.1 mit Dynamic Client Registration.

  1. Im Editor erscheint über der Zeile "servers": { (Zeile 2) ein kleiner Start-Link. Klicke darauf.
VS Code Editor mit mcp.json und dem Start-Link über der servers-Zeile
Start-Link über der servers-Zeile anklicken
  1. Oben in VS Code erscheint ein Eingabefeld mit dem Text Sally Personal Access Token.
  2. Füge deinen kompletten Sally-Token ein (inklusive sally_user_mcp_-Präfix).
VS Code mit dem Sally Personal Access Token Eingabefeld oben
Sally-Token einfügen
  1. Drücke Enter.
Token-Sicherheit

Der Token wird sicher im VS Code Secret Storage abgelegt, nicht im Klartext in der Datei.

Nach dem Start sollte über "servers": { Folgendes stehen:

Running | Stop | Restart | 5 tools | More...
VS Code mit mcp.json im Running-Status und 5-Tools-Anzeige
Der MCP-Server läuft mit 5 Sally-Tools

Das bedeutet: die Verbindung steht und Sally hat 5 Tools bereitgestellt.

Falls stattdessen Error angezeigt wird:

  • Widerrufe den Token in Sally und erstelle einen neuen.
  • Klicke auf Restart und gib den neuen Token ein.

Du brauchst GitHub Copilot Chat installiert und musst mit einem GitHub-Account angemeldet sein, der eine Copilot-Lizenz hat.

  1. Drücke Strg+Alt+I, um GitHub Copilot Chat zu öffnen.
  2. Stelle unten am Eingabefeld den Modus auf Agent um.
  3. Klicke auf das Tools-Symbol (Schraubenschlüssel). Die Sally-Tools sollten in der Liste erscheinen.
  4. Aktiviere die gewünschten Sally-Tools per Häkchen.
  5. Teste mit einer Eingabe:

„Welche Sally-Tools sind verfügbar?“

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
Beim Start erscheint ein Dialog zu OAuth oder Dynamic Client RegistrationÄltere Versionen von VS Code zeigen das, wenn sie die Discovery nicht abschließen können. Klicke auf Cancel, der Bearer-Token-Header wird trotzdem korrekt verwendet. Sally selbst unterstützt Dynamic Client Registration, ein aktueller Client kann sich also auch per OAuth ohne Token verbinden.
Server bleibt im Status Waiting for server to respond...Der Token wird vom Server abgelehnt. Lösche den Token in Sally und lege einen neuen an unter app.sally.io.
401 Unauthorized in den LogsToken ungültig oder bereits gelöscht. Erstelle einen neuen Token und gib ihn beim Restart ein.
Agent-Modus nicht im Copilot Chat verfügbarDrücke Strg+Shift+P und führe Chat: Switch to Agent Mode aus. Falls nicht verfügbar, prüfe deine GitHub Copilot-Lizenz.
Tools liefern leere ErgebnisseStelle sicher, dass der Sally-User hinter dem PAT zugängliche Meetings hat. Prüfe die Zugriffsregeln.

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