Synter Ads

chính thức

Quản lý chiến dịch quảng cáo đa nền tảng cho các tác nhân AI trên Google, Meta, LinkedIn, Reddit, TikTok và nhiều nền tảng khác. Hơn 140 công cụ với quyền truy cập đọc/ghi.

GitHub
17
Dùng thử MCP nàyĐược tài trợ

Bạn có thể làm gì với Synter Ads MCP?

  • Liệt kê chiến dịch trên nhiều nền tảng — Yêu cầu trợ lý của bạn kéo tất cả chiến dịch từ các tài khoản quảng cáo đã kết nối bằng list_campaigns.
  • Tạo chiến dịch tìm kiếm — Sử dụng create_search_campaign để khởi chạy chiến dịch Google Search với từ khóa, quảng cáo và ngân sách.
  • Tạm dừng chiến dịch kém hiệu quả — Dừng bất kỳ chiến dịch nào ngay lập tức qua pause_campaign khi chi phí hoặc ROAS có dấu hiệu bất thường.
  • Kéo số liệu hiệu suất — Lấy số lần hiển thị, lượt nhấp, chi phí, chuyển đổi và ROAS bằng get_performance.
  • Tạo nội dung quảng cáo — Dùng generate_image hoặc generate_video để tạo tài sản quảng cáo sẵn sàng tải lên.
  • Chạy bất kỳ công cụ nào trong số 140+ công cụ — Truy cập toàn bộ danh mục Synter trực tiếp bằng run_tool cho các thao tác nâng cao.

Tài liệu

Máy chủ MCP Synter

npm version License: MIT

Máy chủ MCP đầy đủ nhất cho quảng cáo.

Báo cáo trên 19 nền tảng quảng cáo và tạo chiến dịch đầy đủ trên 14 nền tảng trong số đó (hành động ghi trên 16), bao phủ mọi kênh mua quảng cáo chính, với xác nhận tích hợp cho các hành động phá hủy.

Tạo chiến dịch. Điều chỉnh ngân sách. Tạm dừng các chiến dịch hoạt động kém. Tạo nội dung sáng tạo. Kéo dữ liệu hiệu suất. Tất cả thông qua hội thoại tự nhiên, trên Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X, và nhiều hơn nữa.

Đây là máy chủ Giao thức Ngữ cảnh Mô hình (MCP) đầu tiên cấp cho tác nhân AI một thẻ tín dụng.

Lưu ý: Synter-Media-AI/plugin là kho plugin Claude có thể cài đặt chính thức. Bản sao .claude-plugin/ trong kho này không phải là nguồn cài đặt.


Synter So Sánh Như Thế Nào

Máy chủ MCP Google Ads chính thức chỉ đọc theo thiết kế: theo tài liệu của Google, nó "chỉ đọc nghiêm ngặt" và "không thể sửa đổi giá thầu, tạm dừng chiến dịch hoặc tạo tài sản mới." Hầu hết các máy chủ MCP quảng cáo của bên thứ ba chỉ bao phủ một nền tảng duy nhất. Chúng tôi xây dựng Synter để thực hiện cả hai phần công việc, trên mọi kênh mua quảng cáo chính, từ một máy chủ duy nhất.

Synter MCPGoogle Ads MCP chính thứcMCP quảng cáo bên thứ ba điển hình
Truy cậpĐọc trên tất cả 19 nền tảng, tạo chiến dịch trên 14, hành động ghi trên 16Chỉ đọc (bản phát hành hiện tại)Thường chỉ đọc hoặc ghi một phần
Nền tảng19 báo cáo, 14 có tạo chiến dịch đầy đủ (danh sách bên dưới)Chỉ Google AdsThường là một nền tảng duy nhất
Tạo chiến dịch✅ Google Search, Display, PMax, Meta, LinkedIn, Reddit, và nhiều hơn qua run_tool❌Hiếm khi
Ngân sách và tạm dừng✅❌Khác nhau
Tạo nội dung sáng tạo bằng AI✅ Hình ảnh, video, văn bản❌❌
Đồng bộ đối tượng✅ Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X❌❌
An toànXác nhận cho các hành động phá hủyn/a (chỉ đọc)Khác nhau
Mã nguồn mở✅ MIT✅Khác nhau

