Canvas App MCP Relay für GPT

Dieses Projekt stellt Microsofts lokalen Canvas Authoring MCP Server als entfernten MCP-Endpunkt bereit, der auf Render gehostet werden kann.

Architektur

GPT / MCP client
      |
      | Streamable HTTP
      v
Render: canvas-mcp-relay
      |
      | authenticated WebSocket
      v
Your computer: local-bridge.js
      |
      | stdio
      v
Microsoft.PowerApps.CanvasAuthoring.McpServer
      |
      v
Power Apps Studio coauthoring session

Render kann Ihre Canvas App nicht direkt bearbeiten, da der Microsoft Canvas Authoring MCP-Prozess und die Power Apps Studio-Sitzung auf Ihrem Computer laufen. Die lokale Brücke ist daher während der Bearbeitung erforderlich.

Related MCP server: OpenClaw MCP Proxy

1. Power Apps-Voraussetzungen

• Öffnen Sie die Ziel-Canvas-App in Power Apps Studio.

• Aktivieren Sie Settings -> Updates -> Coauthoring.

• Lassen Sie die Studio-Registerkarte während der Arbeit geöffnet.

• Ihr Microsoft-Konto muss über Bearbeitungsberechtigung für die App verfügen.

2. Lokale Voraussetzungen

• Node.js 20+

• .NET 10 SDK

• dnx verfügbar aus dem .NET 10 SDK

Überprüfen Sie:

node --version
dotnet --list-sdks
dnx --help

Die lokale Brücke startet Microsofts Server mit:

dnx Microsoft.PowerApps.CanvasAuthoring.McpServer --yes --prerelease --source https://api.nuget.org/v3/index.json

Für den normalen interaktiven Canvas Authoring-Ablauf ist keine benutzerdefinierte Azure App-Registrierung oder kein Client Secret erforderlich.

3. Auf Render bereitstellen

Schieben Sie diesen Ordner auf GitHub, erstellen Sie dann einen Render-Webdienst aus dem Repository oder verwenden Sie render.yaml.

Erforderliche Render-Umgebungsvariablen:

RELAY_TOKEN=<long-random-secret>
MCP_PUBLIC=false
BRIDGE_REQUEST_TIMEOUT_MS=120000

Generieren Sie lokal einen Token, zum Beispiel:

openssl rand -hex 32

Nach der Bereitstellung sehen Ihre Endpunkte wie folgt aus:

https://YOUR-SERVICE.onrender.com/health
https://YOUR-SERVICE.onrender.com/mcp
wss://YOUR-SERVICE.onrender.com/bridge

4. Führen Sie die lokale Brücke aus

Auf Ihrem Entwicklungsrechner:

npm install
CANVAS_STUDIO_URL='PASTE_THE_FULL_POWER_APPS_STUDIO_URL_HERE' \
REMOTE_URL=wss://YOUR-SERVICE.onrender.com/bridge \
RELAY_TOKEN=YOUR_RENDER_RELAY_TOKEN \
npm run bridge

Die Brücke startet den Microsoft Canvas MCP-Server, analysiert optional CANVAS_STUDIO_URL, verbindet sich mit der Coauthoring-Sitzung dieser App, erkennt die Live-MCP-Tools und registriert sie bei Render. Die Microsoft-Anmeldeoberfläche bleibt lokal auf Ihrem Rechner.

Wenn Sie sich später über GPT verbinden möchten, lassen Sie CANVAS_STUDIO_URL weg; das proxierte connect-Tool bleibt verfügbar.

Überprüfen Sie:

curl -H "Authorization: Bearer YOUR_RENDER_RELAY_TOKEN" \
  https://YOUR-SERVICE.onrender.com/status

Sie sollten Tools wie connect, sync_canvas, compile_canvas, list_controls und list_data_sources sehen.

5. Verbinden Sie die Canvas App

Wenn Sie CANVAS_STUDIO_URL beim Start der Brücke angegeben haben, ist dieser Schritt automatisch. Andernfalls rufen Sie, sobald GPT die MCP-Tools sehen kann, das Canvas MCP connect-Tool mit Werten aus Ihrer Power Apps Studio-URL auf:

