Skip to content

Connecting TikTok Ads

You can add your own TikTok Ads connection so that Cora can read how your ads are doing, in the missions you choose. It is read-only. Cora can look at your ad accounts, campaigns, ad groups, ads and their reports, and she cannot create, change, pause or spend on anything.

You sign in with your normal TikTok for Business login, on TikTok’s own page. You do not make a key or an app. It works like Connecting with the service’s sign-in, with the name and address filled in for you. The connection is yours: you decide which missions Cora may use it in, and nobody else can use it. See Personal connections for the rules. This page uses an invented company, Kestrel Cycles, and a team member, Megan.

  • MCP turned on for the organisation (see Connecting an MCP server). An org admin does that once.
  • A TikTok for Business account that can see the ad accounts Cora should read. Use one whose access matches what you want Cora to see.
  • Connect turned on by the operator. If TikTok Ads says “Not available yet”, ask the operator.
  1. Open Connections on the left rail and press Connect beside TikTok Ads (it says Sign in with TikTok).
  2. In the Account section, choose Connect…. The short name (tiktok) and the server address are filled in for you. Cora checks the address and shows who runs the sign-in (TikTok itself, so there is no warning).
  3. Choose Connect. TikTok’s page opens in a new window. Sign in, check the permissions and approve.
  4. The window closes by itself and the card says Connected as your account. Finish the sign-in in the same browser you pressed Connect in.

You can have one TikTok Ads connection. If you already have one, it is not under Ready to connect. Find TikTok Ads under Connected on the Connections page, press Manage beside it, and use Reconnect in its Account section. When its sign-in has ended it is under Needs attention instead, with its own Reconnect button.

In the Shared with missions section, choose + Share in a mission and pick a mission you belong to. Cora can then read your TikTok ad results in that mission, and in no other. You can also open a mission’s details (the Details button at the top right), choose the Tools tab, and under Connections choose Share mine.

A mission can use one TikTok Ads connection. If the mission already uses a colleague’s, the page says whose it is, and only they can stop sharing it. Choose Stop sharing at any time to take it back from a mission.

In a mission where you shared the connection, ask Cora in the dialogue, for example:

  • “Which of our TikTok campaigns spent the most last week, and what did each return?”
  • “How did the three video ads in the spring ad group do on views and clicks?”
  • “Compare this month’s TikTok results with last month’s.”

Cora finds your ad accounts if she needs to know which one to use, reads the reports and answers with the figures and the dates they cover. If she says the mission has no TikTok Ads connection, go back to step 2.

Only these kinds of tools, and all of them only read:

  • Who you are and which accounts you can reach: your TikTok for Business user, the ad accounts’ details, and your Business Centers and the assets in them.
  • What is running: campaigns, ad groups and ads, including Smart+ and GMV Max campaigns.
  • How it did: integrated reports, large reports made as a task (Cora asks for the report, waits and downloads it; this changes no ad), video performance, ad benchmarks, creative reports, GMV Max reports, Smart+ material reports and split test results.

Cora’s own rule decides this, not TikTok’s labels. Her list of TikTok tools is a fixed list of names that only read. A tool that is not on the list is never switched on, never shared in a mission and never given to Cora, even if TikTok adds one later or loads one while she works. That means she cannot:

  • create, change, pause or delete a campaign, ad group or ad, or change a budget or a bid;
  • create or change audiences, catalogues, pixels, rules or creative;
  • read or move money (balances, payments and invoices), or change who can use an account;
  • start TikTok’s own diagnosis or creative testing agents.

If you want Cora to do any of these, it needs a separate decision and a separate release. Ask the product team.

Known limits. The rule follows TikTok’s host name on any port, not the path, so a connection to business-api.tiktok.com has the same fixed list however the address is written. It cannot follow traffic that has left TikTok’s address: a proxy you build yourself that forwards to TikTok gets round any rule based on the address, so a self-built proxy is out of scope and not covered by this limit.

TikTok ends each sign-in after about 30 days. When it does, the card says Needs reconnect and “Access ended at business-api.tiktok.com. TikTok ends each sign-in after about 30 days.” Cora skips the connection. Choose Reconnect, sign in to the same TikTok for Business account and approve again. The same connection comes back with the missions it was shared in. A short outage at TikTok does not cause this: Cora just tries again.

Put a reminder in your calendar for about four weeks after you connect, so the sign-in does not end in the middle of a report.

TikTok’s server loads only about 40 of its tools at first and loads the rest when asked. Cora does not ask it to load more, so she may see fewer reporting tools than the list above. After you connect, the card says how many tools are on. If a report you need is missing, tell the product team which one.

As a stop-gap you can use TikTok’s full server, which loads all its tools at once. A person has one connection to a service, so first choose Disconnect on your TikTok Ads card. Then choose Other MCP server (connect with the service’s sign-in), type the short name tiktok and the address https://business-api.tiktok.com/open_mcp/tt-ads-mcp-flat, and connect. It needs its own sign-in. The same fixed list of tools that only read applies, because the rule follows TikTok’s address, not the path.

  • The tokens are kept in one place. They go to the secrets store and are renewed by the API. Cora’s worker holds the current access token for one step, never the long-lived one. They never appear in the database, logs, audit entries or prompts.
  • Cora never sees your TikTok password. You sign in on TikTok’s page.
  • Only your own browser can finish a sign-in. If someone sends you a link to approve and you open it in a different browser, nothing is connected.
  • Only you can use it. No colleague can use your connection, and an org admin cannot either. Org admins can see who owns which connection and where it is shared, and can stop sharing or remove one for safety.
  • If you leave, it goes. When you leave the organisation, your connections are removed and the tokens deleted.
  • Everything is on the record. Adding, sharing, stopping sharing and disconnecting a connection, and every tool call, are in the audit log.

Choose Disconnect on the card. Cora asks TikTok to cancel the access, deletes the stored tokens and stops using the connection in every mission.