Synter Ads MCP Server

官方

跨平台廣告活動管理，支援AI代理在Google、Meta、LinkedIn、Reddit、TikTok等平台操作，提供140多個具讀寫權限的工具。

GitHub
12

文件

Synter MCP 伺服器

npm version License: MIT

Claude 不想讓你使用的 MCP 擴充功能。

因為一旦安裝，你的 AI 代理就能花費真實金錢。

建立廣告活動。調整預算。暫停成效不佳的項目。產生廣告素材。擷取成效資料。全部透過自然對話完成——橫跨 Google、Meta、LinkedIn、Microsoft、Reddit、TikTok 等平台。

這是第一個賦予 AI 代理信用卡權限的 Model Context Protocol (MCP) 伺服器。

為何選擇 Synter？

大多數廣告 MCP 伺服器都是唯讀且單一平台。Synter 是唯一具備完整讀寫能力的跨平台廣告管理 MCP 伺服器：

功能SynterGoogle Ads MCPAmazon Ads MCP其他
平台9+ (Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X, StackAdapt, TTD)僅 Google僅 Amazon1-2
建立廣告活動✅❌ 唯讀✅ 僅 Amazon❌
調整預算✅❌✅❌
暫停廣告活動✅❌✅❌
AI 廣告素材生成✅ (Imagen 4, Veo, Flux)❌❌❌
出價最佳化✅❌❌❌
AI 策略師✅❌❌❌
開放原始碼✅✅❌視情況而定

一個 MCP 伺服器。所有廣告平台。讀取與寫入。

⚠️ 善意提醒

你的 AI 代理將能夠：

  • 建立廣告活動，並立即開始花費你的預算
  • 調整出價，影響你每次點擊支付的費用
  • 暫停廣告活動（有時這是好事）
  • 新增關鍵字，改變看到你廣告的受眾
  • 產生廣告素材並上傳到你的帳戶

我們已為破壞性操作內建確認機制。但還是——也許不要把它交給一個你剛認識的代理。

快速入門

1. 取得你的 API 金鑰

在 syntermedia.ai 註冊，並在開發者設定中建立 API 金鑰。

2. 設定你的 AI 客戶端

