The connector is one way to use Kleo: the same Kleo you open at
app.kleooai.com also works inside your assistant, as a remote MCP server, with
the same account and credits. It speaks the Model Context Protocol over Streamable HTTP with OAuth 2.1, so the
same address works from any compatible client. Connecting takes one button on Kleo’s own page, with no sign-up form, no
password, no card. It is free to start: 5 credits on your account the moment you connect, one animatic of up to
20 seconds, and a launch code opens one free 15-second film. Add it to
your assistant and describe the film you want to make. Quickest route: Claude, Settings →
Connectors → Add custom connector.
https://mcp.kleooai.com/mcp
Works withClaudeChatGPTGrokClaude CodeCursorVS CodeOpenCodeGemini CLIWindsurfGemini app
A Whale in VeniceA humpback breaches out of the Grand Canal, and it never happened.
01Connect
Choose your assistant.
Every client below uses the same address and the same one-button start: paste the address, Kleo’s page
opens, you click Start free, and you are back in the client with 5 credits on the account. Follow the instructions for your client. Connector access and menus can vary by account, workspace and version.
Claude app · web · recommended
Server address https://mcp.kleooai.com/mcp
Open Settings → Connectors and choose Add custom connector.
Name it Kleo, paste the address above, and confirm. Kleo’s page opens: click Start free and you’re back in Claude.
Start a new chat, switch Kleo on from the tools menu and pick the free animatic or film prompt below.
Your account and workspace decide what you can do with custom connectors, and how much.
Open a new Codex session and check that Kleo’s tools show up, then pick the animatic or film prompt below. Codex MCP documentation →
Claude Code cli
# add Kleo once (add --scope user to have it in every project)
claude mcp add --transport http kleo https://mcp.kleooai.com/mcp
# then, inside a session:
/mcp → Kleo → Authenticate
Run the command above, then type /mcp in a session, pick Kleo and Authenticate: Kleo’s page opens in your browser, click Start free and you’re back in Claude Code.
Ask: Use kleo for a 5-minute video on the history of coffee, 16:9. Claude Code checks the progress for you and hands you the links.
Cursor mcp.json
Create or edit ~/.cursor/mcp.json (all projects) or .cursor/mcp.json inside one project.
Save the file: Cursor lists Kleo under Settings → MCP. Click Connect (or use a tool once): Kleo’s page opens, click Start free and you’re back in Cursor.
VS Code mcp.json
Create .vscode/mcp.json in your workspace (or run MCP: Add Server from the Command Palette and paste the address).
# connect once (opens the browser)
opencode mcp auth kleo
Save the config and run the command above: Kleo’s page opens in the browser, click Start free and you’re back in OpenCode.
Start opencode and ask for the video: the kleo tools are available in every session.
Gemini CLI cli
# add Kleo (add --scope user to have it in every project)
gemini mcp add --transport http kleo https://mcp.kleooai.com/mcp
Run the command above, then start gemini and type /mcp auth kleo: Kleo’s page opens in your browser, click Start free and you’re back in Gemini CLI.
Ask for the video in the session. /mcp list shows every kleo tool.
Windsurf, the Gemini app and your own agents http
Kleo is a standard MCP server over the Streamable HTTP transport with OAuth 2.1. Any compatible client connects with the same address and the same one-button start.
Server address https://mcp.kleooai.com/mcp
Windsurf: Settings → MCP → Add server, paste the address (its mcp_config.json uses the key "serverUrl").
Gemini app: Settings → Connected apps → Custom apps, paste the address (currently requires Google AI Pro or Ultra).
For your own agent: use an MCP SDK (Python or TypeScript) with the HTTP transport and complete the OAuth flow once.
Connect Kleo in ClaudeToo many apps, too much time: add the connector, describe the film, render.
15 s
Koi SupraA koi-livery Supra on a wet harbour road at night.
61 s
Kleo AI x ClaudePaywall after paywall, then Kleo in Claude: from grey previz to the finished film.
02First request
Start with a clear request.
The assistant reads your request against Kleo’s intake — subject, length, format, look — and asks for
whatever is missing before it writes the treatment. Say all four and it goes straight to work. Paste this in your
first chat:
Choose the product before rendering. Try a free animatic: drawn frames, camera movement and narration, 5 credits up to 20 seconds (10 up to 60). Create a film: generated moving footage, 15 seconds to 5 minutes, with a purchased pack (or a launch code for one 15-second film) and a quote you approve.
Try a free animatic
“Use Kleo to plan a 20-second animatic about a paper boat returning to its maker. Animation look, English narration, 9:16. Show me the treatment, confirm that the product is an animatic, and check the exact credit cost against my available balance. Wait for my approval before rendering. Do not start a paid film or buy credits.”
Create a film
“Use Kleo to plan a 20-second narrated film about two fictional cars leaving an amber-lit tunnel for a coastal road at golden hour. Realistic look, English narration, 16:9. Show me the treatment, the exact film credit cost, my available balance and whether my account is eligible. Wait for my approval before rendering. Do not buy credits. After rendering, give me the finished MP4 download link.”
Two looks are available on the server: realistic, generated live-action footage, and animation, a 2D
animated film. Swap the word in the prompt to get the other one.
The Corgi Knight, the reelA corgi knight takes the ice throne.
10 s
Sweeping the SeaA woman tries to broom the waves back into the sea.
6 s
Hello, KittenA ginger kitten trots up to the lens and meows.
15 s
Blender to filmGrey Blender previz on top, the finished shots underneath.
03Credits
Check your balance before production.
A €5 pack adds 10 purchased credits and unlocks film rendering: exactly one 15-second film. A 20-second film costs 14 credits and a 30-second film 20. Your 5 starter credits buy one animatic of up to 20 seconds. A launch code opens one free 15-second film before any pack. Ask your assistant to confirm the credits for your chosen product and the exact quote before you buy or render.
Ask the assistant for your account page to buy credits, then confirm when you want the render to start. Nothing is
charged until Kleo accepts the job: the assistant states the exact credits first, and a refused request costs
nothing.
Have a launch code? Tell the assistant “redeem PRODUCTHUNT” (or HN, REDDIT, X, TIKTOK) before you ask
for the film. Your account page also holds your referral link: a friend’s first pack gives them 5 extra credits
and you 10.
Intake, treatment, storyboard, render, links: what each kleo tool does, in the order the assistant runs them, and
how the credits are checked before a GPU is rented.