Для чего этот сервер?

Этот MCP-сервер подключает AI-ассистента к TikTok Ads API. Он управляет кампаниями, собирает статистику, меняет аудитории и креативы. Маркетологи автоматизируют рутину: запускают рекламу, смотрят метрики, корректируют настройки. Всё через текстовые команды — без ручного входа в кабинет TikTok или работы с API напрямую.

Каталог MCP
AdsMCP/tiktok-ads-mcp-server

AdsMCP/tiktok-ads-mcp-server

от adsmcp

Сервер по протоколу MCP для TikTok Ads API. AI-ассистенты управляют кампаниями, анализируют результативность и работают с аудиторией. Упрощает автоматизацию рекламы для маркетологов и агентств. Вкл...

Github Сайт сервера

README

Инструменты и схема сервера

Версии

Установить сервер

TikTok Ads MCP Server

A local Model Context Protocol (MCP) server for TikTok Ads API integration. It lets MCP clients such as Claude Desktop connect to TikTok Ads, authenticate with a TikTok Business app, and use read-only tools for campaign lookup, ad group and ad inspection, performance reporting, audience breakdowns, advertiser info, pixels, and targeting locations.

Hosted Option

This repository is for users who want to run a local TikTok Ads MCP server.

If you do not want to install Python, manage dependencies, or configure a TikTok developer app, AdsMCP provides a hosted remote MCP server:

AdsMCP Remote MCP Server Setup Guide

The rest of this README covers the local setup.

What This Server Does

Authentication: Start and complete TikTok Ads OAuth from an MCP client.
Campaign lookup: List campaigns, inspect campaign details, list ad groups, and inspect ads.
Performance analytics: Pull campaign, ad group, ad, and audience metrics for common date ranges.
Audience and account data: Retrieve custom audiences, advertiser info, location IDs, pixels, and pixel event stats.
Read-only operation: The public MCP tool registry does not expose campaign creation, ad group creation, creative upload, or other write operations.

Часто задаваемые вопросы

У этого сервера пока нет списка инструментов.

Выберите клиент, чтобы установить AdsMCP/tiktok-ads-mcp-server:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "adsmcp-tiktok-ads-mcp-server-exzck7u3np": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/tiktok-ads-mcp-server",
        "run",
        "python",
        "run_server.py"
      ],
      "env": {
        "TIKTOK_APP_ID": "your_app_id",
        "TIKTOK_APP_SECRET": "your_app_secret"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "adsmcp-tiktok-ads-mcp-server-exzck7u3np": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/tiktok-ads-mcp-server",
        "run",
        "python",
        "run_server.py"
      ],
      "env": {
        "TIKTOK_APP_ID": "your_app_id",
        "TIKTOK_APP_SECRET": "your_app_secret"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "adsmcp-tiktok-ads-mcp-server-exzck7u3np": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/tiktok-ads-mcp-server",
        "run",
        "python",
        "run_server.py"
      ],
      "env": {
        "TIKTOK_APP_ID": "your_app_id",
        "TIKTOK_APP_SECRET": "your_app_secret"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"adsmcp-tiktok-ads-mcp-server-exzck7u3np\",\"type\":\"stdio\",\"command\":\"uv\",\"args\":[\"--directory\",\"/absolute/path/to/tiktok-ads-mcp-server\",\"run\",\"python\",\"run_server.py\"],\"env\":{\"TIKTOK_APP_ID\":\"your_app_id\",\"TIKTOK_APP_SECRET\":\"your_app_secret\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "adsmcp-tiktok-ads-mcp-server-exzck7u3np": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/tiktok-ads-mcp-server",
        "run",
        "python",
        "run_server.py"
      ],
      "env": {
        "TIKTOK_APP_ID": "your_app_id",
        "TIKTOK_APP_SECRET": "your_app_secret"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add adsmcp-tiktok-ads-mcp-server-exzck7u3np --env TIKTOK_APP_ID=your_app_id --env TIKTOK_APP_SECRET=your_app_secret -- uv --directory /absolute/path/to/tiktok-ads-mcp-server run python run_server.py

Либо через JSON-конфиг:

claude mcp add-json adsmcp-tiktok-ads-mcp-server-exzck7u3np "{\"command\":\"uv\",\"args\":[\"--directory\",\"/absolute/path/to/tiktok-ads-mcp-server\",\"run\",\"python\",\"run_server.py\"],\"env\":{\"TIKTOK_APP_ID\":\"your_app_id\",\"TIKTOK_APP_SECRET\":\"your_app_secret\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add adsmcp-tiktok-ads-mcp-server-exzck7u3np --env TIKTOK_APP_ID=your_app_id --env TIKTOK_APP_SECRET=your_app_secret -- uv --directory /absolute/path/to/tiktok-ads-mcp-server run python run_server.py

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.adsmcp-tiktok-ads-mcp-server-exzck7u3np]
command = "uv"
args = ["--directory", "/absolute/path/to/tiktok-ads-mcp-server", "run", "python", "run_server.py"]

[mcp_servers.adsmcp-tiktok-ads-mcp-server-exzck7u3np.env]
TIKTOK_APP_ID = "your_app_id"
TIKTOK_APP_SECRET = "your_app_secret"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите AdsMCP/tiktok-ads-mcp-server, а в поле команды запуска — строку ниже:

uv --directory /absolute/path/to/tiktok-ads-mcp-server run python run_server.py

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "adsmcp-tiktok-ads-mcp-server-exzck7u3np": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/tiktok-ads-mcp-server",
        "run",
        "python",
        "run_server.py"
      ],
      "env": {
        "TIKTOK_APP_ID": "your_app_id",
        "TIKTOK_APP_SECRET": "your_app_secret"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "adsmcp-tiktok-ads-mcp-server-exzck7u3np": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/tiktok-ads-mcp-server",
        "run",
        "python",
        "run_server.py"
      ],
      "env": {
        "TIKTOK_APP_ID": "your_app_id",
        "TIKTOK_APP_SECRET": "your_app_secret"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например adsmcp-tiktok-ads-mcp-server-exzck7u3np.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: adsmcp-tiktok-ads-mcp-server-exzck7u3np
    command: uv
    args:
      - "--directory"
      - "/absolute/path/to/tiktok-ads-mcp-server"
      - "run"
      - "python"
      - "run_server.py"
    env:
      TIKTOK_APP_ID: your_app_id
      TIKTOK_APP_SECRET: your_app_secret

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "adsmcp-tiktok-ads-mcp-server-exzck7u3np": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/tiktok-ads-mcp-server",
        "run",
        "python",
        "run_server.py"
      ],
      "env": {
        "TIKTOK_APP_ID": "your_app_id",
        "TIKTOK_APP_SECRET": "your_app_secret"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "uv",
  "args": [
    "--directory",
    "/absolute/path/to/tiktok-ads-mcp-server",
    "run",
    "python",
    "run_server.py"
  ],
  "env": {
    "TIKTOK_APP_ID": "your_app_id",
    "TIKTOK_APP_SECRET": "your_app_secret"
  }
}