---
title: Use Splice in Claude, ChatGPT, Grok, Claude Code and Codex
description: "Connect Splice to Claude (claude.ai and Claude Desktop), ChatGPT, Grok (grok.com, Grok Bot, Grok Build and the xAI API), 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-13
---
# Use Splice in Claude, ChatGPT, Grok, 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, Grok, 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. You choose what the key can do (Full access, Create, or Read only) and when it expires.
- **Already signed in to Splice?** https://splice.film.fun/dashboard/api-keys has copy-ready commands for each assistant, your keys, and the apps you've connected.
- **Permissions.** Splice asks for three scopes: `splice:read` (see your productions, media, balance and prices), `splice:generate` (create and edit media, which spends credits) and `splice:compose` (create and edit your Motion compositions; free, and every change is saved as a version you can restore from the editor's History).

| 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 |
| Grok (grok.com, Grok apps) | Custom connector | OAuth | Paid Grok plans; on Business and Enterprise an admin adds it first |
| Grok Bot | Ask the bot to add a custom MCP server | OAuth or agent key | Plans that include Grok Bot (beta) |
| Grok Build, xAI API | `grok mcp add`, or the `mcp` tool in API requests | OAuth (Grok Build) or agent key | Grok Build install; xAI API key |
| 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. Enter the name `Splice` and the remote MCP server URL `https://splice.film.fun/api/mcp`, then click **Continue**.
4. Under **Authentication**, choose **Sign in now** (or **Sign in when needed**). Leave the OAuth client on automatic and don't add request headers: Claude registers itself with Splice. Click **Add**. 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.

## 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**, then **Create as a plugin** (older accounts: 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.

## Grok

Grok can use Splice in four places. They all use the same server address, `https://splice.film.fun/api/mcp`.

### grok.com and the Grok apps

**Plans.** Custom connectors (xAI calls them "Bring your own MCP") are on paid Grok plans. On Grok Business and Enterprise, an admin first adds Splice in the xAI console (**Connectors → + Add Connector → Other**), and members then connect to it. Plans change, so check what your account shows.

**Steps.**

1. On the web, open **grok.com/connectors** (or click **+** in a chat, choose **Connectors**, then **+ Add connector**).
2. Click **New Connector**, then **Custom**.
3. Enter the name `Splice` and the MCP server URL `https://splice.film.fun/api/mcp`. Don't add a key or headers: Grok registers itself with Splice.
4. Grok sends you to Splice. Sign in with your film.fun account, check that the page names Grok and that you'll go back to **grok.com**, then click **Allow**.
5. Splice's tools are now available in your Grok chats on the web and in the iOS and Android apps (**Settings → Connectors**).

### Grok Bot

Grok Bot (xAI's always-on agent, in beta) uses the same MCP servers as Cursor. It has no settings screen for a server URL, so you ask the bot in a chat.

1. Tell it: "Add a custom MCP server called Splice at https://splice.film.fun/api/mcp". Saying "custom server" matters.
2. The bot posts a connect card. Click **Authorize**, sign in with your film.fun account and click **Allow**.
3. To use an agent key instead, tell the bot to send the header `Authorization` with the value `Bearer sk_...`. It stores the key as a header on the server entry.

Grok Bot runs on a cloud computer, so it can only reach public URLs like Splice's.

### Grok Build (CLI)

1. Add Splice:

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

2. Open `/mcps` in Grok Build, select Splice and press `i` to sign in in the browser, then click **Allow**.

**With an agent key instead:**

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

### The xAI API

The xAI API's remote MCP tool lets Grok call Splice from your own code. Create an agent key at https://splice.film.fun/dashboard/api-keys, put it in `SPLICE_API_KEY` (and your xAI key in `XAI_API_KEY`), and pass it as the tool's `authorization`. xAI's servers call Splice for you, so the key travels with each request: give it the least access the job needs and an expiry. Remote MCP works with the Responses API (`https://api.x.ai/v1/responses`) and the xAI SDK; xAI lists `grok-4.7` as the supported model.

```bash
curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
  "model": "grok-4.7",
  "input": [{"role": "user", "content": "What is my Splice credit balance, and what does a 5-second video cost?"}],
  "tools": [{
    "type": "mcp",
    "server_url": "https://splice.film.fun/api/mcp",
    "server_label": "splice",
    "authorization": "'"$SPLICE_API_KEY"'"
  }]
}'
```

With the xAI Python SDK:

```python
import os
from xai_sdk import Client
from xai_sdk.chat import user
from xai_sdk.tools import mcp

client = Client(api_key=os.environ["XAI_API_KEY"])
chat = client.chat.create(
    model="grok-4.7",
    tools=[mcp(
        server_url="https://splice.film.fun/api/mcp",
        server_label="splice",
        authorization=os.environ["SPLICE_API_KEY"],
    )],
)
chat.append(user("List my Splice productions."))
print(chat.sample().content)
```

Use a Read only key for read-only jobs, and `allowed_tools` (`allowed_tool_names` in the SDK) to limit which tools Grok sees. Generate tools spend your credits, and the API runs them without asking you first.

### Grok on X

Grok in X (asking @grok in a post or reply) doesn't offer connectors or custom MCP servers, so it can't reach Splice. Use grok.com, the Grok apps, Grok Bot, Grok Build or the xAI API.

## 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."
- "Make a 9:16 Motion title card that says Launch Day, then show me its history and undo your last change."
- "Upload my logo from https://example.com/logo.png to my Splice production and put it on an end card."
- "Make a 15-second vertical short about a ramen stall in the rain: a new production, two shots, a voiceover and a title card, rendered to MP4. Quote the cost first."

The assistant can use these 120 tools:

- **Account and models:** `list_models`, `recommend_model`, `get_balance`
- **Productions and Universe:** `list_productions`, `create_production`, `get_production`, `update_production`, `list_series`, `get_universe`, `set_universe`, `get_universe_bundle`, `list_universe_entities`, `list_scripts`, `get_script`, `create_script`, `update_script`, `edit_script`, `list_script_revisions`, `revert_script`, `match_script_cast`, `create_cast_character`, `list_moodboards`, `get_moodboard`, `create_moodboard`, `add_moodboard_items`, `extract_moodboard_look`, `get_production_look`, `set_production_look`, `update_look`, `list_loras`, `get_lora`, `train_lora`, `cancel_lora`, `import_arena_pack`
- **Library and uploads:** `list_characters`, `list_locations`, `list_props`, `create_entity`, `list_entity_assets`, `add_entity_asset`, `set_entity_sheet`, `set_entity_avatar`, `set_entity_voice`, `add_entity_to_production`, `copy_entity_to_production`, `upload_media`, `import_media`
- **Generate and edit:** `generate_image`, `generate_video`, `generate_keyframes_video`, `generate_voice`, `generate_music`, `edit_image`, `upscale_image`, `upscale_video`, `enhance_audio`, `generate_media`, `edit_media`
- **Jobs:** `get_job`, `list_items`, `cancel_job`, `get_idempotency_result`
- **Motion compositions:** `list_compositions`, `get_composition`, `render_composition`, `create_composition`, `edit_composition`, `list_composition_revisions`, `revert_composition`
- **Studio timelines:** `list_studios`, `get_studio`, `get_studio_item`, `create_studio`, `edit_studio`, `export_studio`, `get_studio_export`, `list_studio_revisions`, `revert_studio`
- **Shotlists and takes:** `list_shotlists`, `get_shotlist`, `list_shot_takes`, `generate_shot`, `match_previous_shot`, `coverage_pack`, `match_scene`, `review_take`, `set_hero_take`, `check_faces`, `get_face_check`, `regenerate_mismatch`, `set_face_check_mode`
- **Production stages (script to cut):** `get_production_stages`, `draft_pipeline`, `list_storyboards`, `get_storyboard`, `create_storyboard`, `update_storyboard`, `create_shotlist`, `add_shots`, `update_shot`, `remove_shot`, `reorder_shots`, `list_shotboards`, `get_shotboard`, `promote_shotlist`
- **Craft guides and checks (free):** `list_guides`, `get_model_guide`, `get_craft_guide`, `get_video_motion_guide`, `check_video_prompt`, `pack_multishot`, `lint_multishot`, `motion_design_brief`, `gsap_for_use_case`, `motion_quality_check`, `production_brief`, `production_qa`, `get_tool_help`
- **Search (ChatGPT shape):** `search`, `fetch`

What it makes lands in your Splice dashboard, where you can edit and cut it. Each tool, its permission and whether it spends credits: [the developer portal](https://splice.film.fun/developers#mcp-tools).

## 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.
- **Grok:** remove Splice at grok.com/connectors. In Grok Build, delete the `[mcp_servers.splice]` entry from `~/.grok/config.toml`.
- **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 all three permissions, or use a key with Full access or Create access (a Read only key can't generate or edit).
- **"Unknown parameter":** Splice rejects arguments a tool doesn't have and lists the accepted ones. Ask the assistant to retry with those; model settings go in `parameters`.
- **Still stuck:** email support@film.fun.
