Integrations

Connect Cinara to the AI assistant or code editor you already use. Ask for a voice-over, a sound effect or an image in plain words, and the assistant calls Cinara for you with your API key.

Pick your tool

Tool	How it connects	Guide
Claude Code	MCP server	Claude Code
Claude Desktop	MCP server, through mcp-remote	Claude Desktop
ChatGPT	Custom GPT with Actions	ChatGPT
VS Code (GitHub Copilot)	MCP server	VS Code
Cursor	MCP server	Cursor
Other MCP clients	MCP server	Connection details

Connectors that need you to sign in with OAuth, such as custom connectors in Claude on the web and connectors in ChatGPT, aren't supported yet. Cinara connects with API keys.

Connection details

Cinara offers two ways in:

• An MCP server, for tools that support the Model Context Protocol, such as Claude Code, Claude Desktop, VS Code and Cursor.
• An OpenAPI spec, for tools that import an API description, such as ChatGPT's GPT Actions.

Setting	Value
MCP server	POST https://api.cinara.ai/v1/mcp
MCP transport	Streamable HTTP, stateless (plain JSON responses)
OpenAPI spec	https://api.cinara.ai/openapi.json
Authentication	Authorization: Bearer <your Cinara API key>, or the key in an xi-api-key header

Before you start: get an API key

Every integration uses a Cinara API key.

1. Sign in to Cinara and open API Keys.
2. Type a Key name that says where the key is used, for example "Claude Desktop".
3. Choose Create key, then Copy. The full key is shown only once.

Good to know:

• Only workspace owners and admins can create keys.
• The person who creates the key needs a verified phone number on their Cinara account, or nothing can be generated with it.
• Create one key per tool. You can then see what each tool made, and revoke one without breaking the others.

See API Keys for more.

Keep your key private

Anyone with your key can spend your workspace's credits. Don't paste it into shared files, screenshots or public repositories. If a key leaks, revoke it on the API Keys page and create a new one.

What the MCP server can do

The MCP server gives your assistant 13 tools:

Tool	What it does
get_account	Shows the workspace, its credit balance, and whether it can create
list_voices	Lists Cinara's voices and your workspace's cloned and designed voices, with speech models, languages and emotions
text_to_speech	Turns text into speech
create_dialogue	Voices a conversation between several speakers
generate_sound_effect	Makes a sound effect from a description
write_lyrics	Writes original song lyrics from an idea
compose_music	Composes a song from lyrics, or an instrumental
generate_image	Creates images, or edits images made earlier in Cinara
generate_video	Creates a video clip, or animates an image made in Cinara
get_generation	Checks anything you made by its id, with fresh file links
list_history	Lists what the workspace made, newest first
list_drive_files	Lists a Drive folder
create_share_link	Makes a public link to a Drive file or folder

A few defaults differ from the API:

• generate_sound_effect makes 1 take unless you ask for more.
• create_share_link makes a link that lasts 7 days unless you ask for something else.

Not available through the MCP server:

• Uploading your own files. The image and video tools can only start from images already made in Cinara. For Transcribe, Clean Audio, Voice Changer, Dubbing, Voice Cloning and other features that start from your own file, use the Cinara app or the API.
• Streaming, MCP resources and MCP prompts.

What you can ask

Once connected, say what you want. For example:

• "How many credits do I have left?"
• "Which voices would suit a calm narration?"
• "Read this paragraph in the Mentor voice: …"
• "Voice this short conversation between a host and a guest."
• "Make a 20-second rain sound effect."
• "Write lyrics for a 90-second song about monsoon rain, then compose it."
• "Create a 16:9 image of a lighthouse at sunset, as an oil painting."
• "Animate that image with a slow push-in."
• "Share the song from my Drive with a link."

Cinara's content rules apply as they do in the app: nothing that names or copies well-known people. See Safety and consent.

Slow jobs

Sound effects, music, images and video are made in the background. The tool waits up to about 40 seconds for the result (the assistant can ask for up to 50). If it isn't ready by then, the assistant gets the job's id and can check it later with get_generation.

Sound effects and images are usually ready in time. Songs and videos often take longer: ask "Is it ready yet?" after a minute or two. The job keeps going in Cinara either way, and shows up in History.

Credits, results and links

• Credits. Everything an assistant makes costs the same credits as in the app, from your workspace's balance. A request that needs more credits than you have is refused. Failed work is refunded.
• History. Every result is listed in History. Filter by API key: name to see what a tool made.
• Drive. Audio, video and images also appear in Drive, where you can download them or share a link.
• Links expire. File links work without signing in, but expire after about 6 hours. Ask the assistant for a fresh link (get_generation returns new ones), or find the file in Drive.
• Rate limit. Each key can make up to 120 requests a minute. One tool call can use several of them, because the tool checks the job while it waits.

Troubleshooting

What you see	What to do
401 or "unauthorized"	The key is wrong, incomplete or revoked. Copy it again, or create a new key. Check that the header reads Bearer, a space, then the key.
403 "Verify your phone number to start creating."	The person who created the key must verify their phone in the Cinara app.
403 "forbidden"	The person who created the key has left the workspace. Create a new key.
402 "This needs N credits"	Your workspace doesn't have enough credits. Check Usage & Credits.
429 "Too many requests with this API key"	Wait a minute and try again. Waiting tools use several requests each, so run fewer at once.
Cinara's tools don't show up	Restart the tool after changing its settings, and check the setup steps on its page.

Still stuck? Email support@cinara.ai.

Stop a tool using Cinara

1. Open API Keys and choose Revoke on the tool's key. It stops working straight away.
2. Remove the Cinara server or action from the tool's settings.

Related

• API Keys
• API reference
• Usage & Credits