Документи

AdAce Ads для Claude, ChatGPT і Cursor

AdAce Ads — сервіс для агенцій і рекламодавців: Google Ads, Meta, LinkedIn і TikTok в одному місці, з аналітикою, аудитом відстеження сайту, пропозиціями змін і погодженням людиною. Через MCP ті самі дані й дії доступні у вашому AI-клієнті.

Claude: AdAce Ads є в каталозі конекторів

Відкрийте сторінку AdAce Ads у каталозі Claude, натисніть Connect і увійдіть — адресу копіювати не треба.

Додати в Claude

Що вміє

  • Читати: клієнти, кабінети, кампанії, показники й порівняння періодів, марні витрати, аномалії, пошукові запити, GA4 за мітками, органічний пошук (Search Console), аудит відстеження сайту.
  • Пропонувати зміни: бюджет, статус кампаній, груп і оголошень, мінус-слова. Зміна чекає погодження людини або — якщо так налаштовано політику клієнта — застосовується в межах лімітів лише для оборотних дій.
  • Створювати кампанії, групи й оголошення на паузі (без витрат).
  • У Claude, ChatGPT, Cursor і VS Code — інтерактивні картки: показники, діагностика, перемикач кабінету, кнопки «в чат».

Безпека

  • Вхід через OAuth: ви самі обираєте простір і дозволи (читання; пропозиції змін). Доступ можна відкликати будь-коли.
  • Інструменти, що змінюють дані, позначені для клієнта — Claude і ChatGPT питають підтвердження перед кожним викликом.
  • AI не погоджує зміни сам; усе в журналі; ключі й токени рекламних платформ не залишають сервер.

Адреса сервера

https://ads.adace.website/mcp

Як підключити

Claude

вхід через OAuth · веб, застосунок, Cowork · картки в чаті

  1. Найпростіше — з каталогу Claude: відкрийте https://claude.ai/directory/adace-ads і натисніть Connect (або в Claude: Customize → Connectors → Browse connectors → знайдіть AdAce Ads).
  2. Увійдіть в AdAce Ads, оберіть простір і дозволи (читання; пропозиції змін — за бажанням).
  3. Запасний шлях, вручну: Customize → Connectors → «+» → Add custom connector → адреса https://ads.adace.website/mcp → Add.
  4. Team чи Enterprise: власник організації додає конектор в Organization settings → Connectors → Add → Custom → Web, учасники натискають Connect у Customize → Connectors.
  5. У чаті: «+» → Connectors → увімкніть AdAce Ads. Відповіді показуються разом з інтерактивними картками.

ChatGPT

вхід через OAuth · веб і застосунки · картки в чаті

  1. Settings → Security and login → увімкніть Developer mode (доступність залежить від плану й політики робочого простору).
  2. У розділі застосунків ChatGPT натисніть «+» і додайте MCP-сервер: назва AdAce Ads, адреса https://ads.adace.website/mcp, автентифікація OAuth.
  3. Увійдіть в AdAce Ads і підтвердьте доступ.
  4. У новому чаті додайте AdAce Ads з меню інструментів. Відповіді показуються разом з інтерактивними картками.

Claude Code

вхід через OAuth · термінал

  1. Виконайте команду нижче.
  2. У Claude Code наберіть /mcp → adace-ads → Authenticate і увійдіть в AdAce Ads.
  3. Замість входу можна передати ключ: додайте до команди --header "Authorization: Bearer ak_…".
claude mcp add --transport http adace-ads https://ads.adace.website/mcp

Codex CLI

вхід через OAuth · термінал

  1. Виконайте команди нижче: друга відкриє вхід в AdAce Ads.
  2. Або з ключем у ~/.codex/config.toml: [mcp_servers.adace-ads] url = "https://ads.adace.website/mcp", bearer_token_env_var = "ADACE_ADS_KEY".
codex mcp add adace-ads --url https://ads.adace.website/mcp
codex mcp login adace-ads

Cursor

API-ключ · редактор · картки в чаті

  1. Створіть API-ключ на сторінці «Підключення AI».
  2. Додайте фрагмент у ~/.cursor/mcp.json (для всіх проєктів) або .cursor/mcp.json у проєкті, підставивши ключ.
  3. Перезапустіть Cursor; AdAce Ads з'явиться серед MCP-серверів.
{
  "mcpServers": {
    "adace-ads": {
      "url": "https://ads.adace.website/mcp",
      "headers": { "Authorization": "Bearer ak_…" }
    }
  }
}

