> ## Documentation Index
> Fetch the complete documentation index at: https://help.opus.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# OpusClip Claude Connector

Automate your OpusClip workspace from Claude.ai: browse projects and clips, pull transcripts, organize collections, export HD downloads, and schedule posts to connected social accounts — all from natural-language prompts.

Endpoint:

```
https://api.opus.pro/api/mcp
```

<Note>
  The Claude Connector does not support media generation. It exposes no image, video, or audio generation tools. If you need thumbnail generation — or you are configuring an IDE or CLI host such as Cursor, Cline, or Claude Code — use the [MCP Server](/api-reference/agent-setup) instead.
</Note>

Any OpusClip account can complete the OAuth flow and view the tool catalog. Calling a tool requires **Pro Beta**, **Max**, or **Business** plan access; without it, the host returns an upgrade prompt. See [Limitations](/api-reference/limitation) for the plan caps.

## Install

**From the connector directory** *(coming soon)* — once OpusClip is listed in the Claude.ai connector directory, open **Settings → Connectors**, find **OpusClip**, click **Add**, and complete the OAuth sign-in.

<Note>
  Directory listing is in progress. Until it is live, use the custom-connector steps below. The endpoint and behaviour are identical.
</Note>

**As a custom connector**

* Open **[claude.ai/customize/connectors](https://claude.ai/customize/connectors)** and click **Add custom connector**.
* Paste `https://api.opus.pro/api/mcp`, name the connector `OpusClip`, and click **Connect**.
* Sign in with your OpusClip account in the OAuth window.
* Start a new conversation and try `List my recent OpusClip projects`.

For users in more than one OpusClip org, the connector defaults to the first org with API access. To target a different org, ask the agent to list your orgs and select one; the choice applies to subsequent requests in the same conversation.

## Tool catalog

The connector exposes the 27 workflow tools below.

<AccordionGroup>
  <Accordion title="Read tools (13) — no approval prompt">
    * `opusclip_whoami` — identity check for the connected org
    * `opusclip_get_usage` — show the org's current API usage against its cap
    * `opusclip_list_projects` — list recent clip projects
    * `opusclip_list_clips` — list clips inside a project
    * `opusclip_describe_clip` — fetch a single clip's detail (transcript, layout, render status)
    * `opusclip_list_collections` — list collections
    * `opusclip_list_clips_in_collection` — list clips inside a collection
    * `opusclip_list_brand_templates` — list brand templates
    * `opusclip_list_social_accounts` — list connected social accounts
    * `opusclip_list_scheduled_posts` — list scheduled and recent posts (returns the `schedule_id` that unscheduling requires)
    * `opusclip_get_editing_script` — fetch a clip's editing script
    * `opusclip_get_transcript` — fetch a project's source-video transcript
    * `opusclip_get_social_copy_job` — fetch a social copy job
  </Accordion>

  <Accordion title="Write tools (14) — approval prompt per call">
    * `opusclip_submit_project` — clip a YouTube or Vimeo URL · consumes credits
    * `opusclip_create_upload_link` — get a signed URL to upload a local video
    * `opusclip_apply_editing_script` — modify a clip and re-render · consumes credits
    * `opusclip_create_censor_job` — bleep or mask flagged content · consumes credits
    * `opusclip_share_project` — make a project publicly viewable
    * `opusclip_create_collection` — create a collection
    * `opusclip_add_clip_to_collection` — add a clip to a collection
    * `opusclip_export_clip` — get one clip's HD download URL (ready / rendering / unavailable)
    * `opusclip_export_collection` — get HD download URLs for every clip in a collection
    * `opusclip_duplicate_clip` — copy a clip to `<title> (Copy)`; free, no re-render
    * `opusclip_create_social_copy_job` — generate platform-specific social copy
    * `opusclip_create_post_task` — post a clip to a connected social account
    * `opusclip_schedule_publish` — schedule a clip for future posting
    * `opusclip_unschedule_publish` — cancel a previously scheduled post
  </Accordion>
</AccordionGroup>

`list_clips` and `describe_clip` return **preview** URLs only — the HD download URL comes from `export_clip` (one clip) or `export_collection` (a collection).

## Try it

**Get clips from a video**

> Clip this YouTube video and give me the top 5 best clips
> `https://youtube.com/watch?v=...`

**Inline edits**

> Fix the typo in caption 4 of clip 3.

**Publish**

> Schedule my latest clip to post tomorrow at 9am.

## Troubleshooting

<AccordionGroup>
  <Accordion title="OAuth fails or returns 'No matching client'">
    Sign in with the same identity provider used to create the OpusClip account (email, Google, or Apple).
  </Accordion>

  <Accordion title="Tools return 'API access not enabled for this org'">
    The org does not have the API entitlement. Pro Beta and Max orgs receive it automatically. Otherwise, [contact sales](https://www.opus.pro/contact-api).
  </Accordion>

  <Accordion title="Which org does the connector use for a multi-org user?">
    The first org with API access. To target a different org, ask the agent to list your orgs and select one; the choice applies for subsequent requests in the same conversation.
  </Accordion>

  <Accordion title="401 errors keep firing">
    Hosts refresh tokens automatically. If refresh fails persistently, remove the connector and re-add it.
  </Accordion>

  <Accordion title="403 or 429 responses">
    `403` indicates the monthly cap (`15h` / `900` credits per workspace) has been hit. The cap resets on the first day of the next month (UTC). `429` indicates the concurrent-project limit (`4`) has been hit and clears as in-flight projects finish. See [Limitations](/api-reference/limitation).
  </Accordion>
</AccordionGroup>

Tools consume credits and inherit the Pro Beta & Max caps (`15h` monthly, `10`-credit per-project floor, `4` concurrent projects). See [Limitations](/api-reference/limitation).

## What's next

* Using Cursor, Cline, Claude Code, or another MCP host? See the [MCP Server](/api-reference/agent-setup).
* Prefer an API-key code package? See the [Skill](/api-reference/skill).
* Need higher limits? [Contact sales](https://www.opus.pro/contact-api).