Synter Ads MCP Server

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

Tài liệu

Synter Ads MCP Server

Tiện ích mở rộng MCP mà Claude không muốn bạn dùng.

Bởi vì một khi bạn cài đặt nó, tác nhân AI của bạn có thể tiêu tiền thật.

Tạo chiến dịch. Điều chỉnh ngân sách. Tạm dừng những chiến dịch kém hiệu quả. Tạo nội dung quảng cáo. Lấy 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, và nhiều nền tảng khác.

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

Tại sao chọn Synter?

Hầu hết các máy chủ MCP quảng cáo đều chỉ đọc và đơn nền tảng. Synter là máy chủ MCP quản lý quảng cáo đa nền tảng duy nhất có đầy đủ khả năng đọc + ghi:

Tính năng	Synter	Google Ads MCP	Amazon Ads MCP	Khác
Nền tảng	9+ (Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X, StackAdapt, TTD)	Chỉ Google	Chỉ Amazon	1-2
Tạo chiến dịch	✅	❌ Chỉ đọc	✅ Chỉ Amazon	❌
Điều chỉnh ngân sách	✅	❌	✅	❌
Tạm dừng chiến dịch	✅	❌	✅	❌
Tạo nội dung quảng cáo bằng AI	✅ (Imagen 4, Veo, Flux)	❌	❌	❌
Tối ưu giá thầu	✅	❌	❌	❌
Nhà chiến lược AI	✅	❌	❌	❌
Mã nguồn mở	✅	✅	❌	Tùy loại

Một máy chủ MCP. Mọi nền tảng quảng cáo. Đọc và ghi.

⚠️ 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 chi 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 đối tượng thấy quảng cáo của bạn
Tạo nội dung quảng cáo và tải lên tài khoản của bạn

Chúng tôi đã tích hợp xác nhận cho các hành động phá hủy. Nhưng dù sao—có lẽ đừng đưa cái này cho một tác nhân bạn vừa 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 (HTTP có thể truyền phát) — Cho ChatGPT, n8n, Zapier, hoặc bất kỳ ứng dụng MCP nào hỗ trợ truyền tải 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ợ truyền tải HTTP có thể truyền phát.

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ị cho tôi tất cả cá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"

Thích một plugin đầy đủ hơn? (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 dựng 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 đ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 Plugin Claude. 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_campaigns`	Liệ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_campaign`	Tạo chiến dịch Tìm kiếm Google với từ khóa và quảng cáo
`create_display_campaign`	Tạo chiến dịch Hiển thị Google 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ị, 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 một 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 Nội dung Quảng cáo

Công cụ	Mô tả
`generate_image`	Tạo hình ảnh quảng cáo bằng AI (Imagen 4, Flux, SDXL)
`generate_video`	Tạo quảng cáo video bằng AI (Veo, Runway, Luma)
`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ả cá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 số hơn 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 từng 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ì?

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, đối tượng 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ể Sử dụng Những Nền tảng Nào?

Nền tảng	Phù hợp Nhất	Ngân sách Tối thiểu
Google Ads	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
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ân khẩu học 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 đó Google các từ khóa cụ thể.

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 biểu ngữ 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 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ị	Số lần quảng cáo của bạn được hiển thị
Số nhấp	Số người đã nhấp vào quảng cáo của bạn
CTR	Tỷ lệ nhấp (số nhấp ÷ số lần hiển thị × 100)
CPC	Chi phí mỗi lần nhấp
Chuyển đổi	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 sẽ cần:

✅ Một URL trang đích nơi mọi người sẽ đến khi họ 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 cảm 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 Tìm kiếm Google cho sản phẩm SaaS của tôi. Nhắm mục tiêu 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 đó. Tôi nên sử dụ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 tuần này thế nào?

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 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 Hiển thị $67 234 8 2.8x

Chiến dịch "Từ khóa Đối thủ" đang 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	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 Hiển thị	$67	234	8	2.8x

Thêm Từ khóa Phủ định

Bạn: Tôi đang nhận được 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í. 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 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 với Imagen 4...

Đã 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:

Đi tới syntermedia.ai/settings/credentials
Nhấp "Kết nối" bên cạnh mỗi nền tảng
Hoàn thành quy trình OAuth
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ợ:

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

Nâng cao: Truy cập Công cụ Trực tiếp

Dành cho người dùng thành thạo, bạn có thể gọi trực tiếp bất kỳ công cụ nào trong số 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?

Biến Môi trường

Biến	Bắt buộc	Mô tả
`SYNTER_API_KEY`	Có	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 chưa được đặt"

Đả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 nên bắt đầu bằng syn_.

"Khóa API không hợp lệ hoặc đã hết hạn"

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

"Không có tài khoản quảng cáo nào được kết nối"

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 "Kết nối" bên cạnh Google Ads (hoặc nền tảng khác)
Hoàn thành ủy quyền 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

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 khảo 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 có trên skills.sh
Hỗ trợ: [email protected]

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 dùng.
Bởi vì tác nhân AI với ngân sách quảng cáo thay đổi mọi thứ.