VS Code (GitHub Copilot)

API-ключ · редактор · картки в чаті

  1. Створіть API-ключ на сторінці «Підключення AI».
  2. Додайте фрагмент у .vscode/mcp.json: ключ VS Code спитає один раз і збереже захищено.
  3. Увімкніть AdAce Ads у режимі агента Copilot.
{
  "servers": {
    "adace-ads": {
      "type": "http",
      "url": "https://ads.adace.website/mcp",
      "headers": { "Authorization": "Bearer ${input:adace-ads-key}" }
    }
  },
  "inputs": [{ "type": "promptString", "id": "adace-ads-key", "description": "AdAce Ads API key", "password": true }]
}

Windsurf / Devin Desktop

API-ключ · редактор

  1. Створіть API-ключ і збережіть його в змінній середовища ADACE_ADS_KEY.
  2. Додайте фрагмент у mcp_config.json (Windsurf: ~/.codeium/windsurf/, Devin Desktop: ~/.config/devin/).
  3. Оновіть список MCP-серверів у Cascade.
{
  "mcpServers": {
    "adace-ads": {
      "serverUrl": "https://ads.adace.website/mcp",
      "headers": { "Authorization": "Bearer ${env:ADACE_ADS_KEY}" }
    }
  }
}

Gemini CLI

API-ключ · термінал

  1. Створіть API-ключ на сторінці «Підключення AI».
  2. Виконайте команду нижче, підставивши ключ (або додайте в settings.json: httpUrl і headers).
gemini mcp add --transport http --header "Authorization: Bearer ak_…" adace-ads https://ads.adace.website/mcp

Grok

вхід через OAuth · веб

  1. Відкрийте grok.com/connectors → New Connector → Custom.
  2. Адреса MCP-сервера: https://ads.adace.website/mcp. Увійдіть в AdAce Ads, оберіть простір і дозволи (читання; пропозиції змін — за бажанням).
  3. Grok Business чи Enterprise: конектор спершу додає адміністратор команди; доступність залежить від плану.
  4. Grok сам бере інструменти AdAce Ads, коли питання стосується реклами.

Manus

вхід через OAuth · веб

  1. Settings → Connectors → «+ Add connectors» → вкладка Custom MCP.
  2. «+ Add custom MCP» → Direct configuration: назва AdAce Ads, транспорт HTTP, Server URL https://ads.adace.website/mcp → Save.
  3. У вікні входу увійдіть в AdAce Ads і підтвердьте доступ.
  4. Далі просто ставте завдання, наприклад: «Знайди марні витрати клієнта за останні 14 днів».

OpenClaw

вхід через OAuth · термінал

  1. Виконайте команди нижче: перша зберігає сервер, друга друкує посилання на вхід в AdAce Ads.
  2. Відкрийте посилання, увійдіть і підтвердьте доступ: OpenClaw прийме відповідь на локальній адресі.
  3. Вхід для OpenClaw — лише через OAuth: API-ключ у заголовку для цього клієнта не радимо.
openclaw mcp set adace-ads '{"url":"https://ads.adace.website/mcp","transport":"streamable-http","auth":"oauth"}'
openclaw mcp login adace-ads

Інший MCP-клієнт

OAuth або API-ключ · будь-який

  1. Транспорт Streamable HTTP, протокол MCP 2025-06-18 або 2025-03-26.
  2. Вхід: OAuth 2.1 з PKCE і динамічною реєстрацією клієнта, або API-ключ у заголовку Authorization.
  3. Клієнти з підтримкою MCP Apps показують інтерактивні картки.
URL: https://ads.adace.website/mcp
Authorization: Bearer ak_…
OAuth metadata: https://ads.adace.website/.well-known/oauth-authorization-server

Перевірка

Попросіть у клієнті: «Виклич get_started з AdAce Ads». На сторінці «Підключення AI» в AdAce Ads з'явиться це звернення.

Підтримка: info@adace.website · Політика приватності · Умови використання