---
title: Use Splice in Claude, ChatGPT, Claude Code and Codex
description: "Connect Splice to Claude (claude.ai and Claude Desktop), ChatGPT, Claude Code and Codex over MCP: step-by-step setup, what each plan supports, example prompts, credits and how to disconnect."
url: "https://splice.film.fun/connect.md"
canonical: "https://splice.film.fun/connect"
updated: 2026-10-09
---
# Use Splice in Claude, ChatGPT, Claude Code and Codex

Splice is film.fun's AI filmmaking studio. Connect it to your AI assistant and ask for images, video, voice and music in plain words. The assistant works on your Splice account: what it makes appears in your dashboard, and generations spend your credits.

Splice connects over MCP (Model Context Protocol). Every assistant on this page uses the same server address:

```text
https://splice.film.fun/api/mcp
```

## Before you start

- **A film.fun account.** Sign up at https://splice.film.fun/signup. New accounts get 100 free credits.
- **Sign-in.** Claude, ChatGPT, Claude Code and Codex sign you in with OAuth: you log in with your film.fun account and click Allow. There's no key to paste, and you never type your password into the assistant.
- **Agent keys (optional).** For scripts, servers or a headless setup, create an `sk_` key at https://splice.film.fun/dashboard/api-keys and send it as a bearer token instead.
- **Permissions.** Splice asks for two scopes: `splice:read` (see your productions, media, balance and prices) and `splice:generate` (create and edit media, which spends credits).

| Assistant | How you add Splice | Sign-in | Plans |
|---|---|---|---|
| Claude (claude.ai, Claude Desktop) | Custom connector | OAuth | Free (one custom connector), Pro, Max, Team, Enterprise |
| ChatGPT | Custom MCP app | OAuth | Business, Enterprise and Edu for all tools; Pro for `search` and `fetch` only |
| Claude Code | `claude mcp add` | OAuth or agent key | Any Claude Code install |
| Codex | `codex mcp add` or `config.toml` | OAuth or agent key | Codex CLI, IDE extension and app |
| Cursor, VS Code | One-click install | OAuth | See [the developer portal](https://splice.film.fun/developers#quickstart-mcp) |

## Claude (claude.ai and Claude Desktop)

**Plans.** Custom connectors work on Free (one custom connector), Pro, Max, Team and Enterprise. On Team and Enterprise, an owner adds Splice first under Organization settings → Connectors, and members then connect to it. Claude Desktop uses the connectors on your Claude account, so you add Splice once.

**Steps.**

1. In Claude, open **Customize → Connectors**. On some accounts this is **Settings → Connectors**.
2. Click **+ Add**, then **Add custom connector**.
3. Fill in the form:
   - Name: `Splice`
   - Remote MCP server URL: `https://splice.film.fun/api/mcp`
   - Leave any OAuth client ID and secret empty. Claude registers itself with Splice.
4. Click **Add**, then **Connect**. Splice opens: sign in with your film.fun account, check that the page names Claude, and click **Allow**.
5. In a chat, click **+** at the bottom left, choose **Connectors**, and turn Splice on.

**Connectors directory.** Splice has been submitted to Claude's Connectors directory. Once it's listed there, you'll be able to add it from the directory without typing the URL. Until then, use the steps above.

## ChatGPT

**Plans.** OpenAI documents custom MCP apps like this, and the details change often, so check what your account shows:

- Business, Enterprise and Edu get full MCP: Splice's read tools and its generate tools. On Business, only an admin or owner can turn on developer mode.
- Pro can connect MCP servers with read and fetch only, which means Splice's `search` and `fetch` tools.

**Steps.** Menu names vary between accounts and change as ChatGPT updates.

1. Open the place where ChatGPT adds custom MCP servers:
   - On newer accounts, open **Plugins** (chatgpt.com/plugins), click **+**, then **Add custom MCP server**.
   - On other accounts, open **Settings → Apps → Advanced settings**, turn on **Developer mode**, then click **Create app**.
2. Fill in the form:
   - Name: `Splice`
   - MCP server URL: `https://splice.film.fun/api/mcp`
   - Authentication: **OAuth**. Leave the client ID and secret empty, because ChatGPT registers itself.
3. Review the warning, select **I understand and want to continue**, and create the app.
4. ChatGPT sends you to Splice. Sign in with your film.fun account, check that the page names **ChatGPT** and that you'll go back to **chatgpt.com**, then click **Allow**.
5. In a chat, pick Splice from the tools menu (on newer accounts, type `@` and choose Splice).

**What it can do.** `search` and `fetch` read your own productions, media and Motion compositions, plus Splice's public templates and docs. Generate tools spend your credits, and ChatGPT asks you to confirm each write action before it runs.

## Claude Code

1. Add Splice. Add `--scope user` to use it in every project, not just this one.

```bash
claude mcp add --transport http splice https://splice.film.fun/api/mcp
```

2. Start Claude Code and run `/mcp`. Splice shows **Needs authentication**: choose it, sign in with your film.fun account in the browser, and click **Allow**.
3. Ask Claude to "list my Splice productions" to check it works.

**With an agent key instead.** Create a key at https://splice.film.fun/dashboard/api-keys, then:

```bash
claude mcp add --transport http splice https://splice.film.fun/api/mcp --header "Authorization: Bearer sk_..."
```

Don't put a key in a project's shared `.mcp.json`: anyone with the file can spend your credits.

## Codex (CLI and IDE extension)

The Codex CLI, the Codex IDE extension and the Codex app share one config file, `~/.codex/config.toml`, so you set Splice up once.

**Sign in with OAuth.**

1. Add Splice:

```bash
codex mcp add splice --url https://splice.film.fun/api/mcp
```

2. Codex detects that Splice uses OAuth and opens a sign-in link (it also prints the link). Sign in with your film.fun account and click **Allow**.
3. Check it with `codex mcp list`, or `/mcp` inside Codex. To sign in again later, run `codex mcp login splice`.

**Or use an agent key.**

1. Create a key at https://splice.film.fun/dashboard/api-keys and put it in your shell environment:

```bash
export SPLICE_API_KEY=sk_...
```

2. Add Splice with the key's variable name (Codex reads the key from the environment, so it isn't stored in the config):

