Skip to content

MCP connector

Connect Zıpır to Claude

Call video-from-document production from inside Claude: give it the document, see the scene plan, approve it, download the video. Setup is three steps and there is no key to copy: you sign in with your Zıpır account.

https://api.zipirapp.com/mcp

This is a custom connector: it is not listed in Anthropic's directory, because the directory policy does not accept servers that generate video and audio with AI. Without a directory listing it works in Claude exactly the same way.

On this page5 sections · 2 min read

Three steps

  1. 1

    Open the connector screen in Claude

    Settings → Connectors → Add custom connector. (The same place in claude.ai, Claude Desktop and Claude mobile.)

  2. 2

    Paste the address

    https://api.zipirapp.com/mcp: the address you just copied. The name and icon fields are free; write what you like.

  3. 3

    Sign in with your Zıpır account

    The connection opens with OAuth (PKCE S256): Claude takes you to Zıpır, you sign in there and return. After that the tools appear.

What you can ask Claude

  • "Turn this PDF into a 3-minute Turkish video, with every sentence showing its source." (by attaching the document to the chat)
  • "Which videos did I make this week, and which one is waiting for my approval?"
  • "Approve the scene plan of that lesson and give me the download link."
  • "How many minutes do I have left?"

Tools

list_formats, list_lessons, create_lesson, get_lesson, approve_lesson, get_download, get_usage. All seven tools follow the same rules as the panel itself.

Minutes and approval

Making a video spends minutes, and minutes are deducted only when approve_lesson is called. Uploading the document and seeing the scene plan are free. No frame is produced without your approval; this is the same rule as in the panel. get_usage tells you the minutes left, and the panel has extra minute packs.

Where else it works

The same address is valid in MCP clients such as Cursor, VS Code and Claude Code. If you prefer to run it on your own computer, the package is ready: npx @zipir/mcp (@zipir/mcp). To use it with an API key, create the key on the account page; the full reference is on the /en/api/ page.

Something wrong? [email protected]. For connection errors the first step is usually to remove the connector and add it again.

Last updated: