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

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 hiển thị 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 — Nhờ trợ lý của bạn xây dựng chiến dịch Google Search với từ khóa, ngân sách và trang đích qua create_search_campaign.
Tạm dừng quảng cáo hoạt động kém — Chỉ đạo trợ lý của bạn dừng bất kỳ chiến dịch nào đang chi tiêu quá mức hoặc hoạt động kém hiệu quả bằng pause_campaign.
Điều chỉnh ngân sách hàng ngày — Yêu cầu thay đổi ngân sách ngay lập tức bằng update_campaign_budget để tăng hoặc giảm chi tiêu.
Kéo số liệu hiệu suất — Lấy số lần hiển thị, lượt nhấp, chi tiêu, chuyển đổi và ROAS trên các nền tảng bằng get_performance.
Tạo nội dung quảng cáo — Yêu cầu tạo hình ảnh hoặc video do AI tạo cho chiến dịch của bạn bằng generate_image và generate_video.

Tài liệu

Máy chủ MCP Synter

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ố đó (thao tác ghi trên 16), bao phủ mọi kênh mua quảng cáo chính, kèm xác nhận tích hợp cho các thao tác phá hủy.

Tạo chiến dịch. Điều chỉnh ngân sách. Tạm dừng chiến dịch kém hiệu quả. Tạo sáng tạo quảng cá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à hơn thế nữa.

Đây là máy chủ Model Context Protocol (MCP) đầu tiên trao cho tác nhân AI một tấm thẻ tín dụng.

So sánh Synter với các giải pháp khác

Máy chủ MCP Google Ads chính thức chỉ ở chế độ chỉ đọc theo thiết kế: theo tài liệu của Google, nó "hoàn toàn chỉ đọc" 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 để làm cả hai nửa 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 MCP	MCP Google Ads chính thức	MCP quảng cáo bên thứ ba điển hình
Quyền truy cập	Đọc trên cả 19 nền tảng, tạo chiến dịch trên 14, thao tác ghi trên 16	Chỉ đọ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ảng	19 nền tảng báo cáo, 14 nền tảng tạo chiến dịch đầy đủ (danh sách bên dưới)	Chỉ Google Ads	Thường chỉ một nền tảng
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 sáng tạo bằng AI	✅ Hình ảnh, video, nội dung	❌	❌
Đồng bộ đối tượng	✅ Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X	❌	❌
An toàn	Xác nhận cho các thao tác phá hủy	n/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 thao tác ghi (tạm dừng, cập nhật ngân sách và mục dòng, tải đối tượng lên) 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ỉ hỗ trợ báo cáo.

Gói npx cung cấp các công cụ được định kiể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/ cung cấp toàn bộ bộ công cụ lưu trữ, bao gồm cả kéo dữ liệu 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 dữ liệu chính xác có thể đọc bằng máy. Giữ nó đồng bộ với package.json, manifest.json, và các ví dụ cấu hình 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 bắt đầu tiêu ngân sách của bạn ngay lập tức
Điều chỉnh giá thầu ảnh hưởng đến số tiền bạn trả cho mỗi cú nhấp chuột
Tạm dừng chiến dịch (đôi khi điều đó là tốt)
Thêm từ khóa thay đổi những người thấy quảng cáo của bạn
Tạo 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 cơ chế xác nhận cho các thao tác phá hủy. Nhưng vẫn vậy, có lẽ đừng giao thứ 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:

"Cho tôi xem 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 dùng plugin đầy đủ? (Claude Code / Claude Desktop)

Gói này là máy chủ MCP thô. Nếu bạn dùng Claude Code hoặc Claude Desktop, plugin Synter bao bọc chính 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 cơ chế 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 đi kèm một trình chạy Claude Agent SDK không giao diện 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 vớ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_campaigns`	Liệt kê các chiến dịch trên tất cả nền tảng đã kết nối
`create_search_campaign`	Tạo chiến dịch Google Search với từ khóa và quảng cáo
`create_display_campaign`	Tạo chiến dịch Google Display với hình ảnh
`create_pmax_campaign`	Tạo chiến dịch Performance Max
`create_meta_campaign`	Tạo chiến dịch Facebook/Instagram
`create_linkedin_campaign`	Tạo chiến dịch LinkedIn cho B2B
`create_reddit_campaign`	Tạo chiến dịch Reddit
`pause_campaign`	Tạm dừng bất kỳ chiến dịch nào
`update_campaign_budget`	Thay đổi ngân sách hàng ngày

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

Công cụ	Mô tả
`get_performance`	Lấy số lần hiển thị, lượt nhấp, chi tiêu, chuyển đổi, ROAS
`get_daily_spend`	Phâ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_keywords`	Thêm từ khóa vào chiến dịch hoặc nhóm quảng cáo
`add_negative_keywords`	Chặ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_conversion`	Thiết lập hành động chuyển đổi
`list_conversions`	Liệt kê các hành động chuyển đổi hiện có
`diagnose_tracking`	Kiểm tra xem theo dõi đã được cài đặt đúng chưa

🎨 Tạo sáng tạo quảng cáo

Công cụ	Mô tả
`generate_image`	Tạo hình ảnh quảng cáo bằng AI
`generate_video`	Tạo video quảng cáo bằng AI
`upload_image`	Tải hình ảnh lên làm tài sản quảng cáo

🔧 Tiện ích

Công cụ	Mô tả
`list_ad_accounts`	Liệt kê tất cả tài khoản quảng cáo đã kết nối
`run_tool`	Chạy trực tiếp bất kỳ công cụ nào trong hơn 140 công cụ Synter

Chưa có kinh nghiệm quảng cáo? Không vấn đề.

Nếu bạn chưa từng chạy quảng cáo, đây là những điều bạn cần biết:

Chiến dịch là gì?

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, những người nhìn thấy chúng, và số tiền bạn chi tiêu.

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

Tôi có thể dùng những nền tảng nào?

Nền tảng	Tốt nhất cho	Ngân sách tối thiểu
Google Ads	Người đang chủ động 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
LinkedIn	B2B, doanh nghiệp, người tìm việc	$25/ngày
Reddit	Cộ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
TikTok	Gen Z, giải trí, thương mại điện tử	$20/ngày

Giải thích các loại chiến dị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 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 Display: Quảng cáo hình ảnh hiển thị trên các trang web và ứng dụng.

Ví dụ: Biểu ngữ quảng cáo 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 (Search, YouTube, Display, 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

Thuật ngữ phổ biến

Thuật ngữ	Ý nghĩa
Số lần hiển thị (Impressions)	Số lần quảng cáo của bạn được hiển thị
Lượt nhấp (Clicks)	Số người đã nhấp vào quảng cáo của bạn
CTR	Tỷ lệ nhấp (lượt nhấp ÷ số lần hiển thị × 100)
CPC	Chi phí mỗi lượt nhấp
Chuyển đổi (Conversions)	Các hành động mong muốn (đăng ký, mua hàng, v.v.)
ROAS	Lợ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 cần:

✅ URL trang đích nơi mọi người sẽ đến khi nhấp
✅ Ý tưởng về đối tượng bạn muốn tiếp cận (vị trí, sở thích)
✅ Ngân sách hàng ngày bạn thấy thoải mái ($10-50 để bắt đầu)
✅ 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. Đây 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 những từ khóa đó. Tôi nên 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ịch Chi tiêu Lượt nhấp Chuyển đổi ROAS
Tìm kiếm thương hiệu $142 89 12 4.2x
Từ khóa đối thủ $98 45 3 1.5x
Tiếp thị lại Display $67 234 8 2.8x

Chiến dịch "Từ khóa đối thủ" đang hoạt động kém hiệu quả. 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?

Chiến dịch	Chi tiêu	Lượt nhấp	Chuyển đổi	ROAS
Tìm kiếm thương hiệu	$142	89	12	4.2x
Từ khóa đối thủ	$98	45	3	1.5x
Tiếp thị lại Display	$67	234	8	2.8x

Thêm từ khóa phủ định

Bạn: Tôi đang nhận được lượt nhấp cho "quản lý dự án miễn phí" nhưng chúng tôi không có gói miễn phí. Hãy chặn những tìm kiếm đó.

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 sáng tạo quảng cáo

Bạn: Tôi cần một hình ảnh quảng cáo display 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 Display 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 cần kết nối tài khoản của mình trong Synter:

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

Nền tảng được hỗ trợ (19; ✅ = báo cáo + thực thi chiến dịch đầy đủ, 📊 = chỉ 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

Dành 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 hơn 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: Chạy thử `execute` Trừ khi được chỉ định khác

Công cụ execute phổ quát không bao giờ thực thi một 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 ở đó — không có gì được thực thi, không có gì được chi tiêu. Truyền dry_run: false để thực sự chạy hành động; đối với bất cứ điều gì tiêu tiền, chỉ làm điều đó khi có sự phê duyệt của chủ tài khoản.

Biến môi trường

Biến	Bắt buộc	Mô tả
`SYNTER_API_KEY`	Có	Chìa khóa API Synter của bạn
`SYNTER_API_URL`	Không	Ghi đè 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

Khắc phục sự cố

"SYNTER_API_KEY not set"

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

"Invalid or expired API key"

Kiểm tra rằng bạn đã sao chép đầy đủ chìa khóa (chúng rất dài!)
Xác minh chìa khóa đang hoạt động tại syntermedia.ai/developer
Đảm bảo chìa 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:

Đi tới syntermedia.ai/settings/credentials
Nhấp "Connect" bên cạnh Google Ads (hoặc nền tảng khác)
Hoàn tất xác thực OAuth

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

Khởi động lại hoàn toàn ứng dụng AI của bạn (không chỉ làm mới)
Kiểm tra nhật ký máy chủ MCP để tìm lỗi
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 cho Google Ads không?

Có, hai loại. Google phát hành 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, chỉ số 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 gồm Google Ads với cả đọ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 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 chiến dịch kém hiệu quả, tạo nội dung quảng cá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ều: 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 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à lựa chọn vững chắc. 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

Hướng dẫn Synter: syntermedia.ai/manual
Tài liệu API: docs.syntermedia.ai
Plugin Claude: github.com/Synter-Media-AI/plugin (kỹ năng, tác nhân & MCP này cho Claude Code / Desktop)
Tham chiếu công cụ: docs.syntermedia.ai/tools
So sánh máy chủ MCP: syntermedia.ai/blog/best-ad-platform-mcp-servers
Kỹ năng tác nhân miễn phí (47 mã nguồn mở): github.com/Synter-Media-AI/free-skills (cũng trên skills.sh)
Hỗ trợ: hello@syntermedia.ai

Giấy phép

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

Tiện ích mở rộng MCP mà họ không muốn bạn sử dụng.
Vì các tác nhân AI với ngân sách quảng cáo thay đổi mọi thứ.