Phạm vi báo cáo (19 nền tảng): Google Ads, Microsoft Ads (Bing), Meta (Facebook và Instagram), LinkedIn Ads, X (Twitter) Ads, Reddit Ads, TikTok Ads, Snapchat Ads, Pinterest Ads, Spotify Ads, Amazon Ads, Amazon DSP, Walmart Connect, Instacart Ads, Target Roundel, Criteo, The Trade Desk, Display & Video 360, và OpenAI Ads (ChatGPT).

Tạo chiến dịch đầy đủ (14 nền tảng): Google Ads, Microsoft Ads, Meta, LinkedIn, X, Reddit, TikTok, Snapchat, Pinterest, Spotify, Amazon Ads (Sponsored Products, Brands, và Display), Amazon DSP, The Trade Desk, và OpenAI Ads. Display & Video 360 và StackAdapt hỗ trợ thêm các hành động ghi (tạm dừng, cập nhật ngân sách và mục dòng, tải lên đối tượng) mà không cần tạo chiến dịch. 4 nền tảng còn lại (Walmart Connect, Instacart, Target Roundel, và Criteo) hiện chỉ báo cáo.

Gói npx cung cấp các công cụ có kiểu dữ liệu cho các thao tác phổ biến nhất cùng với quyền truy cập run_tool vào toàn bộ danh mục hơn 140 công cụ Synter. Máy chủ từ xa tại https://mcp.syntermedia.ai/mcp/ hiển thị toàn bộ bộ công cụ được lưu trữ, bao gồm cả việc kéo hiệu suất cho mọi nền tảng ở trên.

Để khám phá MCP theo kiểu registry, server.json là nguồn sự thật có thể đọc bằng máy. Giữ nó đồng bộ với package.json, manifest.json, và các ví dụ thiết lập trong README này.


⚠️ Cảnh Báo Công Bằng

Tác nhân AI của bạn sẽ có thể:

  • Tạo chiến dịch ngay lập tức bắt đầu tiêu ngân sách của bạn
  • Điều chỉnh giá thầu ảnh hưởng đến số tiền bạn trả cho mỗi lần nhấp
  • Tạm dừng chiến dịch (đôi khi đó là điều tốt)
  • Thêm từ khóa thay đổi ai nhìn thấy quảng cáo của bạn
  • Tạo nội dung sáng tạo và tải chúng lên tài khoản của bạn

Chúng tôi đã xây dựng xác nhận cho các hành động phá hủy. Nhưng vẫn vậy, có lẽ đừng giao cái này cho một tác nhân bạn mới gặp.


Bắt Đầu Nhanh

1. Lấy Khóa API Của Bạn

Đăng ký tại syntermedia.ai và tạo khóa API trong Cài đặt Nhà phát triển.

2. Cấu Hình Ứng Dụng AI Của Bạn

Cho Claude Desktop: Thêm vào ~/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"
      }
    }
  }
}

Cho Cursor: Thêm vào .cursor/mcp.json trong dự án của bạn:

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

Cho Amp: Thêm vào .amp/settings.json:

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

Từ xa (Streamable HTTP): Cho ChatGPT, n8n, Zapier, hoặc bất kỳ ứng dụng MCP nào hỗ trợ giao thức HTTP:

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

Không cần cài đặt cục bộ. Hoạt động với bất kỳ ứng dụng MCP nào hỗ trợ giao thức Streamable HTTP.

3. Bắt Đầu Sử Dụng

Khởi động lại ứng dụng AI của bạn và bắt đầu trò chuyện:

"Hiển thị tất cả chiến dịch Google Ads của tôi"

"Tạo một chiến dịch tìm kiếm cho 'phần mềm quản lý dự án' với ngân sách $50/ngày"

