Claude / Claude Code
Connect ScaleReach to claude.ai, Claude Desktop, Cowork, or the Claude Code CLI.
Prerequisites
- A ScaleReach API key (get one here)
claude.ai, Claude Desktop, Cowork (no install)
- Go to Settings → Connectors → Add custom connector (Pro/Max/Team/Enterprise; free plans get one custom connector)
- Name:
ScaleReach - Remote MCP server URL:
https://mcp.scalereach.ai/mcp/sr_live_YOUR_KEY_HERE - Leave OAuth fields empty, click Add
Replace sr_live_YOUR_KEY_HERE with your actual key - it authenticates you, no separate login step needed.
Claude Code CLI
claude mcp add --transport http scalereach https://mcp.scalereach.ai/mcp/sr_live_YOUR_KEY_HEREUse --scope project to share the server with your team via version control, or --scope user to use it in every project.
Manual config (Claude Desktop)
Edit your config file directly if you prefer:
{
"mcpServers": {
"scalereach": {
"url": "https://mcp.scalereach.ai/mcp/sr_live_YOUR_KEY_HERE"
}
}
}Config file locations:
- Mac:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Restart Claude after saving.
Try it
- "Clip this YouTube video and find the most viral moments: [url]"
- "Show me my recent videos"
- "Schedule my best clip to Instagram tomorrow at 3pm"
See all available commands and caption styles.
What you can do from Claude
Once Claude 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.
Claude 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 Claude 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 Claude, 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 Claude. See Authentication for how keys work.
Troubleshooting
- Claude: If the connector was added but its tools do not show up, remove it and add it again, then start a new conversation. With the Claude Code CLI, a server added with
--scope projectis stored in a file you commit, so use--scope userwhen the key is personal. Restart Claude Desktop after editing its config file. - 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 Claude 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.