How to Connect Claude Code to TikTok Ads MCP

Claude Code can use MCP servers as tools during a session. The exact configuration format depends on the client version and MCP provider, so treat the provider's current setup instructions as the source of truth for the server command and credentials.

Prepare a safe test

Choose one TikTok advertiser account and a short reporting period. Confirm the account's time zone, currency, conversion event, and attribution context. Start with read-only access and keep tokens out of source files, chat transcripts, and shell history where possible.

Add the TikTok Ads MCP server

1. Open the Claude Code MCP configuration path supported by your installation.
2. Add the provider's TikTok Ads MCP server definition.
3. Put credentials in the supported secret or environment-variable mechanism.
4. Reload the session and inspect the connected server list.
5. Confirm that TikTok Ads tools are available before asking for analysis.

Do not mix configuration keys from Cursor, Codex, or another MCP client. The server may be correct while the client cannot parse the entry.

Run the first read-only query

List the TikTok advertiser accounts available to this session.
For the account I select, summarize the last 7 days of spend, impressions,
clicks, conversions, CPA, and ROAS. Explain the filters and do not modify data.

Ask Claude Code to flag missing metrics and distinguish zero delivery from unavailable data. If the result is surprising, repeat the same query with a narrower date range and the account explicitly named.

Troubleshoot by layer

• No server: check the configuration path and whether the client reloaded it.
• No tools: inspect server startup output and advertised capabilities.
• Permission error: verify advertiser account and Business Center access.
• Empty result: confirm account selection, date range, time zone, and delivery status.
• Slow result: request fewer dimensions and a shorter period before retrying.

For a complete checklist, see TikTok Ads MCP troubleshooting. For general concepts, start with the TikTok Ads MCP beginner guide.

Review before any action

Keep analysis and execution as separate requests. Require an evidence table, proposed change, expected impact, owner, and rollback condition before a human approves any live-account change.