Canvas App MCP Relay for GPT

Этот проект предоставляет локальный Canvas Authoring MCP Server от Microsoft как удалённую MCP-конечную точку, которую можно разместить на Render.

Архитектура

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 не может напрямую редактировать ваше Canvas App, потому что процесс Microsoft Canvas Authoring MCP и сеанс Power Apps Studio работают на вашем компьютере. Поэтому локальный мост необходим во время разработки.

Related MCP server: OpenClaw MCP Proxy

1. Предварительные требования Power Apps

• Откройте целевое Canvas App в Power Apps Studio.

• Включите Settings -> Updates -> Coauthoring.

• Держите вкладку Studio открытой во время работы.

• Ваша учётная запись Microsoft должна иметь разрешение на редактирование приложения.

2. Локальные требования

• Node.js 20+

• .NET 10 SDK

• dnx доступен из .NET 10 SDK

Проверка:

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

Локальный мост запускает сервер Microsoft с помощью:

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

Для обычного интерактивного процесса Canvas Authoring не требуется ни регистрация приложения Azure, ни секрет клиента.

3. Развёртывание на Render

Отправьте эту папку на GitHub, затем создайте Render Web Service из репозитория или используйте render.yaml.

Требуемые переменные окружения Render:

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

Сгенерируйте токен локально, например:

openssl rand -hex 32

После развёртывания ваши конечные точки будут выглядеть так:

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

4. Запуск локального моста

На вашей машине разработки:

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

Мост запускает сервер Microsoft Canvas MCP, при необходимости анализирует CANVAS_STUDIO_URL, подключается к сеансу совместного редактирования этого приложения, обнаруживает активные инструменты MCP и регистрирует их в Render. Интерфейс входа в Microsoft по-прежнему остаётся локальным для вашей машины.

Если вы предпочитаете подключиться позже через GPT, опустите CANVAS_STUDIO_URL; проксированный инструмент connect остаётся доступным.

Проверка:

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

Вы должны увидеть такие инструменты, как connect, sync_canvas, compile_canvas, list_controls и list_data_sources.

5. Подключение Canvas App

Если вы указали CANVAS_STUDIO_URL при запуске моста, этот шаг выполняется автоматически. В противном случае, как только GPT увидит инструменты MCP, вызовите инструмент connect Canvas MCP со значениями из URL вашего Power Apps Studio:

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

Процесс Microsoft MCP работает локально, поэтому интерактивная аутентификация Microsoft/Entra происходит на вашей машине. Предпочитайте обычный поток браузера/брокера.

6. Подключение GPT

Используйте эту MCP-конечную точку:

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

Сервер принимает релейный токен либо как:

Authorization: Bearer <RELAY_TOKEN>

или, для клиентов, которые не могут настроить заголовок Authorization:

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

Параметр в строке запроса предоставлен для совместимости, но предпочтительнее использовать заголовок bearer, поскольку URL-адреса с большей вероятностью попадают в журналы/историю.

Важное ограничение ChatGPT

По состоянию на август 2026 года полные пользовательские действия MCP write/modify в ChatGPT доступны для рабочих пространств Business и Enterprise/Edu. Pro поддерживает только чтение/получение. Если ваш тарифный план ChatGPT не может вызывать инструменты записи, используйте ту же конечную точку Render MCP из приложения OpenAI API или другого полнофункционального MCP-клиента.

Безопасность

• Сначала используйте DEV/копию Canvas App.

• Не устанавливайте MCP_PUBLIC=true на развёртывании, доступном через интернет.

• Ротируйте RELAY_TOKEN, если он был раскрыт.

• Держите один локальный мост подключённым к одному процессу разработки Canvas одновременно.

• Держите вкладку Power Apps Studio открытой.

• После compile_canvas проверьте изменение в Studio и повторно синхронизируйте, прежде чем считать его сохранённым.

Текущие ограничения предварительной версии Microsoft

Функция Canvas Authoring MCP всё ещё находится в предварительной версии. Известные классы проблем, о которых сообщалось в 2026 году, включают:

• compile_canvas / sync_canvas иногда сообщают об успешной отправке, которая не сохранялась канонически.

• Проблемы с PCF-компонентами кода и Canvas Components.

• Большой YAML экрана, достигающий лимита компиляции на файл.

• Intel macOS (osx-x64) в настоящее время не имеет поддерживаемого пакета среды выполнения Canvas Authoring MCP.

• Повторные запросы входа в Entra после перезапуска процесса Microsoft MCP.

Устранение неполадок

/status сообщает bridgeConnected: false

Запустите npm run bridge на вашей машине и убедитесь, что REMOTE_URL и RELAY_TOKEN указаны правильно.

dnx не найден

Установите .NET 10 SDK и перезапустите терминал.

Canvas MCP запускается, но инструменты не работают

Проверьте:

1. Power Apps Studio открыт.

2. Совместное редактирование включено.

3. Инструмент connect был вызван с правильным идентификатором среды и идентификатором приложения.

4. Вы прошли аутентификацию с учётной записью, которая может редактировать приложение.

Intel Mac

В текущем пакете предварительной версии Microsoft есть открытая проблема для osx-x64. Используйте Apple Silicon, Windows x64/ARM64 или Linux x64/ARM64, пока Microsoft не выпустит недостающую среду выполнения.