# Add Framehood to Claude.ai Framehood plugs straight into Claude — the `image`, `video`, `audio`, `qa` and `files` tools appear right inside your chats, so you can ask Claude to make a poster, cut a clip, or add a voiceover and it calls Framehood for you. There are two ways to add it: the **plugin** (recommended) or a plain **custom connector**. Either way there's **no API key to copy** — sign-in is through your browser (OAuth). ## Video walkthrough A short screen recording that installs Framehood and gets it working in Claude: ## Install the plugin (recommended) The best way to use Framehood with Claude is the **Framehood plugin** — it works everywhere Claude does: the web, the desktop app, and your phone. The plugin bundles the connection plus **skills** that teach Claude the whole toolset, the per-model prompting best-practices, and video-montage craft, so generation works natively with nothing to wire up. Install it **as shown in the video above** — the marketplace address to add is: ``` Framehood/framehood-plugin ``` It's completely safe: the plugin is [**open source**](https://github.com/Framehood/framehood-plugin), so you can read exactly what it ships. Prefer the terminal? The two install commands for Claude Code are on the [Claude Code](/guide/plugin) page. **Don't forget to authorize after installing.** Connect Framehood and sign in with your account when Claude prompts (in Claude Code, run `/mcp` → **framehood** → **Authenticate**). Until you do, the tools stay locked. Prefer the lightest setup? You can add **[just the connector](#add-the-connector-pro-max-free)** below instead — it pulls in no extra resources, though we still recommend the plugin. ## Tips for working with Framehood in Claude Framehood is a **tool** — and you're teaching your Claude to use it well. Your Claude is what holds the knowledge and your preferences, so a little guidance goes a long way. - **Pick a specific model.** By default Framehood chooses a model for each job. Want a particular one? Ask Claude to **list the available models**, then tell it explicitly which to use — it can pass any parameters that model supports. - **Teach Claude your style.** Framehood already knows the basics of editing and montage — cuts, pacing, continuity. But you can teach your Claude the approaches that suit *you*: just ask it to **remember how you like to work**, and it keeps that for next time. - **Ask to see the intermediate steps.** Claude aims to hand you a finished clip in one go. If you'd rather review each stage, ask it to **show every intermediate result**. - **Keep it current.** Framehood is under active development, so the resources in the plugin — and the models themselves — keep improving. Ask Claude to **check for updates** to the plugin and the connector from time to time. - **Send feedback.** Any errors surface right in your chat. Want to flag a bug or suggest something to the team? Just ask Claude to **send feedback** — it delivers your message to the developers without you leaving the chat. ::: tip Turn on memory For Claude to remember your preferences and reference earlier chats, enable **memory** and **search across chats** in Claude's settings. ::: ## Add the connector (Pro, Max, Free) For an individual account: 1. Open **Settings → Customize → Connectors**. 2. Click **+**, then **Add custom connector**. 3. In **Remote MCP server URL**, paste `https://mcp.framehood.ai/mcp`. 4. Leave **Advanced settings** (OAuth Client ID / Secret) **empty** — Framehood registers your client automatically. Click **Add**. 5. The Framehood connector appears. Click **Connect** and approve the sign-in in the browser tab that opens. ::: tip Plans Custom connectors work on **Free, Pro, Max, Team, and Enterprise**. Free accounts are limited to one custom connector. ::: ## Add the connector (Team / Enterprise) An **owner** adds it once for the organization, then each member connects: **Owner — configure it:** 1. Go to **Settings → Organization settings → Connectors**. 2. Click **Add**, hover **Custom**, and choose **Web**. 3. Paste `https://mcp.framehood.ai/mcp` (leave the Advanced OAuth fields empty). 4. Click **Add**. **Each member — connect it:** 1. Open **Settings → Customize → Connectors**. 2. Find **Framehood** (marked *Custom*) and click **Connect**. 3. Approve the browser sign-in. ## After connecting - Every call is billed to the **same account and credits** as the CLI, REST API and the [Console](https://framehood.ai/app). See [Credits & plans](/guide/billing). - Not seeing the tools? Make sure the connector shows **Connected** and is toggled on for that chat. ## Troubleshooting **The tools don't appear in a chat.** The connector isn't on for that conversation. Click **+** next to the message box → **Connectors** and toggle **Framehood** on; make sure it shows **Connected** in **Settings → Connectors**. **It keeps asking you to sign in, or a sign-in loop.** Re-connect: **Settings → Connectors → Framehood → Connect**, and finish the browser sign-in fully. There's no API key — it's all OAuth. **The sign-in tab never opens.** Your browser blocked the pop-up. Allow pop-ups for claude.ai and click **Connect** again. **"You can only add one custom connector."** Free accounts allow a single custom connector — remove another one or upgrade your plan. **"Insufficient credits" or a job is refused.** You're out of credits. Top up or check your plan in the [Console](https://framehood.ai/app) — see [Credits & plans](/guide/billing). **A video job looks stuck.** Long jobs take minutes and Claude polls them — just ask "check the status" for progress. **Installing the plugin instead?** See the Claude Code [troubleshooting](/guide/plugin#troubleshooting) for `/mcp` and `/plugin` fixes. ## Notes - **No API key.** Authentication is OAuth 2.1 (PKCE + Dynamic Client Registration); the token is scoped to `mcp.framehood.ai`. - **Public reachability.** Claude connects from Anthropic's cloud, not your device — Framehood is on the public internet, so it just works. - Prefer the terminal or an editor instead? See the [MCP server](/guide/mcp) guide for Claude Code, Cursor, and generic clients, or the [Claude Code](/guide/plugin) plugin which bundles this server. Next: browse the [tools reference](/reference/tools) and the [model catalog](/reference/models/).