Connect AI tools and the API
Let Claude, Cursor or your own software use Tari Studio for you, with an API key.
- 1. What this is
- 2. Make an API key
- 3. Connect Claude Desktop
- 4. Connect Claude Code, Cursor and others
- 5. What an assistant can do
- 6. Use the REST API
- 7. Safety and who sees what
What this is
Tari Studio can be used by other software, not only by people in the console:
- AI assistants such as Claude Desktop, Claude Code, Cursor, Windsurf and ChatGPT connect to Tari Studio as an MCP server (Model Context Protocol). They get tools to list your brands and products, describe an ad, read the quote, generate it, and schedule posts, and they do all of it as you.
- Your own programs (a website, a spreadsheet script, an automation tool like Zapier or n8n) call the REST API at
/api/v1with the same key.
Both need an API key, which you make in the console under Settings → API & AI access. A key acts as you, inside the team you were working in when you made it, with your role. You can make a key that only reads.
Make an API key
- Open Settings → API & AI access.
- Under Make a key, name it after the tool that will use it ("Claude Desktop"), choose Read and write or Read only, and whether it should stop working after a while.
- Press Make the key and copy it at once. It is shown once; we keep only a fingerprint, so if you lose it, make a new one.
A key looks like tsk_ followed by 40 letters and numbers. Treat it like a password: paste it into the tool's settings, never into a chat, an email or a public place. If it leaks, press Revoke and anything using it stops at once. You can have up to 10 keys per team.
Connect Claude Desktop
- In Claude Desktop open Settings → Developer → Edit Config. This opens
claude_desktop_config.json. - Add this inside
mcpServers(the page in the console shows it ready to copy with your key filled in):
"tari-studio": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://taristudio.africa/api/mcp",
"--header", "Authorization: Bearer tsk_YOUR_KEY"]
}- Save and restart Claude. You should see the tools (a hammer icon) in a new chat. Ask: "Which brands do I have in Tari Studio?"
Replace the address with the one you sign in at if it is different, and the key with your own. mcp-remote needs Node.js installed on your computer; Claude Desktop can also connect to remote servers directly in its Connectors settings, where you paste the same address and header.
Connect Claude Code, Cursor and others
Claude Code (the terminal tool): run once
claude mcp add --transport http tari-studio https://taristudio.africa/api/mcp --header "Authorization: Bearer tsk_YOUR_KEY"Cursor, Windsurf and other MCP clients: add a remote MCP server with the URL https://taristudio.africa/api/mcp and the header Authorization: Bearer tsk_YOUR_KEY. Their settings file usually takes:
"tari-studio": {
"url": "https://taristudio.africa/api/mcp",
"headers": { "Authorization": "Bearer tsk_YOUR_KEY" }
}ChatGPT connectors and other tools that want OpenAPI can read the API's description at /api/v1/openapi.json and authenticate with the same bearer key.
What an assistant can do
Once connected, speak to the assistant in plain words. It uses these tools, each held to your role:
- Read:
who_am_i,list_brands,get_brand,list_products,list_characters,list_templates,list_campaigns,list_leads,list_channels,list_posts,list_tasks,list_assets,get_asset,get_credits,list_models. - Make ads:
create_studio_project,describe_ad(returns a quote with its credits; takes astoryandlanguage),list_story_styles(how a story can be told),update_quote(length, shape, image or video, model, and the look-and-feelchoices),generate_from_quote(spends credits),get_studio_messageto follow progress,get_studio_projectto read a whole project. - Stories:
list_story_options,create_story(returns directions in the background),get_story,list_stories,choose_story_direction(develops the storybook),rewrite_story_scene,produce_story_scene(a priced quote you then generate),assemble_story_film(joins the clips into one film with captions, free). - Change things:
create_brand,update_brand,create_product,create_campaign,create_task,schedule_post(publishes to your connected accounts). - Help:
how_to_usereturns this guide.
Try: "Make a 15-second vertical video for my brand about the Friday offer, quote first." The assistant lists your brands, opens a project, describes the ad with your brand's guidelines, and shows you the quote. Say yes and it generates, then tells you when the video is ready and where to download it.
Never, with any key: connecting social accounts, approving content, managing people, buying credits or changing settings. Those need a signed-in person with two-factor sign-in. A read-only key can also not create, change or generate anything.
Use the REST API
Send your key as a header on every request: Authorization: Bearer tsk_YOUR_KEY. Every answer is {"ok": true, "data": ...} or {"ok": false, "error": {"code": "...", "message": "..."}}.
curl https://taristudio.africa/api/v1/me -H "Authorization: Bearer tsk_YOUR_KEY"To make an image: create a project (POST /api/v1/studio/projects), describe it (POST /api/v1/studio/projects/{id}/messages with {"text": "/image a poster for ...", "brandId": "..."}), read the quote's credits in the answer, then POST /api/v1/studio/quotes/{quoteId}/generate. Poll GET /api/v1/studio/messages/{quoteId} until the asset's status is READY, then download it from the downloadPath with the same header.
The complete list of routes, fields and examples is in the OpenAPI document. Each key may make 300 requests a minute; past that you get 429 with a Retry-After header.
Safety and who sees what
- A key does exactly what you could do in the console, no more. Remove a person from the team and their keys stop too.
- Everything done with a key is recorded in the audit trail under your name, so the team can see what an assistant did.
- Owners and others who manage the team can see and revoke every key in the team under API & AI access.
- Generation spends credits only at Generate; a quote costs nothing. Ask your assistant to confirm the credits with you before generating.
- Posting publishes to real accounts. Ask your assistant to show you the text, channels and time before it schedules.
- If anything looks wrong, revoke the key. Making a new one takes ten seconds.