"Tạm dừng chiến dịch đang chi tiêu quá mức"


Muốn một plugin đầy đủ? (Claude Code / Claude Desktop)

Gói này là máy chủ MCP thô. Nếu bạn sử dụng Claude Code hoặc Claude Desktop, plugin Synter bao bọc cùng máy chủ này với các kỹ năng được chuẩn bị sẵn (/synter:launch, /synter:audience, /synter:optimize, …), các tác nhân chuyên biệt, và một móc an toàn phê duyệt trước khi chi tiêu:

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

Nó cũng cung cấp một trình chạy Claude Agent SDK không đầu cho tự động hóa. Xem kho plugin hoặc hướng dẫn Claude Plugin. Sử dụng gói MCP này trực tiếp khi bạn chỉ muốn các công cụ, hoặc đang kết nối một ứng dụng khác.


Tác Nhân Của Bạn Có Thể Làm Gì?

📊 Quản Lý Chiến Dịch

Công cụMô tả
list_campaignsLiệt kê các chiến dịch trên tất cả các nền tảng đã kết nối
create_search_campaignTạo chiến dịch Google Search với từ khóa và quảng cáo
create_display_campaignTạo chiến dịch Google Display với hình ảnh
create_pmax_campaignTạo chiến dịch Performance Max
create_meta_campaignTạo chiến dịch Facebook/Instagram
create_linkedin_campaignTạo chiến dịch LinkedIn cho B2B
create_reddit_campaignTạo chiến dịch Reddit
pause_campaignTạm dừng bất kỳ chiến dịch nào
update_campaign_budgetThay đổi ngân sách hàng ngày

📈 Hiệu Suất & Phân Tích

Công cụMô tả
get_performanceLấy số lần hiển thị, nhấp chuột, chi tiêu, chuyển đổi, ROAS
get_daily_spendPhân tích chi tiêu hàng ngày theo nền tảng

🎯 Từ Khóa & Nhắm Mục Tiêu

Công cụMô tả
add_keywordsThêm từ khóa vào chiến dịch hoặc nhóm quảng cáo
add_negative_keywordsChặn các cụm từ tìm kiếm không mong muốn

🔄 Theo Dõi Chuyển Đổi

Công cụMô tả
create_conversionThiết lập một hành động chuyển đổi
list_conversionsLiệt kê các hành động chuyển đổi hiện có
diagnose_trackingKiểm tra xem theo dõi đã được cài đặt đúng chưa

🎨 Tạo Nội Dung Sáng Tạo

Công cụMô tả
generate_imageTạo hình ảnh quảng cáo bằng AI
generate_videoTạo video quảng cáo bằng AI
upload_imageTải lên hình ảnh làm tài sản quảng cáo

🔧 Tiện Ích

Công cụMô tả
list_ad_accountsLiệt kê tất cả các tài khoản quảng cáo đã kết nối
run_toolChạy trực tiếp bất kỳ công cụ nào trong số 140+ công cụ Synter

Không Có Kinh Nghiệm Quảng Cáo? Không Vấn Đề.

Nếu bạn chưa bao giờ chạy quảng cáo trước đây, đây là những gì bạn cần biết:

Chiến Dịch Là Gì?

Một chiến dịch giống như một thư mục dự án. Nó chứa quảng cáo của bạn, ai nhìn thấy chúng, và bạn chi bao nhiêu.

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

Tôi Có Thể Sử Dụng Những Nền Tảng Nào?

Nền tảngTốt nhất choNgân sách tối thiểu
Google AdsNhững người đang tích cực tìm kiếm sản phẩm của bạn$10/ngày
Meta (Facebook/Instagram)Sản phẩm trực quan, đối tượng rộng$5/ngày
LinkedInB2B, doanh nghiệp, người tìm việc$25/ngày
RedditCộng đồng ngách, người dùng am hiểu công nghệ$5/ngày
Microsoft (Bing)Nhóm nhân khẩu lớn tuổi, B2B$10/ngày
TikTokGen Z, giải trí, thương mại điện tử$20/ngày

