일일 TikTok 계정 health check
Today
TikTok Ads Manager를 열고 각 캠페인에 들어가 어제 지출과 광고 그룹별 ROAS를 복사한 뒤 Notion에 붙여 넣습니다. 실제 업무가 시작되기 전, 매일 아침 20분입니다.
TikTok Ads MCP
Claude 안에서 모든 클라이언트 계정의 어제 TikTok Ads 지출, ROAS, CTR을 30초 안에 가져오세요.
여러 TikTok 광고 계정을 운영하는 paid-media 운영자를 위해 만들었습니다. 한 번 로그인하면 모든 클라이언트를 다룹니다. Python server를 self-host하거나, 호스팅 엔드포인트로 TikTok developer review를 완전히 건너뛰세요.
- 아침 리포트
- 하루 20분
Who this is for
TikTok의 광고 데이터에 접근하는 일은 Facebook보다 더 번거롭습니다. 어떤 reporting tool이 광고 계정과 통신하기 전, 마케터는 TikTok이 developer app을 승인할 때까지 며칠을 기다립니다.
How this changes your work
Use it with
TikTok Ads MCP works with Claude Desktop, Claude Code, Cursor, Codex, Gemini, Windsurf, OpenClaw, and Hermes — any MCP-compatible AI client. Get it running in seconds.
Compatible withClaude Desktop(로컬 stdio)AdsMCP Remote MCP (권장)
Install on ElasticFlow
One click. Managed auth.
Pre-configured environment, OAuth handled for you. No command-line work.
Install on ElasticFlow →Managed auth · No laptop setup.
OAuth — authorise in one click
Install on your AI client
Claude Desktop(로컬 stdio) · AdsMCP Remote MCP (권장)
Copy a config snippet into your AI client and restart.
- 첫 실행 전에 `pip install -e .` 또는 `uv sync`를 실행하세요.
- 로컬 self-host에는 TikTok Developer Portal app review가 필요합니다.
{
"mcpServers": {
"tiktok-ads": {
"command": "python",
"args": ["/path/to/adsmcp-server/run_server.py"],
"cwd": "/path/to/adsmcp-server",
"env": {
"TIKTOK_APP_ID": "your_app_id",
"TIKTOK_APP_SECRET": "your_app_secret"
}
}
}
}claude_desktop_config.json을 편집한 뒤 Claude Desktop을 재시작하세요.
Authentication
Steps
- TikTok에 광고 데이터를 읽고 싶다고 알리기
business-api.tiktok.com → My Apps → Create App으로 이동하세요. developer app을 등록하는 과정이며, TikTok이 광고 계정과 통신하도록 허용하기 전에 보통 1-3일 동안 review합니다. 기다리고 싶지 않다면 adsmcp.com/onboarding의 AdsMCP 호스팅 엔드포인트가 이미 이 단계를 통과해 두었습니다.
- TikTok이 제공하는 두 key 복사
앱이 승인되면 TikTok developer console에서 App ID와 App Secret을 복사하세요. 광고주 ID(TikTok Ads Manager의 act_… 번호)도 적어 두세요. Claude가 처음 작업할 광고 계정입니다.
- 환경에 key 넣기
TIKTOK_APP_ID와 TIKTOK_APP_SECRET을 .env 파일 또는 MCP client config의 env block에 추가하세요. 서버는 시작 시 이를 읽기 때문에 민감한 key를 Claude 자체에 붙여 넣지 않습니다.
- Claude에서 TikTok 로그인
Claude에게 TikTok 연결을 시작하라고 요청하세요. Claude가 one-time URL을 제공합니다. 열어서 작업할 advertiser account 접근을 승인하고, TikTok이 반환하는 code를 복사해 한 번의 prompt로 Claude에 돌려주세요. 이후 Claude가 연결을 자동으로 갱신합니다.
- 작업 중 클라이언트 광고 계정 전환
여러 클라이언트를 관리할 때는 Claude에게 다른 advertiser ID로 전환하라고 요청하세요. 모든 계정을 볼 수 있는 TikTok user로 한 번 로그인했기 때문에, 다시 로그인하지 않고 prompt마다 계정을 이동합니다.
Scopes explained
| Scope | Why this MCP needs it |
|---|---|
user_info | 어떤 TikTok For Business user가 로그인했는지 확인합니다. Claude가 볼 수 있는 advertiser account를 판단하는 데 사용됩니다. |
campaign.management | 캠페인과 광고 그룹을 확인하는 데 필요합니다. 향후 release에서 이를 수정하는 데도 필요합니다. |
ads.reporting | 지출, ROAS, CTR, 전환을 가져오는 데 필요합니다. 즉 리포트 데이터입니다. |
Troubleshooting
~7 min first time
MIT · v0.1.0 · released today
Categories
Department
Metrics impacted