environment_id: Default-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
app_id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
environment_category: prod

Der Microsoft-MCP-Prozess läuft lokal, daher erfolgt die interaktive Microsoft/Entra-Authentifizierung auf Ihrem Rechner. Bevorzugen Sie den normalen Browser-/Broker-Ablauf.

6. GPT verbinden

Verwenden Sie diesen MCP-Endpunkt:

https://YOUR-SERVICE.onrender.com/mcp

Der Server akzeptiert das Relay-Token entweder als:

Authorization: Bearer <RELAY_TOKEN>

oder, für Clients, die keinen Authorization-Header konfigurieren können:

https://YOUR-SERVICE.onrender.com/mcp?token=<RELAY_TOKEN>

Die Query-String-Option wird aus Kompatibilitätsgründen bereitgestellt, aber ein Bearer-Header wird bevorzugt, da URLs eher in Logs/Verlauf auftauchen.

Wichtige ChatGPT-Einschränkung

Stand August 2026 sind vollständige benutzerdefinierte MCP-Schreib-/Änderungs-Aktionen in ChatGPT für Business- und Enterprise/Edu-Arbeitsbereiche verfügbar. Pro unterstützt nur Lesen/Abrufen. Wenn Ihr ChatGPT-Plan keine Schreib-Tools aufrufen kann, verwenden Sie denselben Render-MCP-Endpunkt aus einer OpenAI-API-Anwendung oder einem anderen vollständigen MCP-Client.

Sicherheit

• Verwenden Sie zuerst eine DEV-/Kopie der Canvas App.

• Setzen Sie MCP_PUBLIC=true nicht auf einer internetzugänglichen Bereitstellung.

• Rotieren Sie RELAY_TOKEN, wenn er offengelegt wurde.

• Halten Sie jeweils eine lokale Brücke mit einem Canvas-Authoring-Prozess verbunden.

• Lassen Sie die Power Apps Studio-Registerkarte geöffnet.

• Überprüfen Sie nach compile_canvas die Änderung in Studio und synchronisieren Sie erneut, bevor Sie sie als dauerhaft betrachten.

Aktuelle Microsoft-Preview-Einschränkungen

Das Canvas Authoring MCP-Feature befindet sich noch in der Vorschau. Bekannte Problemklassen, die 2026 gemeldet wurden, umfassen:

• compile_canvas / sync_canvas melden manchmal einen erfolgreichen Push, der nicht kanonisch persistiert wurde.

• Probleme mit PCF-Codekomponenten und Canvas-Komponenten.

• Große Bildschirm-YAML erreicht ein Kompilierungslimit pro Datei.

• Intel-macOS (osx-x64) verfügt derzeit nicht über ein unterstütztes Canvas Authoring MCP-Laufzeitpaket.

• Wiederholte Entra-Anmeldeaufforderungen nach dem Neustart des Microsoft-MCP-Prozesses.

Fehlerbehebung

/status meldet bridgeConnected: false

Führen Sie npm run bridge auf Ihrem Rechner aus und stellen Sie sicher, dass REMOTE_URL und RELAY_TOKEN korrekt sind.

dnx nicht gefunden

Installieren Sie das .NET 10 SDK und starten Sie das Terminal neu.

Canvas MCP startet, aber Tools schlagen fehl

Bestätigen Sie:

1. Power Apps Studio ist geöffnet.

2. Coauthoring ist aktiviert.

3. Das connect-Tool wurde mit der korrekten Umgebungs-ID und App-ID aufgerufen.

4. Sie haben sich mit einem Konto authentifiziert, das die App bearbeiten kann.

Intel Mac

Microsofts aktuelles Preview-Paket hat ein offenes Problem für osx-x64. Verwenden Sie Apple Silicon, Windows x64/ARM64 oder Linux x64/ARM64, bis Microsoft die fehlende Laufzeit bereitstellt.