ChatGPT / Codex
Connect ScaleReach to ChatGPT connectors or the Codex CLI.
Prerequisites
- A ScaleReach API key (get one here)
ChatGPT (web/app)
Full MCP with write/modify actions is currently documented for supported Business and Enterprise/Edu workspaces. Pro users may have more limited MCP access for read/fetch tools.
- Enable Developer mode in your ChatGPT workspace or user settings.
- Open Settings → Apps → Create. Workspace admins can use Workspace settings → Apps → Create.
- App name:
ScaleReach - MCP server URL:
https://mcp.scalereach.ai/mcp/sr_live_YOUR_KEY_HERE - Choose the authentication mechanism and select no authentication because the ScaleReach API key is embedded in the URL.
- Scan the tools, then click Create. An admin may need to publish or enable the app before it appears in chats.
ScaleReach's clip and scheduling tools are write/action tools. ChatGPT requires developer mode and the appropriate workspace permissions before those tools can be called.
After the app is enabled, select ScaleReach from the chat's tools menu before asking it to do something.
Codex CLI
Add to ~/.codex/config.toml (or your project's .codex/config.toml):
[mcp_servers.scalereach]
url = "https://mcp.scalereach.ai/mcp/sr_live_YOUR_KEY_HERE"Codex picks this up on the next session start.
Try it
- "Clip this YouTube video, find the funniest moments: [url]"
- "What videos do I have in my workspace?"
See all available commands and caption styles.
What you can do from ChatGPT or Codex
Once ChatGPT or Codex is connected, you work in plain language and it calls ScaleReach for you. Clipping requests cover submitting a YouTube link, checking processing status, listing the clips that were generated, getting a download link for a clip, reprocessing a video with different settings, and deleting a video together with its clips. Scheduling requests cover listing your connected social accounts, scheduling a post for later, posting immediately, editing a pending post's caption, rescheduling it, and cancelling it.
ChatGPT or Codex will ask for the same choices as any other client: genre, aspect ratio (9:16, 16:9 or 1:1), clip length, caption style and any custom focus. A 30-minute video usually takes 3 to 5 minutes to process, so ask ChatGPT or Codex to check the status rather than expecting clips at once. Download links returned for clips are signed and last one hour, so ask for a new link if one has expired. See all available commands and caption styles for the full list.
Keep your API key private
The key is part of the URL you pasted into ChatGPT or Codex, so anyone who sees the URL can use your workspace and spend your processing minutes. Do not paste the URL into public chats, screenshots, issues or commits. A key is limited to the workspace it was created in. If a key leaks, open Workspace Settings → API Keys in the dashboard, delete it, and create a new one; then update the URL in ChatGPT or Codex. See Authentication for how keys work.
Troubleshooting
- ChatGPT or Codex: In ChatGPT, Developer mode must be on, the app must be created with no authentication, and an admin may still need to publish it before it appears in chats. Select ScaleReach from the tools menu of the chat before asking. In Codex, restart the session after editing
config.toml; a project-level.codex/config.tomlcan be committed by accident, so prefer the one in your home folder for a personal key. - The server connects but every call fails with 401: the key is wrong, expired or was deleted. A valid key starts with
sr_live_followed by 48 hex characters, and the URL must be exactlyhttps://mcp.scalereach.ai/mcp/followed by the key with no spaces or line breaks. - A call fails with 402: the workspace has run out of processing minutes. Add minutes or change plan in the dashboard.
- Clips are not ready yet: the video is still processing. Ask ChatGPT or Codex for the status again in a minute or two.
- Scheduling fails: connect at least one social account first, from Social → Connect Account in the dashboard.