From 8e60d5a827541dbb7b06a10f89b329c0f9f8ff7d Mon Sep 17 00:00:00 2001
From: James <james.russo@heygen.com>
Date: Mon, 27 Apr 2026 23:06:39 +0000
Subject: [PATCH] feat: reference HeyGen ChatGPT app for Codex plugin (replaces
 bundled MCP)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Per OpenAI directory feedback on openai/plugins#192: plugins in the
official Codex directory cannot bundle their own MCP server; they
must reference a curated ChatGPT app from the catalog. HeyGen has one
live (asdk_app_69418aad55e08191aa5e437b649ca2e4), so the upstream
.codex-plugin manifest now points at it.

Adds .app.json at repo root and swaps "mcpServers" → "apps" in
.codex-plugin/plugin.json. Same shape as canva and hubspot plugins
in openai/plugins.

Claude Code (.mcp.json) and Cursor (mcp.json) keep the bundled MCP
wiring — those marketplaces don't have the same restriction. Only
the Codex manifest changes.
---
 .app.json                 | 7 +++++++
 .codex-plugin/plugin.json | 2 +-
 2 files changed, 8 insertions(+), 1 deletion(-)
 create mode 100644 .app.json

diff --git a/.app.json b/.app.json
new file mode 100644
index 0000000..8ac6cc7
--- /dev/null
+++ b/.app.json
@@ -0,0 +1,7 @@
+{
+  "apps": {
+    "heygen": {
+      "id": "asdk_app_69418aad55e08191aa5e437b649ca2e4"
+    }
+  }
+}
diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
index c6b7f83..0525fbe 100644
--- a/.codex-plugin/plugin.json
+++ b/.codex-plugin/plugin.json
@@ -23,7 +23,7 @@
     "avatar-video"
   ],
   "skills": "./",
-  "mcpServers": "./.mcp.json",
+  "apps": "./.app.json",
   "interface": {
     "displayName": "HeyGen",
     "shortDescription": "Avatar videos and personalized video messages",