Các Loại Chiến Dịch Được Giải Thích

Chiến dịch Tìm kiếm: Quảng cáo của bạn hiển thị khi ai đó tìm kiếm các từ khóa cụ thể trên Google.

  • Ví dụ: Ai đó tìm kiếm "phần mềm CRM tốt nhất" → Quảng cáo của bạn xuất hiện

Chiến dịch Hiển thị: Quảng cáo hình ảnh hiển thị trên các trang web và ứng dụng.

  • Ví dụ: Quảng cáo banner trên một trang tin tức

Performance Max (PMax): AI của Google hiển thị quảng cáo của bạn ở mọi nơi (Tìm kiếm, YouTube, Hiển thị, Gmail, Maps).

  • Ví dụ: Google tự tìm ra các vị trí tốt nhất cho bạn

Chiến dịch Video: Quảng cáo video trên YouTube và các trang đối tác.

  • Ví dụ: Quảng cáo 15 giây trước một video YouTube

Các Thuật Ngữ Phổ Biến

Thuật ngữÝ nghĩa
Số lần hiển thịSố lần quảng cáo của bạn được hiển thị
Nhấp chuộtSố người đã nhấp vào quảng cáo của bạn
CTRTỷ lệ nhấp (nhấp chuột ÷ số lần hiển thị × 100)
CPCChi phí mỗi lần nhấp
Chuyển đổiCác hành động mong muốn (đăng ký, mua hàng, v.v.)
ROASLợi tức trên chi tiêu quảng cáo (doanh thu ÷ chi tiêu)

Danh Sách Kiểm Tra Chiến Dịch Đầu Tiên

Trước khi tạo chiến dịch đầu tiên, bạn sẽ cần:

  1. ✅ URL trang đích nơi mọi người sẽ đến khi họ nhấp
  2. ✅ Ý tưởng về đối tượng bạn muốn tiếp cận (vị trí, sở thích)
  3. ✅ Ngân sách hàng ngày bạn cảm thấy thoải mái ($10-50 để bắt đầu)
  4. ✅ Một số tiêu đề và mô tả cho quảng cáo của bạn

Mẹo chuyên nghiệp: Bắt đầu với chiến dịch Tìm kiếm trên Google. Đó là loại dễ hiểu nhất và hiển thị quảng cáo cho những người đã đang tìm kiếm những gì bạn cung cấp.


Ví Dụ Hội Thoại

Tạo Chiến Dịch Đầu Tiên Của Bạn

Bạn: Tạo một chiến dịch Google Search cho sản phẩm SaaS của tôi. Nhắm mục tiêu những người tìm kiếm "phần mềm cộng tác nhóm" và "công cụ quản lý dự án". Ngân sách là $25/ngày. Trang đích là https://myapp.com/signup

Tác nhân: Tôi sẽ tạo một chiến dịch Tìm kiếm với các từ khóa đó. Bạn muốn sử dụng những tiêu đề nào? Đây là một số gợi ý:

  • "Cộng Tác Nhóm Trở Nên Đơn Giản"
  • "Quản Lý Dự Án Cho Đội Ngũ Hiện Đại"
  • "Bắt Đầu Miễn Phí - Không Cần Thẻ Tín Dụng"

Kiểm Tra Hiệu Suất

Bạn: Các chiến dịch của tôi hoạt động thế nào trong tuần này?

Tác nhân: Đây là hiệu suất của bạn trong 7 ngày qua:

Chiến dịchChi tiêuNhấp chuộtChuyển đổiROAS
Tìm kiếm thương hiệu$14289124.2x
Từ khóa đối thủ$984531.5x
Nhắm lại đối tượng hiển thị$6723482.8x

Chiến dịch "Từ khóa đối thủ" đang hoạt động kém. Bạn có muốn tôi tạm dừng nó hoặc điều chỉnh nhắm mục tiêu không?

Thêm Từ Khóa Phủ Định

