GPT용 Canvas App MCP 릴레이

이 프로젝트는 Microsoft의 로컬 Canvas Authoring MCP Server를 Render에서 호스팅할 수 있는 원격 MCP 엔드포인트로 노출합니다.

아키텍처

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는 Microsoft Canvas Authoring MCP 프로세스와 Power Apps Studio 세션이 사용자 컴퓨터에 있기 때문에 Canvas App을 직접 편집할 수 없습니다. 따라서 작성 중에는 로컬 브리지가 필요합니다.

Related MCP server: OpenClaw MCP Proxy

1. Power Apps 사전 요구 사항

• Power Apps Studio에서 대상 Canvas App을 엽니다.

• Settings -> Updates -> Coauthoring을 활성화합니다.

• 작업하는 동안 Studio 탭을 열어 둡니다.

• Microsoft 계정에 앱 편집 권한이 있어야 합니다.

2. 로컬 사전 요구 사항

• Node.js 20+

• .NET 10 SDK

• .NET 10 SDK에서 제공되는 dnx

확인:

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 App Registration이나 클라이언트 시크릿이 필요하지 않습니다.

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 로그인 UI는 여전히 사용자 컴퓨터에서 로컬로 실행됩니다.

나중에 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 도구를 볼 수 있게 되면 Power Apps Studio URL의 값으로 Canvas MCP connect 도구를 호출하세요:

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>

쿼리 문자열 옵션은 호환성을 위해 제공되지만 URL이 로그/기록에 나타날 가능성이 더 높으므로 bearer 헤더가 선호됩니다.

중요한 ChatGPT 제한 사항

2026년 8월 기준, ChatGPT의 전체 사용자 지정 MCP 쓰기/수정 작업은 Business 및 Enterprise/Edu 워크스페이스에서 사용할 수 있습니다. Pro는 읽기/가져오기만 지원합니다. ChatGPT 요금제에서 쓰기 도구를 호출할 수 없는 경우, OpenAI API 애플리케이션이나 다른 전체 MCP 클라이언트에서 동일한 Render MCP 엔드포인트를 사용하세요.

안전

• 먼저 Canvas App의 DEV/복사본을 사용하세요.

• 인터넷에 노출된 배포에서 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 런타임 패키지가 현재 부재.

• Microsoft MCP 프로세스 재시작 후 반복적인 Entra 로그인 프롬프트.

문제 해결

/status에 bridgeConnected: false가 표시됨

컴퓨터에서 npm run bridge를 실행하고 REMOTE_URL과 RELAY_TOKEN이 올바른지 확인하세요.

dnx를 찾을 수 없음

.NET 10 SDK를 설치하고 터미널을 다시 시작하세요.

Canvas MCP는 시작되지만 도구가 실패함

다음을 확인하세요:

1. Power Apps Studio가 열려 있는지.

2. 공동 작성이 활성화되어 있는지.

3. connect 도구가 올바른 환경 ID와 앱 ID로 호출되었는지.

4. 앱을 편집할 수 있는 계정으로 인증했는지.

Intel Mac

Microsoft의 현재 미리 보기 패키지에는 osx-x64에 대한 공개 이슈가 있습니다. Microsoft가 누락된 런타임을 제공할 때까지 Apple Silicon, Windows x64/ARM64 또는 Linux x64/ARM64를 사용하세요.