```bash
codex mcp add splice --url https://splice.film.fun/api/mcp --bearer-token-env-var SPLICE_API_KEY
```

3. That writes this to `~/.codex/config.toml`. You can also add it by hand:

```toml
[mcp_servers.splice]
url = "https://splice.film.fun/api/mcp"
bearer_token_env_var = "SPLICE_API_KEY"
```

## Cursor and VS Code

Both have one-click installs that sign you in with OAuth: [Add to Cursor](https://cursor.com/en/install-mcp?name=splice&config=eyJ1cmwiOiJodHRwczovL3NwbGljZS5maWxtLmZ1bi9hcGkvbWNwIn0%3D) or [Install in VS Code](https://vscode.dev/redirect/mcp/install?name=splice&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fsplice.film.fun%2Fapi%2Fmcp%22%7D). Manual config is on the [developer portal](https://splice.film.fun/developers#quickstart-mcp).

## Other MCP clients

Point any Streamable HTTP MCP client at `https://splice.film.fun/api/mcp`. A request without a token gets a 401 that points to Splice's OAuth metadata, so clients that support MCP authorization sign in on their own. Others can send `Authorization: Bearer sk_...`. The full reference is on the [developer portal](https://splice.film.fun/developers).

## What you can ask

Once Splice is connected, ask in plain words. For example:

- "What can I make with Splice, and how many credits do I have?"
- "Show me the video models and what a 5-second clip costs with each."
- "Generate a 9:16 image of a neon-lit ramen stall in the rain. Tell me the price first."
- "Turn that image into a 5-second video with a slow push-in."
- "Write a 20-second voiceover for a coffee ad and generate it in a warm, low voice."
- "Make 30 seconds of lo-fi music for a cooking reel."
- "Upscale the last image in my latest production."
- "Find Splice templates for product shots."

The assistant can use these tools: `list_models`, `get_balance`, `list_productions`, `generate_image`, `generate_video`, `generate_voice`, `generate_music`, `edit_image`, `upscale_image`, `upscale_video`, `get_job`, `list_compositions`, `get_composition`, `render_composition`, `list_characters`, `search`, `fetch`. What it makes lands in your Splice dashboard, where you can edit and cut it.

## Costs and credits

- Generating and editing spend credits from your Splice account at each model's price; video is priced per second. Reading is free: listing, search, fetch, your balance and the price list.
- New accounts get 100 free credits. Packs: Starter $10 = 1,000 credits · Creator $45 = 5,000 credits · Pro $99 = 11,500 credits · Studio $225 = 27,000 credits. Credits don't expire. See [pricing](https://splice.film.fun/pricing).
- Ask the assistant to check the price and your balance before a big job. Keep tool approval on for generate tools, so you confirm each spend.
- Failed generations are refunded automatically.

## Disconnect

- **In Splice (works for every assistant):** open https://splice.film.fun/dashboard/api-keys and revoke the app under **Connected apps**. Revoke agent keys on the same page. A revoked app or key stops working at once.
- **Claude:** Customize → Connectors, open Splice's menu, and click **Remove**.
- **ChatGPT:** remove the Splice app from Plugins or from Settings → Apps.
- **Claude Code:** `claude mcp remove splice`, or `/mcp` → Splice → **Clear authentication** to sign out but keep it configured.
- **Codex:** `codex mcp logout splice` to sign out, or `codex mcp remove splice` to remove it.

## Troubleshooting

- **"Needs authentication" or a 401:** sign in again (`/mcp` in Claude Code, `codex mcp login splice` in Codex, or reconnect the connector).
- **Out of credits (402):** top up at https://splice.film.fun/pricing, then ask again.
- **Permission error (403):** reconnect and allow both permissions, or use a key with the `splice:generate` scope.
- **Still stuck:** email support@film.fun.