Setup guide

Connect Clipzing to your agent

Your agent gets the controls. The skills teach it how to use them well.

  • About 2 minutes
  • No API key to copy
  • 9 apps supported

Which app are you using?

In a browserNo install needed
On your computerSmall one time install
Claude Desktop

Add the MCP server

  1. 1

    Install uv (one time)

    Clipzing's MCP server runs through uv, which does not ship with macOS. Skip this if you already have it.

    Terminal
    curl -LsSf https://astral.sh/uv/install.sh | sh

    Then open a new terminal window so it is on your PATH.

  2. 2

    Open the config file

    File to open
    ~/Library/Application Support/Claude/claude_desktop_config.json

    In the app you can also reach it via Settings → Developer → Edit Config. That opens this exact file.

    If the file does not exist, create it. That is normal on a fresh install. Make the folder too if it is missing, then paste the block below as the whole file.

  3. 3

    Paste this in

    Whole file, if it was empty
    json
    {
      "mcpServers": {
        "clipzing": {
          "command": "uvx",
          "args": ["clipzing-mcp"]
        }
      }
    }

    Already have other MCP servers in there?

    Do not replace the file. Add only the "clipzing" line inside your existing "mcpServers" block, and keep the comma rules of JSON: every entry except the last needs a trailing comma. A stray or missing comma makes the app silently load no servers at all.

  4. 4

    Restart the app

    Quit Claude completely and reopen it. A window reload is not enough.

  5. 5

    Approve the connection in your browser

    The first time your agent uses Clipzing, your terminal or the app log shows a short code and a browser tab opens at clipzing.com/link. Sign in if you are not already, check the code matches, and choose what the agent may do.

    Reading is the default

    Editing, rendering and publishing are separate opt-ins, and deleting or publishing always asks you again at the moment it happens. The credential is stored in your computer's keychain, not in the file you just edited, and you can revoke it any time under Billing, API keys.

  6. 6

    Check that it worked

    Ask your agent:

    List my Clipzing clips

    If it answers with your clips, you are done. If it says it has no such tool, see troubleshooting.

Add the skills

Optional, recommended

The MCP server gives your agent the controls. The skills tell it how an experienced editor uses them: where to cut, what makes a hook work, how to judge a clip before publishing. Without them the agent can still do everything, it just decides less well.

Skills are an open standard (agentskills.io), so the same files work in Claude Code, Cursor, Windsurf and Zed. Only the folder differs.

Using skills with Claude Desktop

Claude Desktop loads skills through your Claude account rather than a folder on disk, and we have not verified that upload flow well enough to walk you through it. The reliable route today is Claude Code, which reads ~/.claude/skills/. Pick "Claude Code" above for the exact folder and a one-line install.

Try these first

  • Suggest better titles for my last clip
  • Add B-roll to the clip about pricing
  • Schedule my top 3 clips for next week
  • Show me the transcript around that quote

If something did not work

"uvx: command not found"

uv is not installed, or your terminal has not picked it up yet. Run the install command from step 1 and then open a NEW terminal window, because the old one still has the old PATH.

The agent says it has no Clipzing tools

Almost always the restart. Quit the app completely rather than reloading the window, and start a fresh session. If it still shows nothing, your JSON has a syntax error: a missing or extra comma makes the app load no servers at all rather than complain.

No browser tab opened, or I missed it

The code lasts 10 minutes. Go to clipzing.com/link and type the code shown in your terminal, or just restart your agent to get a fresh one.

It says it is connected but has no Clipzing tools

The app caches the tool list from the moment you added the connector. If it was added while something was failing, it stored "zero tools" and will not re-check on its own. Remove the connector and add it again, which is the only thing that makes it re-read the list. Everything else, including your sign-in, is unaffected.

"Agent access is not included on your current plan"

Agent access is a paid feature. Starter covers reading and editing; Pro adds rendering and publishing.

It can read but refuses to change anything

The connection was approved read-only. Restart your agent to pair again and tick the extra permissions, or check what your plan allows under Billing, API keys.