HOME/DOCUMENTATION/Chapter 11: Let Other AI Assistants Use Scribis (MCP)
OFFICIAL USER GUIDE

Chapter 11: Let Other AI Assistants Use Scribis (MCP)

Turn on Scribis's MCP service, paste the settings into Claude Code, Cursor, Codex and other AI tools, install the Scribis Skills, and ask AI in plain words to transcribe, fix subtitles or edit video.

Chapter 11: Let Other AI Assistants Use Scribis (MCP)

💡 Who is this chapter for? People who already use AI tools such as Claude Code or Cursor and are happy to copy and paste settings step by step. Nothing else in Scribis needs this chapter, so if you haven't used these AI tools, feel free to skip it.

11.1 What is this?

If you use an AI assistant such as Claude Code, Claude Desktop, Cursor, OpenAI Codex, Google Antigravity or Windsurf, it can use Scribis for you. Just tell the AI what you want in plain words, for example:

"Turn meeting.mp4 on my Desktop into English subtitles and save them as an SRT."

"Open the project I just edited and cut out the 'um's and 'uh's."

The AI then does it through Scribis. The standard that lets them talk to each other is called MCP (Model Context Protocol).

🔒 Is it safe? Scribis's MCP service only accepts connections from your own computer. Other people and websites on the internet can't use it. Changes to subtitles or the timeline are shown in Scribis for you to review.


11.2 Step 1: Turn on MCP in Scribis

  1. Open Settings and click MCP in the settings menu.
  2. On the Connection & Setup tab, turn on the MCP (Model Context Protocol) Server switch.
  3. When the top right shows a green "Running," it's on. MCP: Port 8890 next to it is the number used to connect. It's filled in automatically in the next step, so you don't need to remember it.

The MCP Protocol & Developer APIs settings page: ① the MCP server switch, ② the Running status, ③ the connection address, ④ MCP Client Configuration

In the picture, ① is the switch, ② is the running status and ③ is the connection address; ④ MCP Client Configuration is used in the next step.

💡 8890 is the default "port" (think of it as a door number). If it clashes with another app, change it under Shared HTTP Port.


11.3 Step 2: Paste the settings into your AI tool

On the same page, scroll down to MCP Client Configuration and click the tool you use (for example Claude Code, Claude Desktop, Cursor, Codex or Antigravity). Scribis shows the settings with the port already filled in. Copy them and paste them into that tool's MCP settings. Every tool keeps these settings in a different place, so follow the steps for your tool in the MCP installation and usage guide.

For Claude Code, you can also run the line below in a "terminal" (the Terminal app on a Mac, or PowerShell on Windows). If you've never used a terminal, skip this and use the copy and paste above:

claude mcp add --transport http scribis http://127.0.0.1:8890/mcp

For where each tool keeps its settings file and more details, see the MCP installation and usage guide.


11.4 Step 3: Install the Scribis Skills (recommended)

Skills are a "Scribis user manual" written for AI. With them installed, the AI knows how to use Scribis correctly.

  1. Download scribis.install-skill.zip from the MCP installation and usage guide.
  2. Unzip it and open the skills folder. You'll see six folders whose names start with scribis-. Copy all six into your AI tool's skills folder, directly inside it, without wrapping them in another folder.
    • For Claude Code, that's .claude/skills in your user folder (on a Mac, the one with the house icon in Finder's sidebar). Mac: /Users/your-name/.claude/skills; Windows: C:\Users\your-name\.claude\skills.
    • For other tools, see the folder table in the MCP installation and usage guide.
    • On a Mac, if you can't see folders that start with a dot (such as .claude), press ⌘ + ⇧ + . (Command, Shift and period) in Finder to show them.
  3. Restart your AI tool (or start a new conversation).

11.5 Try it out

Make sure Scribis is open, then type into your AI tool:

What you want What you can say
Transcribe "Use Scribis to transcribe ~/Movies/meeting.mp4 and save it as an SRT."
Fix subtitles "Read the subtitles open in Scribis, find names and terms that may be misheard, and suggest fixes."
Rough cut "Cut out the pauses and the 'um's and 'uh's in this video."
Add animation "Add an animated title at 0:12 saying 'New version launches this month'."
Music and sound "Add some upbeat background music and lower it automatically while people are talking."
Voice-over "Re-record line 3 with an AI voice."

Hand a project to AI straight from Cuts

In Cuts › Recent edits or Scenes, the copy button next to Open editor copies a command such as:

/scribis-edit cuts <project ID>

Click copy and paste it straight into Claude Code or another AI tool (the copy button fills in the real project ID, so you only paste; <project ID> above is just a stand-in). The AI opens that project, and then you can just tell it how you'd like it edited. Install the Skills in 11.4 before using this.


11.6 Advanced: OpenAI-compatible API

This section is for software developers. Most people can skip it.

On the right of the same settings page, the OpenAI-compatible Audio API lets other programs use Scribis's speech-to-text, speech synthesis and local AI in the OpenAI format. Click Generate API Key & Enable to use it.


11.7 Can't connect?

Problem Solution
The AI says it can't find Scribis Make sure Scribis is open and the MCP switch is on
Nothing happens after setup Restart your AI tool or start a new conversation
The port is already in use Change the number under Shared HTTP Port, then copy the settings again
The AI isn't very good at using Scribis Check that all six scribis- folders sit directly inside the skills folder, not wrapped in another folder

For more troubleshooting, see the MCP installation and usage guide.