Connect Your AI

FilmKit lets you connect an AI assistant to your projects so it can help you research, break down, and revise your screenplay — while keeping you firmly in control of every change.

How it works

FilmKit exposes your work to AI clients through the Model Context Protocol (MCP), an open standard for connecting AI assistants to tools and data. When you authorize a client, it can read your project and use FilmKit's tools on your behalf. The assistant acts under your identity, and only with the access you've granted.

Connecting a client

Settings → Connected AI has everything you need:

Copy your MCP endpoint

The Connected AI page shows your environment's MCP URL. Copy it with Copy.

Add it to your AI client

Point an MCP-capable client at the endpoint. For Claude Code, that's a single command; for Claude on the web, add it as a connector. The page gives you the exact steps for each.

Authorize the connection

FilmKit asks you to sign in with your passkey and shows a consent screen listing exactly what the client is requesting. Choose Allow or Deny. First-time clients always go through this screen — there's no silent authorization.

Connected AI settings — your MCP endpoint, client setup, and safety notes.
Connected AI settings — your MCP endpoint, client setup, and safety notes.

What you're granting

A client requests a specific set of scopes, shown on the consent screen:

  • Read — read your project: screenplay, scenes, characters, and search.
  • Suggest — propose screenplay edits as reviewable suggestions.
  • Write breakdown — create and edit breakdown catalog entries and tags.

An assistant can never do more than you can do in the app, and you can revoke a client's access at any time.

Suggestions, not silent edits

The most important rule of AI in FilmKit: the AI never changes your script directly. Screenplay edits arrive as suggestions that you review and then accept or reject. Nothing lands in your screenplay without you.

Breakdown entries (characters, items, places, and tags) are structured and easily reverted, so those writes can land directly — but the subjective, destructive-if-wrong work of changing your prose is always gated behind your approval.

What an assistant can do

With your permission, an assistant can:

  • Read your screenplay, scenes, and characters for context, and search across a project.
  • Propose screenplay edits — insertions, deletions, and replacements — as reviewable suggestions, including project-wide find-and-replace and character renames that cascade through the script.
  • Take part in comment threads, replying and resolving under your identity.
  • Maintain the breakdown — create or update characters, items, and places, and tag which scenes need them.

Next steps