copilot-studio-code

Ein lokaler MCP-Server, der einem Microsoft Copilot Studio-Agenten Tools im Claude-Code-Stil für das lokale Dateisystem und die Shell zur Verfügung stellt – lesen, bearbeiten, suchen und Befehle direkt aus dem Copilot Studio-Test-Canvas ausführen. Wird mit einer importierbaren Copilot Studio-Lösung geliefert, damit Sie in wenigen Minuten einen funktionierenden Agenten aufsetzen können.

Verfügbare Tools

Sicherheitsmodi (Auswahl beim Start)

Wie der Modus gewählt wird (in der Reihenfolge der Priorität):

1. SAFETY Umgebungsvariable (strict / moderate / open)

2. --safety <Modus> CLI-Flag

3. Interaktive Abfrage beim Start (10s Timeout → moderate)

Alle Aufrufe von write_file, edit_file und run_shell werden an <root>/.copilotstudio-mcp/audit.log angehängt.

Ausführen

npm install
npm start

Der Server gibt etwa Folgendes aus:

copilot-studio-code MCP server
  workspace root : E:\Dev\projects\my-project
  safety mode    : moderate
  listening on   : http://localhost:8787/mcp
  health check   : http://localhost:8787/healthz

Überschreiben Sie den Arbeitsbereich, auf dem er operiert:

$env:WORKSPACE_ROOT = "E:\Dev\some-other-project"; npm start

Einbindung in Copilot Studio

Copilot Studio ist Cloud-gehostet und kann daher localhost nicht erreichen. Verwenden Sie Microsoft Dev Tunnels, um den Server über HTTPS bereitzustellen.

1. Dev Tunnels installieren und anmelden

winget install Microsoft.devtunnel
devtunnel user login

2. Einen persistenten Tunnel für Port 8787 erstellen

devtunnel create copilotstudio-mcp --allow-anonymous
devtunnel port create copilotstudio-mcp -p 8787 --protocol http
devtunnel host copilotstudio-mcp

devtunnel host gibt eine öffentliche URL wie https://<id>-8787.usw2.devtunnels.ms aus. Lassen Sie diesen Prozess laufen.

Entfernen Sie --allow-anonymous, damit der Tunnel ein MS-Konto auf der Copilot Studio-Seite erfordert. Empfohlen, sobald alles funktioniert.

3. Den MCP-Server mit einem Copilot Studio-Agenten verbinden

Zwei Möglichkeiten: Importieren Sie die vorgefertigte Lösung (am schnellsten) oder konfigurieren Sie einen Agenten manuell.

Pfad A — Importieren der vorgefertigten Lösung

Der Ordner solution/ enthält eine nicht verwaltete Copilot Studio-Lösung mit einem vorkonfigurierten Agenten (generative Orchestrierung an, Inhaltsmoderation niedrig), einem benutzerdefinierten Connector für den MCP-Server und einem WorkspaceMCP-Thema, das die Tools für den Planer bereitstellt.

1. Öffnen Sie https://make.powerapps.com → Ihre Umgebung → Lösungen → Lösung importieren.

2. Laden Sie solution/CopilotStudioCode_1_0_0_0.zip hoch. Übernehmen Sie die Standardeinstellungen im Assistenten.

3. Öffnen Sie nach dem Import den benutzerdefinierten Connector Workspace MCP → Bearbeiten → ersetzen Sie auf der Registerkarte Allgemein den Platzhalter-Host YOUR-TUNNEL-ID-PORT.YOUR-REGION.devtunnels.ms durch Ihren echten Dev-Tunnel-Host (z. B. abc123-8787.usw2.devtunnels.ms). Speichern → Connector aktualisieren.

4. Öffnen Sie den importierten Agenten und fahren Sie mit Schritt 4 (Test-Canvas) fort.

Die Lösung enthält nicht den MCP-Server selbst – dieser läuft lokal aus diesem Repository. Der Connector verweist lediglich darauf.

Pfad B — Manuelle Konfiguration eines Agenten

1. Öffnen Sie Copilot Studio → Ihren Agenten → Tools → + Tool hinzufügen → Model Context Protocol.

2. Server-URL: https://<your-tunnel-id>-8787.usw2.devtunnels.ms/mcp

3. Authentifizierung: Keine (für den anonymen Tunnel) oder Microsoft Entra (für einen authentifizierten Tunnel).

4. Speichern. Copilot Studio ruft die Tool-Liste von /mcp ab und zeigt die sieben Tools an. Stellen Sie sicher, dass jedes Tool für den Agenten aktiviert ist.

5. Einstellungen → Generative KI → Orchestrierung: Generativ; Inhaltsmoderation: Niedrig. Ohne generative Orchestrierung wird der Planer keine MCP-Tools zuweisen.

4. Testen über das Test-Canvas

Öffnen Sie das Test-Canvas und versuchen Sie Prompts wie:

• "List the files in the workspace root."

• "Read package.json and tell me what scripts are defined."

• "Add a new script called lint that runs tsc --noEmit."

• "Run git status and summarize the result."

Der Agent wählt Tools anhand ihrer Namen aus den Beschreibungen in src/tools.ts aus – präzisieren Sie diese Beschreibungen, falls der Agent das falsche Tool wählt.

Projektstruktur

src/                                  the MCP server (TypeScript)
  index.ts                            entry: safety prompt + boot
  server.ts                           express + Streamable HTTP MCP transport
  tools.ts                            the seven tool registrations
  safety.ts                           mode definitions
  paths.ts                            workspace-root path jail
  audit.ts                            JSONL audit log
solution/                             importable Copilot Studio solution
  CopilotStudioCode_1_0_0_0.zip       agent + connector + topics (unmanaged)