Appearance
Claude Code and Claude Desktop
Connect Claude to Cinara's MCP server. Claude can then make speech, dialogue, sound effects, lyrics, music, images and video when you ask, and find things in your History and Drive, using your workspace's credits. See what the MCP server can do.
You need a Cinara API key. Create one on the API Keys page. See Before you start.
Claude Code
Add the server
In a terminal, run:
bash
claude mcp add --transport http cinara https://api.cinara.ai/v1/mcp \
--header "Authorization: Bearer cin_..."Replace cin_... with your full key.
This adds Cinara for the current project, on your computer only. To use Cinara in every project, add --scope user:
bash
claude mcp add --transport http --scope user cinara https://api.cinara.ai/v1/mcp \
--header "Authorization: Bearer cin_..."Check the connection
bash
claude mcp listCinara should show as connected. Inside Claude Code, type /mcp to see the server and its tools.
Share it with your team, not your key
To add Cinara to a project for everyone, commit a .mcp.json file at the project root. It reads each person's own key from their environment:
json
{
"mcpServers": {
"cinara": {
"type": "http",
"url": "https://api.cinara.ai/v1/mcp",
"headers": {
"Authorization": "Bearer ${CINARA_API_KEY}"
}
}
}
}Each person sets the variable before starting Claude Code, for example export CINARA_API_KEY=cin_.... Claude Code asks each person to approve a project's servers the first time.
Remove it
bash
claude mcp remove cinaraAdd --scope user if you added it for every project.
Claude Desktop
Claude Desktop connects through mcp-remote, a small helper that passes Claude's requests to Cinara with your key. It runs with npx, so you need Node.js 18 or later.
In Claude Desktop, open Settings, then Developer, and choose Edit Config. This opens
claude_desktop_config.json:- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
Add Cinara under
mcpServers. Keep any servers that are already there.json{ "mcpServers": { "cinara": { "command": "npx", "args": [ "-y", "mcp-remote", "https://api.cinara.ai/v1/mcp", "--header", "Authorization:${CINARA_AUTH}" ], "env": { "CINARA_AUTH": "Bearer cin_..." } } } }Replace
cin_...with your key. Keep the wordBearerand the space after it.Save the file. Quit Claude Desktop completely, then open it again.
Start a new chat. Cinara's tools appear in the chat's tools menu.
Why the header has no space
Some systems split command arguments at spaces. Writing Authorization:${CINARA_AUTH} without a space, and keeping the key in env, avoids that. mcp-remote fills in the value when it starts.
Custom connectors
Claude's custom connectors, in Claude on the web and in Claude Desktop's Connectors settings, expect you to sign in with OAuth. Cinara doesn't offer OAuth sign-in yet, so custom connectors aren't supported yet. Use the config file above.
If it doesn't connect
- Read the log. On macOS, open
~/Library/Logs/Claude/mcp-server-cinara.log. On Windows, open%APPDATA%\Claude\logs\mcp-server-cinara.log. npxnot found. Install Node.js, then restart Claude Desktop.- Nothing changes. Check the file is valid JSON (commas and quotes), save it, and quit Claude Desktop fully before opening it again.
Try it
- "Make a 20-second rain sound effect."
- "Read this paragraph in the Mentor voice: …"
- "Create a 30-second calm piano instrumental and give me the download link."
- "List my cloned and designed voices."
Claude asks before it uses a Cinara tool, unless you've allowed it to.
Songs and videos can take a few minutes. If one isn't ready after about 40 seconds, Claude gets its id and can check it later: ask "Is it ready yet?"
Claude can't upload files from your computer to Cinara. Image edits and animated videos start from images already made in Cinara.
Credits come from your workspace's balance, at the same rates as the app.
Results are listed in History under the key's name, and files appear in Drive.
File links expire after 6 hours. Ask Claude for a fresh link, or find the file in Drive.
For error messages, see Troubleshooting.