適用於 Claude Desktop — 新增至 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["@synterai/mcp-server"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

適用於 Cursor — 在你的專案中新增至 .cursor/mcp.json：

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["@synterai/mcp-server"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

適用於 Amp — 新增至 .amp/settings.json：

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["@synterai/mcp-server"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

遠端 (Streamable HTTP) — 適用於 ChatGPT、n8n、Zapier 或任何支援 HTTP 傳輸的 MCP 客戶端：

URL: https://mcp.syntermedia.ai/mcp/
Header: X-Synter-Key: syn_your_api_key_here

無需本機安裝。可與任何支援 Streamable HTTP 傳輸的 MCP 客戶端搭配使用。

3. 開始使用

重新啟動你的 AI 客戶端並開始對話：

"顯示我所有的 Google Ads 廣告活動"

"為「專案管理軟體」建立一個搜尋廣告活動，每日預算 $50"

"暫停那個超支的廣告活動"

偏好完整的插件嗎？ (Claude Code / Claude Desktop)

此套件是原始的 MCP 伺服器。如果你使用 Claude Code 或 Claude Desktop，Synter 插件 以現成的技能 (/synter:launch、/synter:audience、/synter:optimize、…)、專業化代理以及花費前核准的安全掛鉤包裝了相同的伺服器：

/plugin marketplace add Synter-Media-AI/plugin
/plugin install synter@synter

它還附帶一個用於自動化的無頭 Claude Agent SDK 執行器。請參閱插件儲存庫或 Claude 插件指南。當你只需要工具，或正在連接另一個客戶端時，可以直接使用此 MCP 套件。

你的代理能做什麼？

📊 廣告活動管理

工具說明
list_campaigns列出所有已連結平台的廣告活動
create_search_campaign建立包含關鍵字和廣告的 Google 搜尋廣告活動
create_display_campaign建立包含圖片的 Google 多媒體廣告活動
create_pmax_campaign建立最高成效廣告活動
create_meta_campaign建立 Facebook/Instagram 廣告活動
create_linkedin_campaign建立適用於 B2B 的 LinkedIn 廣告活動
create_reddit_campaign建立 Reddit 廣告活動
pause_campaign暫停任何廣告活動
update_campaign_budget變更每日預算

📈 成效與分析

工具說明
get_performance取得曝光次數、點擊次數、花費、轉換次數、ROAS
get_daily_spend按平台劃分的每日花費明細

🎯 關鍵字與目標鎖定

工具說明
add_keywords將關鍵字新增至廣告活動或廣告群組
add_negative_keywords封鎖不需要的搜尋字詞

🔄 轉換追蹤

工具說明
create_conversion設定轉換動作
list_conversions列出現有的轉換動作
diagnose_tracking檢查追蹤程式碼是否正確安裝

🎨 廣告素材生成

工具說明
generate_imageAI 生成廣告圖片 (Imagen 4、Flux、SDXL)
generate_videoAI 生成影片廣告 (Veo、Runway、Luma)
upload_image將圖片上傳為廣告素材資源

🔧 實用工具

工具說明
list_ad_accounts列出所有已連結的廣告帳戶
run_tool直接執行 140 多個 Synter 工具中的任何一個

沒有廣告經驗？沒問題。

如果你從未投放過廣告，以下是需要了解的內容：

什麼是廣告活動？

廣告活動就像一個專案資料夾。它包含你的廣告、誰會看到它們，以及你花費多少。

Campaign: "Q1 Lead Generation"
├── Budget: $50/day
├── Targeting: USA, people searching "project management"
└── Ads: Headlines, descriptions, images

我可以使用哪些平台？

平台最適合最低預算
Google Ads正在積極搜尋你產品的人$10/天
Meta (Facebook/Instagram)視覺化產品、廣泛的受眾$5/天
LinkedInB2B、企業、求職者$25/天
Reddit小眾社群、精通科技的用戶$5/天
Microsoft (Bing)較年長的族群、B2B$10/天
TikTokZ 世代、娛樂、電子商務$20/天

廣告活動類型說明

搜尋廣告活動 — 當有人在 Google 搜尋特定關鍵字時，你的廣告就會顯示。

  • 範例： 有人搜尋「最佳 CRM 軟體」→ 你的廣告出現

多媒體廣告活動 — 在網站和應用程式中顯示的圖片廣告。

  • 範例： 新聞網站上的橫幅廣告

最高成效 (PMax) — Google 的 AI 會在各處顯示你的廣告（搜尋、YouTube、多媒體、Gmail、地圖）。

  • 範例： Google 為你找出最佳的刊登位置

影片廣告活動 — 在 YouTube 和合作夥伴網站上的影片廣告。

  • 範例： YouTube 影片播放前的 15 秒廣告

常見術語

術語含義
曝光次數你的廣告被顯示的次數
點擊次數有多少人點擊了你的廣告
CTR點擊率 (點擊次數 ÷ 曝光次數 × 100)
CPC每次點擊成本
轉換次數期望的動作 (註冊、購買等)
ROAS廣告投資報酬率 (收益 ÷ 花費)

首次廣告活動檢查清單

在建立第一個廣告活動之前，你需要：

  1. ✅ 一個到達頁面網址，讓人們點擊後前往
  2. ✅ 了解你想觸及的對象（地點、興趣）
  3. ✅ 一個你感到滿意的每日預算（開始時 $10-50）
  4. ✅ 一些廣告的標題和說明

專業提示： 從 Google 上的搜尋廣告活動開始。這最容易理解，並且會向已經在尋找你所提供內容的人顯示廣告。

對話範例

建立你的第一個廣告活動

你： 為我的 SaaS 產品建立一個 Google 搜尋廣告活動。目標對象是搜尋「團隊協作軟體」和「專案管理工具」的人。預算為每天 $25。到達頁面是 https://myapp.com/signup

代理： 我將使用這些關鍵字建立一個搜尋廣告活動。我應該使用哪些標題？以下是一些建議：

  • "團隊協作，輕鬆簡單"
  • "現代團隊的專案管理"
  • "免費開始 - 無需信用卡"

檢查成效

你： 我這週的廣告活動表現如何？

代理： 以下是過去 7 天的成效：

廣告活動花費點擊次數轉換次數ROAS
品牌搜尋$14289124.2x
競爭對手關鍵字$984531.5x
多媒體再行銷$6723482.8x

「競爭對手關鍵字」廣告活動表現不佳。要我暫停它或調整目標鎖定嗎？

新增排除關鍵字

你： 我收到「免費專案管理」的點擊，但我們沒有免費方案。封鎖這些。

代理： 已將「免費」新增為廣告活動的排除關鍵字。這將阻止你的廣告在任何包含「免費」的搜尋中顯示。

生成廣告素材

你： 我需要一個行銷自動化產品的多媒體廣告圖片。深色主題、專業、1200x628。

代理： 正在使用 Imagen 4 生成你的圖片...

已建立："深色背景上帶有資料視覺化的行銷自動化儀表板" 素材已儲存，可在下一個多媒體廣告活動中使用。

連結你的廣告帳戶

若要管理每個平台上的廣告，你需要在 Synter 中連結你的帳戶：

  1. 前往 syntermedia.ai/settings/credentials
  2. 點擊每個平台旁邊的「連結」
  3. 完成 OAuth 流程
  4. 你的代理現在可以管理該平台

支援的平台：

  • Google Ads ✅
  • Meta (Facebook/Instagram) ✅
  • LinkedIn Ads ✅
  • Microsoft Ads (Bing) ✅
  • Reddit Ads ✅
  • TikTok Ads ✅
  • X (Twitter) Ads ✅
  • StackAdapt ✅
  • The Trade Desk ✅

進階：直接工具存取

對於進階使用者，你可以直接呼叫 140 多個 Synter 工具中的任何一個：

> Use run_tool to call google_ads_list_audiences

在 docs.syntermedia.ai/tools 查看完整的工具清單，或詢問你的代理：

> What tools are available for LinkedIn Ads?

環境變數

變數必要說明
SYNTER_API_KEY是你的 Synter API 金鑰
SYNTER_API_URL否API URL 覆寫 (預設：https://syntermedia.ai)

本機開發

# Clone and install
git clone https://github.com/Synter-Media-AI/mcp-server.git
cd mcp-server
npm install

# Build
npm run build

# Run locally
SYNTER_API_KEY=syn_your_key_here node dist/index.js

疑難排解

"SYNTER_API_KEY 未設定"

確保你的 API 金鑰位於 MCP 設定的 env 區段中。金鑰應以 syn_ 開頭。

"無效或過期的 API 金鑰"

  1. 檢查你是否複製了完整的金鑰（它們很長！）
  2. 在 syntermedia.ai/developer 驗證金鑰是否有效
  3. 確保金鑰具有 tools:write 範圍

"沒有已連結的廣告帳戶"

你需要連結至少一個廣告平台：

  1. 前往 syntermedia.ai/settings/credentials
  2. 點擊 Google Ads（或其他平台）旁邊的「連結」
  3. 完成 OAuth 授權

工具未顯示在 Claude/Cursor 中

  1. 完全重新啟動你的 AI 客戶端（不僅僅是重新整理）
  2. 檢查 MCP 伺服器記錄檔是否有錯誤
  3. 驗證設定檔路徑和 JSON 語法

資源

授權

MIT 授權 - 詳情請參閱 LICENSE。

Synter
他們不想讓你使用的 MCP 擴充功能。
因為擁有廣告預算的 AI 代理改變了一切。