Bạn: Tôi đang nhận nhấp chuột cho "quản lý dự án miễn phí" nhưng chúng tôi không có gói miễn phí. Chặn những từ đó.

Tác nhân: Đã thêm "miễn phí" làm từ khóa phủ định vào chiến dịch của bạn. Điều này sẽ ngăn quảng cáo của bạn hiển thị cho bất kỳ tìm kiếm nào chứa "miễn phí".

Tạo Nội Dung Sáng Tạo Quảng Cáo

Bạn: Tôi cần một hình ảnh quảng cáo hiển thị cho sản phẩm tự động hóa tiếp thị. Chủ đề tối, chuyên nghiệp, 1200x628.

Tác nhân: Đang tạo hình ảnh của bạn...

Đã tạo: "Bảng điều khiển tự động hóa tiếp thị với trực quan hóa dữ liệu trên nền tối" Tài sản đã được lưu và sẵn sàng sử dụng trong chiến dịch Hiển thị tiếp theo của bạn.


Kết Nối Tài Khoản Quảng Cáo Của Bạn

Để quản lý quảng cáo trên mỗi nền tảng, bạn sẽ cần kết nối tài khoản của mình trong Synter:

  1. Đi tới syntermedia.ai/settings/credentials
  2. Nhấp "Kết nối" bên cạnh mỗi nền tảng
  3. Hoàn tất luồng OAuth
  4. Tác nhân của bạn giờ có thể quản lý nền tảng đó

Các nền tảng được hỗ trợ (19; ✅ = báo cáo + thực thi chiến dịch đầy đủ, 📊 = báo cáo):

  • Google Ads ✅
  • Meta (Facebook/Instagram) ✅
  • LinkedIn Ads ✅
  • Microsoft Ads (Bing) ✅
  • Reddit Ads ✅
  • TikTok Ads ✅
  • X (Twitter) Ads ✅
  • Snapchat Ads ✅
  • Pinterest Ads ✅
  • Spotify Ads ✅
  • Amazon DSP ✅
  • The Trade Desk ✅
  • Amazon Ads 📊
  • Walmart Connect 📊
  • Instacart Ads 📊
  • Target Roundel 📊
  • Criteo 📊
  • Display & Video 360 📊
  • OpenAI Ads (ChatGPT) 📊

Nâng Cao: Truy Cập Công Cụ Trực Tiếp

Cho người dùng nâng cao, bạn có thể gọi trực tiếp bất kỳ công cụ nào trong số 140+ công cụ Synter:

> Use run_tool to call google_ads_list_audiences

Xem danh sách công cụ đầy đủ tại docs.syntermedia.ai/tools hoặc hỏi tác nhân của bạn:

> What tools are available for LinkedIn Ads?

An Toàn Mặc Định: execute Chạy Thử Trừ Khi Được Yêu Cầu Khác

Công cụ phổ quát execute không bao giờ thực thi hành động trong lần gọi đầu tiên trừ khi bạn chọn tham gia. Theo mặc định (dry_run: true), nó xác thực yêu cầu và dừng lại ở đó — không có gì được thực thi, không có gì tiêu tốn. Truyền dry_run: false để thực sự chạy hành động; đối với bất kỳ thứ gì tiêu tốn tiền, chỉ thực hiện điều đó khi có sự chấp thuận của chủ tài khoản.


Biến Môi trường

