mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-18 16:08:56 +00:00
docs(mcp): current ChatGPT and Claude setup steps, the hosted render's real output, and a first prompt that works (#7439)
* docs(mcp): current ChatGPT setup steps, and the hosted render's real output OpenAI moved custom MCP servers to Plugins > + > Add custom MCP server, on Business, Enterprise and Edu only. The hosted render takes no format or fps (render_video has a TODO to expose them), so the page no longer suggests asking for 30 fps, WebM or MOV there. * docs(mcp): connect from the claude directory, and name hyperframes in the first prompt HyperFrames by HeyGen is listed in Claude's connector directory. In a Claude.ai test on 6 Nov 2026, a request without "Use HyperFrames" made Claude write its own video code instead of calling the connector. * docs(mcp): where to switch the connector on in a chat
This commit is contained in:
+24
-15
@@ -20,9 +20,8 @@ account without installing the local CLI.
|
||||
poster="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/mcp-flow-demo-v2.jpg"
|
||||
/>
|
||||
|
||||
An illustration of the flow, labelled as such on screen — describe the video,
|
||||
revise it in plain language, ask for the format you need, and the render comes
|
||||
back. Nothing is installed locally.
|
||||
An illustration of the flow, labelled as such on screen: describe the video,
|
||||
revise it in plain language, and the MP4 comes back. Nothing is installed locally.
|
||||
|
||||
## Choose hosted or local
|
||||
|
||||
@@ -56,20 +55,29 @@ host documentation when its interface differs.
|
||||
|
||||
<Tabs>
|
||||
<Tab title="Claude">
|
||||
1. Open **Customize → Connectors**.
|
||||
2. Choose **Add custom connector** and enter the MCP address above.
|
||||
HyperFrames by HeyGen is listed in Claude's [connector directory](https://claude.com/connectors/hyperframes-heygen).
|
||||
|
||||
1. Open **Customize → Connectors** and choose **Discover**.
|
||||
2. Search **HyperFrames** and choose **Connect** on HyperFrames by HeyGen.
|
||||
3. Complete the HeyGen sign-in.
|
||||
4. In a new chat, open the **+** menu, choose **Connectors**, and enable HyperFrames.
|
||||
|
||||
If a chat doesn't use it, check that HyperFrames is switched on under **+ → Connectors** in that chat.
|
||||
|
||||
To add it by address instead, choose **+ Add → Add custom connector** in **Customize → Connectors** and enter the MCP address above.
|
||||
|
||||
See [Anthropic’s current connector instructions](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) for plan and workspace requirements.
|
||||
|
||||
</Tab>
|
||||
<Tab title="ChatGPT">
|
||||
If HyperFrames appears in **Settings → Apps**, choose **Connect** and complete HeyGen authorization.
|
||||
Custom MCP servers work on ChatGPT Business, Enterprise and Edu, on ChatGPT web. On Business, only workspace admins and owners can add one.
|
||||
|
||||
To add the MCP address as a custom app, an authorized user enables the host's developer mode, creates an app from the endpoint, scans the tools, and completes OAuth. Workspace admins may control publishing and action access.
|
||||
1. Open **Plugins**.
|
||||
2. Select the **+** button, then **Add custom MCP server**.
|
||||
3. Enter a name, and the MCP address above as the server URL.
|
||||
4. Set up authentication, accept the risk warning, and select **Create as a plugin**.
|
||||
5. Complete HeyGen authorization.
|
||||
|
||||
See [OpenAI’s current MCP app instructions](https://help.openai.com/en/articles/12584461-developer-mode-apps-and-full-mcp-connectors-in-chatgpt-beta).
|
||||
See [OpenAI’s current instructions](https://help.openai.com/en/articles/12584461).
|
||||
|
||||
</Tab>
|
||||
<Tab title="Grok">
|
||||
@@ -87,10 +95,11 @@ Host products change their connector interfaces independently. If a menu or butt
|
||||
|
||||
## Create a first composition
|
||||
|
||||
Describe the video as you would to an editor:
|
||||
Describe the video as you would to an editor, and name HyperFrames so the chat app uses the connector instead of
|
||||
writing its own video code:
|
||||
|
||||
```text
|
||||
Make a 15-second vertical product intro for a meditation app.
|
||||
Use HyperFrames to make a 15-second vertical product intro for a meditation app.
|
||||
Audience: people who have trouble falling asleep.
|
||||
Style: quiet, spacious, and warm.
|
||||
Show the breathing timer and end with “Rest starts here.”
|
||||
@@ -112,15 +121,15 @@ Make the captions smaller and slow down the final transition.
|
||||
|
||||
Name the visible problem and desired outcome. Avoid restarting the full brief for every revision.
|
||||
|
||||
## Render
|
||||
## Get the MP4
|
||||
|
||||
Ask for the destination you need:
|
||||
Each run renders an MP4 on its own when it finishes, so there is no separate export step. Ask for the download link:
|
||||
|
||||
```text
|
||||
Render this as an MP4 at 30 fps.
|
||||
Send me the MP4 download link.
|
||||
```
|
||||
|
||||
MP4 is the normal sharing format. WebM can be useful for web delivery and transparent overlays. MOV can be useful for another editing workflow.
|
||||
The hosted connector renders MP4 at its default settings. To choose the frame rate, 4K, or a WebM or MOV file (for transparent overlays or another editor), make the video with the [local skills](/quickstart) and render it on your computer.
|
||||
|
||||
The connector renders on hosted infrastructure. Keep any composition or render
|
||||
identifier the tool returns so you can refer to the same work in a follow-up.
|
||||
|
||||
Reference in New Issue
Block a user