BiếnBắt buộcMô tả
SYNTER_API_KEYCóKhóa API Synter của bạn
SYNTER_API_URLKhôngGhi đè URL API (mặc định: https://syntermedia.ai)

Phát triển Cục bộ

# 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

Xử lý Sự cố

"SYNTER_API_KEY not set"

Đảm bảo khóa API của bạn nằm trong phần env của cấu hình MCP. Khóa phải bắt đầu bằng syn_.

"Invalid or expired API key"

  1. Kiểm tra rằng bạn đã sao chép đầy đủ khóa (chúng rất dài!)
  2. Xác minh khóa đang hoạt động tại syntermedia.ai/developer
  3. Đảm bảo khóa có phạm vi tools:write

"No ad accounts connected"

Bạn cần kết nối ít nhất một nền tảng quảng cáo:

  1. Đi tới syntermedia.ai/settings/credentials
  2. Nhấp "Connect" bên cạnh Google Ads (hoặc một nền tảng khác)
  3. Hoàn tất ủy quyền OAuth

Các công cụ không hiển thị trong Claude/Cursor

  1. Khởi động lại hoàn toàn ứng dụng AI của bạn (không chỉ làm mới)
  2. Kiểm tra nhật ký máy chủ MCP để tìm lỗi
  3. Xác minh đường dẫn tệp cấu hình và cú pháp JSON

Câu hỏi thường gặp

Có máy chủ MCP nào cho Google Ads không?

Có, có hai loại. Google phát hành một máy chủ Google Ads MCP chính thức, hiện chỉ ở chế độ chỉ đọc trong bản phát hành hiện tại: nó có thể truy vấn báo cáo, số liệu và siêu dữ liệu, nhưng theo tài liệu của Google, nó "không thể sửa đổi giá thầu, tạm dừng chiến dịch hoặc tạo tài sản mới." Máy chủ MCP của chúng tôi bao phủ Google Ads với cả quyền đọc và ghi: tạo chiến dịch Tìm kiếm, Hiển thị và Performance Max, thêm từ khóa và từ khóa phủ định, điều chỉnh ngân sách, tạm dừng chiến dịch, quản lý đối tượng Customer Match, thiết lập theo dõi chuyển đổi và kéo dữ liệu hiệu suất. Cùng một máy chủ báo cáo trên 18 nền tảng quảng cáo khác và cung cấp khả năng thực thi chiến dịch đầy đủ trên 11 trong số đó.

Claude hoặc ChatGPT có thể quản lý chiến dịch quảng cáo của tôi không?

Có. Với máy chủ Synter MCP được kết nối, Claude (Claude Desktop, Claude Code), ChatGPT, Cursor và bất kỳ ứng dụng tương thích MCP nào khác có thể tạo chiến dịch, điều chỉnh ngân sách, tạm dừng các chiến dịch hoạt động kém, tạo nội dung sáng tạo và đồng bộ đối tượng trên 14 nền tảng quảng cáo (hành động ghi trên 16) và kéo dữ liệu hiệu suất trên tất cả 19. Claude và các ứng dụng stdio khác kết nối qua npx @synterai/mcp-server với SYNTER_API_KEY; ChatGPT và các ứng dụng HTTP khác kết nối với máy chủ từ xa tại https://mcp.syntermedia.ai/mcp/ với tiêu đề X-Synter-Key. Các hành động phá hủy có xác nhận tích hợp sẵn.

Sự khác biệt giữa Google Ads MCP chính thức và Synter là gì?

Hai điểm: quyền ghi và phạm vi nền tảng. Google Ads MCP chính thức chỉ ở chế độ chỉ đọc trong bản phát hành hiện tại và chỉ bao phủ Google Ads. Synter báo cáo trên 19 nền tảng và cung cấp khả năng tạo chiến dịch đầy đủ trên 14 trong số đó, bao gồm Google Ads, Meta, LinkedIn, Microsoft, TikTok, Amazon Ads, Amazon DSP, OpenAI Ads và The Trade Desk. Nếu bạn chỉ cần báo cáo Google Ads, máy chủ chính thức là một lựa chọn tốt. Nếu bạn muốn một tác nhân có thể hành động dựa trên những gì nó tìm thấy, trên Google và mọi nơi khác bạn quảng cáo, đó là lý do chúng tôi xây dựng Synter.


Tài nguyên


Giấy phép

Giấy phép MIT - xem LICENSE để biết chi tiết.


Synter
Bản mở rộng MCP mà họ không muốn bạn dùng.
Vì các tác nhân AI có ngân sách quảng cáo thay đổi mọi thứ.