Ads MCP
Connects to Google Ads to manage advertising campaigns, including YouTube ads.
Allows declaring Google Drive / Google Sheet folders so AI can retrieve images and videos for ad creation.
Connects to Meta advertising accounts to manage Meta ad campaigns.
Connects to OpenAI Ads for advertising campaign management.
Integrates a Telegram bot for connection alerts, notifications of AI-made changes, and AI messages in group chats.
Connects to TikTok Ads, including GMV Max for TikTok Shop, to manage TikTok advertising campaigns.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Phần mềm có bản quyền, không phải mã nguồn mở. Chỉ đơn vị đượcNextgency cấp quyền bằng văn bản mới được cài đặt và sử dụng. Xem LICENSE.
Hướng dẫn này viết cho người không chuyên kỹ thuật: làm lần lượt từng bước, mỗi lệnh chỉ cần sao chép và dán. Toàn bộ mất khoảng 30-45 phút.
Sau khi cài, đội của bạn dán token để kết nối Meta, TikTok Ads (gồm GMV Max của TikTok Shop), Google Ads (gồm quảng cáo YouTube) và OpenAI Ads, rồi tạo link MCP cho Claude, ChatGPT, Gemini. Có thể thêm bot Telegram để nhận cảnh báo kết nối, thông báo thay đổi do AI thực hiện và tin nhắn từ AI ngay trong nhóm chat, khai báo thư mục Google Drive / Google Sheet để AI lấy ảnh, video lên quảng cáo (xem docs/huong-dan-google-drive.md), và dán token Apify để AI lấy dữ liệu sàn TMĐT, mạng xã hội, Google (giá, đánh giá sản phẩm, quảng cáo của đối thủ…) rồi phân tích (xem docs/huong-dan-apify.md). Hướng dẫn dùng: kết nối AI · Telegram · Google Drive / Google Sheet · Apify.
Cài nhanh bằng 1 lệnh (khuyến nghị cho VPS Ubuntu 22.04/24.04, Debian 12/13 mới): chép file install-ads-mcp.sh Nextgency gửi (hoặc scripts/install-ads-mcp.sh trong repo) lên VPS rồi chạy sudo bash install-ads-mcp.sh. Chỉ cần chuẩn bị tên miền, tài khoản GitHub đã được cấp quyền và 1 token (PAT classic tích cả repo + read:packages); script hỏi lần lượt, tự cài Docker, tải phần mềm, tạo cấu hình, khởi chạy và in mã cài đặt để tạo admin. Chi tiết: docs/deploy-vps.md mục 0. Các bước dưới đây là cách cài tay.
Bạn kết nối tài khoản GitHub chứa repo này với ChatGPT, Claude hoặc Gemini → cho AI đọc repo và hướng dẫn bạn deploy chi tiết nhé. Bạn cung cấp chi tiết cho AI biết là sẽ deploy trên đâu (VPS hay mini PC chạy Ubuntu Server), dùng bằng cách trỏ IP về VPS hay là Cloudflare Tunnel, trỏ IP về VPS thì có dùng Cloudflare và bật DNS only hay không. Bạn cung cấp đầy đủ ngữ cảnh để AI hướng dẫn chi tiết, gặp phần nào khó thì chụp ảnh màn hình xong gửi vào AI để nó hướng dẫn tiếp nhé.
Mục lục
Related MCP server: Ads MCP
Bước 0. Chuẩn bị
Bạn cần có:
Thứ cần có | Ghi chú |
1 VPS | Ubuntu 24.04 (khuyến nghị) hoặc Debian 12. Tối thiểu 1 vCPU, 2 GB RAM, 20 GB ổ cứng. Nhà cung cấp gửi cho bạn: địa chỉ IP, tên đăng nhập, mật khẩu. |
1 tên miền | Ví dụ |
1 tài khoản GitHub đã được Nextgency cấp quyền | Gửi tên tài khoản GitHub cho Nextgency để được thêm quyền đọc. Nên dùng tài khoản riêng cho việc này (không dùng tài khoản cá nhân chứa dự án khác). |
Máy tính | Windows 10/11 hoặc macOS, có trình duyệt. |
Trong hướng dẫn, thay các giá trị mẫu bằng thông tin của bạn:
Giá trị mẫu | Thay bằng |
| Tên miền con bạn dùng cho phần mềm |
| Email của bạn |
| Tên tài khoản GitHub đã được cấp quyền |
| Địa chỉ IP của VPS |
Bước 1. Chuẩn bị quyền GitHub
Cài bằng script (xem đầu trang) chỉ cần1 token tích cả repo và read:packages. Cài tay theo các bước dưới đây có thể dùng 2 token như mô tả, hoặc cùng 1 token đó cho cả 2 chỗ.
Nextgency thêm tài khoản GitHub của bạn vào kho phần mềm với quyền chỉ đọc (Read). Bạn tạo 2 token (2 "mật khẩu riêng") từ tài khoản đó, mỗi token chỉ làm đúng 1 việc:
Token | Dùng để | Tích đúng 1 ô |
Token A | Tải image Docker (phần mềm đã đóng gói) |
|
Token B | Tải mã nguồn ( |
|
GitHub bắt buộc tíchrepo cho Token B (kho được chia sẻ cho tài khoản ngoài tổ chức chỉ dùng được loại token này). Quyền repo cho phép đọc và ghi mọi kho (repo) của chính tài khoản GitHub đó. Nếu tài khoản của bạn có kho quan trọng, nên tạo một tài khoản GitHub riêng cho máy chủ (ví dụ congty-ads-server) rồi gửi tên tài khoản này cho Nextgency để được thêm quyền (không bắt buộc). Với kho của Nextgency, tài khoản chỉ có quyền Read nên token không sửa được phần mềm.
1.1 Tạo Token A (tải image)
Đăng nhập GitHub bằng tài khoản đã được Nextgency cấp quyền.
Mở https://github.com/settings/tokens/new (Personal access tokens → Tokens (classic)).
Note: gõ
ads-mcp-vps-image.Expiration: chọn 1 năm (hoặc Custom ngày cụ thể). Ghi lịch nhắc gia hạn trước khi hết hạn 2 tuần.
Chỉ tích ☑ read:packages. Không tích ô nào khác.
Kéo xuống cuối, bấm Generate token.
Sao chép token ngay (bắt đầu bằng
ghp_...), lưu vào trình quản lý mật khẩu với ghi chú "Token A". GitHub chỉ hiện token một lần.
1.2 Tạo Token B (mã nguồn + kiểm tra bản mới)
Làm lại đúng như 1.1, chỉ khác:
Note: gõ
ads-mcp-vps-repo.Chỉ tích ☑ repo (các ô con bên dưới tự được tích theo). Không tích
read:packageshay ô nào khác.Lưu với ghi chú "Token B".
Không gửi token cho người khác, không dán vào chat/email. Token hết hạn thì phần mềm vẫn chạy bình thường, chỉ không tải hoặc kiểm tra được bản mới: tạo token mới rồi làm lại bước 4.2 (Token A) hoặc 6.2 (Token B).
Đã cài theo hướng dẫn cũ (có chạy lệnh git config --global credential.helper store, token nằm dạng chữ thường trên VPS)? Làm lần lượt trên VPS bằng user deploy:
Tạo Token A và Token B mới (bước 1.1, 1.2).
Xoá token cũ đang lưu trên VPS:
rm -f ~/.git-credentials && git config --global --unset credential.helper. Từ giờgit pullsẽ hỏiUsername(tên GitHub) vàPassword(dán Token B).Đăng nhập lại kho image bằng Token A: chạy
docker logout ghcr.io, rồi làm bước 4.2.cd /opt/ads-mcp && nano .env, thay giá trị dòngUPDATE_GITHUB_TOKEN=bằng Token B, lưu lại, rồi chạydocker compose up -d --no-build.Vào https://github.com/settings/tokens, bấm Delete ở token cũ.
Trong web, vào Cài đặt → Cập nhật, bấm Kiểm tra ngay: phải thấy phiên bản mới nhất, không báo lỗi.
Bước 2. Kết nối vào VPS
Mọi lệnh từ bước 3 trở đi được gõ trên VPS qua cửa sổ dòng lệnh.
Windows: bấm phím Windows, gõ PowerShell, mở Windows PowerShell.
macOS: mở ứng dụng Terminal.
Gõ lệnh sau (thay IP_VPS bằng IP của bạn), bấm Enter:
ssh root@IP_VPSLần đầu sẽ hỏi
Are you sure you want to continue connecting?→ gõyes, Enter.Nhập mật khẩu VPS (khi gõ không hiện ký tự, cứ gõ rồi Enter).
Thấy dòng dạng
root@ten-may:~#là đã vào được VPS.
Nếu bạn đăng nhập bằng user thường (nhà cung cấp cho user
ubuntu, hoặc bạn ngồi trực tiếp trên mini PC, dòng nhắc dạngten-user@ten-may:~$): gõsudo -i, nhập mật khẩu của user đó. Dòng nhắc đổi thànhroot@ten-may:~#thì mới làm tiếp bước 3. Nếu không, các lệnh sẽ báoPermission denied.
Cách dán lệnh: trong PowerShell/Terminal, bấm chuột phải (Windows) hoặc Cmd+V (macOS). Nên dán từng khối lệnh trong hướng dẫn, đợi chạy xong mới dán khối tiếp theo.
Bước 3. Cài đặt máy chủ
3.1 Cập nhật hệ thống và tạo user riêng
Không nên chạy phần mềm bằng root. Tạo user tên deploy (dán cả khối):
apt update && apt -y upgrade
timedatectl set-timezone Asia/Ho_Chi_Minh
adduser --gecos "" deploy
usermod -aG sudo deployLệnh adduser sẽ hỏi mật khẩu cho user deploy 2 lần, hãy đặt mật khẩu mạnh và ghi lại.
3.2 Cài Docker
Cài từ kho chính thức của Docker (dán cả khối):
. /etc/os-release
case "$ID" in ubuntu|debian) ;; *) echo "Chỉ hỗ trợ Ubuntu/Debian"; false ;; esac
apt -y install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL "https://download.docker.com/linux/$ID/gpg" -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
tee /etc/apt/sources.list.d/docker.sources >/dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/$ID
Suites: ${UBUNTU_CODENAME:-$VERSION_CODENAME}
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
apt update
apt -y install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
usermod -aG docker deployĐợi 1-3 phút đến khi chạy xong.
Máy đã có Docker từ trước: kiểm tra bằng
docker --version(bản 28 trở lên) vàdocker compose version(v2trở lên). Đủ thì bỏ qua khối trên, chỉ chạyusermod -aG docker deploy.Nhóm
dockercó quyền tương đương root trên máy chủ: chỉ thêm user quản trị tin cậy.
3.3 Tạo bộ nhớ swap (cho VPS ít RAM)
fallocate -l 2G /swapfile && chmod 600 /swapfile && mkswap /swapfile && swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab3.4 Bật tường lửa
Nếu bạn sẽ dùng Cách A ở bước 5 (đơn giản nhất):
apt -y install ufw git ufw allow OpenSSH && ufw allow 80/tcp && ufw allow 443/tcp && ufw allow 443/udp ufw --force enableNếu bạn sẽ dùng Cách B - Cloudflare Tunnel:
apt -y install ufw git ufw allow OpenSSH ufw --force enable
3.5 Chuyển sang user deploy
Thoát khỏi root:
exitSau đó đăng nhập bằng user deploy, chọn đúng trường hợp:
Kết nối từ máy tính qua SSH: gõ đủ cả
@và IP (không gõ mỗissh deploy):ssh deploy@IP_VPSNgồi trực tiếp trên mini PC / đã dùng
sudo -iở bước 2:su - deploy
Nhập mật khẩu của deploy đặt ở bước 3.1. Dòng nhắc phải là deploy@ten-may:~$.
Kiểm tra quyền dùng Docker:
docker psRa một bảng (kể cả bảng trống chỉ có dòng tiêu đề
CONTAINER ID ...) là đúng.Nếu báo
permission denied ... docker.sock: chạysudo usermod -aG docker deploy, rồiexitvà đăng nhập lại như trên (quyền mới chỉ có hiệu lực sau khi đăng nhập lại).
Nếu dòng nhắc đã là
deploy@...thì không cầnexit, chỉ cần kiểm tradocker psnhư trên.
3.6 Đăng nhập bằng khoá SSH, tắt đăng nhập bằng mật khẩu
Mật khẩu SSH dễ bị dò. Bước này cho máy tính của bạn đăng nhập VPS bằng khoá SSH, rồi tắt hẳn đăng nhập bằng mật khẩu và đăng nhập root.
Ngồi trực tiếp trên mini PC và không bao giờ SSH từ máy khác: có thể bỏ qua bước này.
Trên máy tính của bạn (mở cửa sổ PowerShell/Terminal mới, không gõ trong cửa sổ đang kết nối VPS):
Windows (PowerShell):
ssh-keygen -t ed25519Bấm Enter 3 lần (giữ mặc định). Sau đó chép khoá lên VPS (thay
IP_VPS, nhập mật khẩu củadeploykhi được hỏi):type $env:USERPROFILE\.ssh\id_ed25519.pub | ssh deploy@IP_VPS "mkdir -p ~/.ssh && chmod 700 ~/.ssh && cat >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys"macOS (Terminal):
ssh-keygen -t ed25519 ssh-copy-id deploy@IP_VPS
Kiểm tra: mở thêm một cửa sổ mới, gõ ssh deploy@IP_VPS. Phải vào được VPS mà không hỏi mật khẩu VPS. Giữ nguyên cửa sổ cũ đang kết nối, phòng khi có lỗi.
Trên VPS (trong cửa sổ vừa vào được bằng khoá; sudo hỏi mật khẩu của deploy):
sudo tee /etc/ssh/sshd_config.d/00-ads-mcp-hardening.conf >/dev/null <<'EOF'
PasswordAuthentication no
KbdInteractiveAuthentication no
PermitRootLogin no
EOF
sudo sshd -t && sudo systemctl reload ssh
sudo sshd -T | grep -Ei '^(passwordauthentication|permitrootlogin)'Dòng cuối phải in ra passwordauthentication no và permitrootlogin no. Từ giờ chỉ đăng nhập bằng ssh deploy@IP_VPS từ máy tính đã có khoá.
Mất khoá (đổi máy tính, cài lại Windows) làkhông SSH vào VPS được nữa. Khi đó dùng console web trong trang quản lý của nhà cung cấp VPS (mini PC: bàn phím và màn hình gắn trực tiếp) để đăng nhập deploy và thêm khoá mới. Nên sao lưu thư mục .ssh của máy tính ở nơi an toàn. Tuỳ chọn chống dò mật khẩu thêm: fail2ban (docs/deploy-vps.md mục 3.6).
Bước 4. Tải phần mềm về VPS
4.1 Tải mã nguồn
sudo mkdir -p /opt/ads-mcp && sudo chown deploy: /opt/ads-mcp
git clone https://github.com/schhung1822/nextgency-mcp-ads.git /opt/ads-mcpCó thể được hỏi mật khẩu của
deploy(do lệnhsudo): nhập mật khẩu đã đặt ở bước 3.1.Username: nhậpTEN_GITHUB= tên đăng nhập (username) GitHub của tài khoản đã tạo token ở bước 1. Xem username: đăng nhập GitHub → bấm avatar góc trên bên phải → dòng in đậm. Không nhập email.Password: dán Token B ở bước 1.2 (không hiện ký tự), Enter. Không nhập mật khẩu GitHub, GitHub chỉ nhận token.
Token không được lưu trên VPS: mỗi lần git pull (khi cập nhật) sẽ hỏi lại Username và Password (Token B). Không chạy git config credential.helper store (lệnh đó lưu token thành chữ thường trên ổ đĩa).
Tuỳ chọn, đỡ phải dán lại nhiều lần trong 1 buổi làm việc:
git config --global credential.helper 'cache --timeout=900'(chỉ nhớ token trong RAM 15 phút).
4.2 Đăng nhập kho image
Dán nguyên khối lệnh dưới đây (thay TEN_GITHUB); khi thấy dòng Dán Token A rồi Enter: thì dán Token A ở bước 1.1 (không hiện ký tự) rồi Enter:
cd /opt/ads-mcp
read -rsp "Dán Token A rồi Enter: " CR_PAT; echo
printf '%s' "$CR_PAT" | docker login ghcr.io -u TEN_GITHUB --password-stdin; unset CR_PATThấy Login Succeeded là đúng (cảnh báo credentials are stored unencrypted là bình thường trên máy chủ Linux).
Bước 5. Chọn cách đưa web ra Internet
Tuyệt đối không dùng sub domain là ads.example.com vì sub domain ads dễ bị trình duyệt chặn gây setup lỗi. Trình chặn quảng cáo / phần mềm diệt virus chặn các địa chỉ bắt đầu bằng ads.: trang hiện ra nhưng mất giao diện, F12 báo ERR_ABORTED. Dùng sub domain đề xuất là mcp (ví dụ mcp.congty.vn).
Chọn một trong hai cách:
Cách A - Caddy tự cấp SSL | Cách B - Cloudflare Tunnel | |
Phù hợp | Đơn giản nhất, dùng được với mọi nhà cung cấp tên miền | Tên miền đã dùng Cloudflare; không muốn mở cổng nào trên VPS |
Cần mở cổng | 80, 443 | Không |
SSL | Tự động (Let's Encrypt) | Cloudflare lo |
Cách nâng cao (Cloudflare proxy + chứng chỉ Origin, Nginx + Certbot): xem docs/deploy-vps.md.
Cách A - Caddy tự cấp SSL
Vào trang quản lý DNS của tên miền (nơi bạn mua tên miền, hoặc Cloudflare), thêm 1 bản ghi:
Loại (Type) | Tên (Name/Host) | Giá trị (Value/IP) |
|
|
|
Nếu dùng Cloudflare: để Proxy status = DNS only (đám mây xám).
Đợi 5-15 phút để DNS cập nhật. Kiểm tra trên VPS:
getent hosts mcp.congty.vnphải ra đúngIP_VPS.
Sau đó làm tiếp bước 6, dùng --ssl auto.
Cách B - Cloudflare Tunnel
Tên miền phải đang quản lý trên Cloudflare.
Đăng nhập https://one.dash.cloudflare.com → chọn tài khoản.
Menu trái: Networks → Tunnels → Create a tunnel → chọn Cloudflared → Next.
Tunnel name: gõ
ads-mcp→ Save tunnel.Màn hình Install and run a connector: chọn biểu tượng Docker. Bạn sẽ thấy một lệnh dạng:
docker run cloudflare/cloudflared:latest tunnel --no-autoupdate run --token eyJhIjoi...→ Chỉ sao chép phần token (chuỗi dài bắt đầu bằngeyJsau chữ--token), lưu tạm lại. Không chạy lệnhdocker runnày. → bấm Next.Màn hình Route traffic / Public hostname:
Subdomain:
mcpDomain: chọn
congty.vnService Type:
HTTPURL:
caddy:80Không mở Additional application settings.
Bấm Save / Complete setup.
Nếu Cloudflare báo đã có bản ghi DNS
mcpthì vào DNS xoá bản ghi cũ đó rồi lưu lại.Cấu hình thêm cho tên miền (trang quản lý tên miền trên https://dash.cloudflare.com):
SSL/TLS → Edge Certificates: bật Always Use HTTPS.
Security → Bots: tắt Bot Fight Mode (nếu bật, AI không gọi được MCP).
Caching → Cache Rules → Create rule: Field
URI Path, Operatorstarts with, Value/mcp/→ Or →URI Pathstarts with/api/→ Cache eligibility: Bypass cache → Deploy.
Sau đó làm tiếp bước 6, dùng --ssl tunnel.
Bước 6. Tạo file cấu hình
6.1 Tạo file .env
File .env chứa mật khẩu cơ sở dữ liệu và khoá mã hoá, được tạo tự động với giá trị ngẫu nhiên.
Cách A:
cd /opt/ads-mcp
sh scripts/gen-secrets.sh --domain mcp.congty.vn --email it@congty.vn --ssl autoCách B (Cloudflare Tunnel):
cd /opt/ads-mcp
sh scripts/gen-secrets.sh --domain mcp.congty.vn --email it@congty.vn --ssl tunnelLần đầu chạy có thể mất 1-2 phút (tải công cụ tạo khoá). Chạy xong sẽ có file /opt/ads-mcp/.env.
6.2 Thêm token GitHub vào cấu hình
Để phần mềm tự kiểm tra và tải bản cập nhật. Dán nguyên khối lệnh dưới đây; khi thấy dòng Dán Token B rồi Enter: thì dán Token B ở bước 1.2 (không hiện ký tự) rồi Enter:
read -rsp "Dán Token B rồi Enter: " GH_TOKEN; echo
echo "UPDATE_GITHUB_TOKEN=$GH_TOKEN" >> .env; unset GH_TOKEN
echo "UPDATER_DOCKER_CONFIG=$HOME/.docker" >> .env
grep -cE "^UPDATE_GITHUB_TOKEN=(ghp_|github_pat_)" .envDòng cuối in ra 1 là đúng. In ra 0 nghĩa là chưa dán đúng token: mở nano .env, sửa dòng UPDATE_GITHUB_TOKEN= ở cuối file.
6.3 (Chỉ Cách B) Dán token Cloudflare Tunnel
nano .envTrong trình soạn thảo nano:
Dùng phím mũi tên tìm dòng
TUNNEL_TOKEN=.Đưa con trỏ ra sau dấu
=và dán tokeneyJ...đã lưu ở Cách B (chuột phải hoặc Cmd+V).Lưu: bấm Ctrl+O, rồi Enter. Thoát: bấm Ctrl+X.
6.4 Khoá quyền đọc file
chmod 600 .envBước 7. Khởi chạy
cd /opt/ads-mcp
docker compose pull
docker compose up -d --no-buildpulltải phần mềm về (vài phút lần đầu).up -dchạy phần mềm ở chế độ nền.
Đợi khoảng 1 phút rồi kiểm tra:
docker compose ps -aKết quả đúng:
Dịch vụ | Trạng thái đúng |
|
|
|
|
|
|
|
|
|
|
Mở trình duyệt trên máy tính: https://mcp.congty.vn/api/health → thấy {"ok":true} là phần mềm đã chạy.
Cách A: lần đầu Caddy cần 30-60 giây để xin chứng chỉ SSL. Nếu trình duyệt báo lỗi chứng chỉ, đợi 1 phút rồi tải lại.
Bước 8. Tạo tài khoản Admin
Lấy mã cài đặt:
grep SETUP_TOKEN .envSao chép phần sau dấu =.
Mở
https://mcp.congty.vn/setup.Dán mã cài đặt, nhập tên, email, mật khẩu (tối thiểu 8 ký tự) → tạo tài khoản.
Đăng nhập bằng email và mật khẩu vừa tạo.
Khuyến nghị: vào Tài khoản → bật xác thực 2 lớp (2FA), rồi vào Cài đặt → Bảo mật → bật Bắt buộc 2FA cho quản trị viên.
Trang /setup tự khoá sau khi đã có tài khoản Admin.
Bước 9. Sao lưu file cấu hình
Bước bắt buộc. File .env chứa khoá mã hoá (ENCRYPTION_KEYS). Mất file này là mất toàn bộ token quảng cáo đã lưu và không khôi phục được.
Hiện nội dung file:
cat .envBôi đen toàn bộ nội dung, sao chép, lưu vào trình quản lý mật khẩu (Bitwarden, 1Password...) hoặc ghi chú bảo mật. Không gửi qua chat/email, không để chung chỗ với file sao lưu dữ liệu.
Xong! Phần mềm đã chạy tại https://mcp.congty.vn.
Liên kết chính sách cho ứng dụng nền tảng quảng cáo
Ứng dụng nhà phát triển (Meta App Dashboard → App settings → Basic / Cài đặt ứng dụng → Thông tin cơ bản: URL chính sách quyền riêng tư, URL điều khoản dịch vụ, Xoá dữ liệu người dùng → URL hướng dẫn xoá dữ liệu; TikTok for Developers → thông tin app: Terms of Service URL, Privacy Policy URL; Google Cloud → màn hình đồng ý OAuth (Branding) cho Google Ads/YouTube: liên kết chính sách quyền riêng tư và điều khoản; OpenAI tương tự) cần các trang công khai. Mỗi bản cài đặt đã có sẵn 3 trang, không cần đăng nhập, tiếng Việt + bản tiếng Anh:
Trang | Địa chỉ |
Chính sách quyền riêng tư |
|
Điều khoản dịch vụ |
|
Hướng dẫn xoá dữ liệu |
|
Đăng nhập bằng Admin → Cài đặt → Thông tin pháp lý: nhập Tên đơn vị vận hành (công ty của bạn - bên chịu trách nhiệm về dữ liệu) và Email liên hệ quyền riêng tư → Lưu. Để trống thì trang dùng tên miền và ghi "quản trị viên hệ thống".
Lấy liên kết: thanh bên trái, dưới tên tài khoản, khối Liên kết cho ứng dụng - bấm tên trang để mở, bấm biểu tượng sao chép để lấy địa chỉ đầy đủ (điện thoại: tab Menu).
Dán các địa chỉ vào ứng dụng Meta, TikTok, Google Cloud (màn hình đồng ý OAuth) hoặc OpenAI.
Cập nhật phiên bản mới
Cách 1 - Trong web (khuyến nghị): khi có bản mới, Admin thấy thông báo ở menu tài khoản. Vào Cài đặt → Cập nhật → bấm Cập nhật lên vX.Y.Z → nhập lại mật khẩu. Hệ thống tự sao lưu dữ liệu, tải bản mới, kiểm tra chữ ký số của Nextgency (bản không có chữ ký bị từ chối), khởi động lại (web gián đoạn khoảng 1-2 phút) và tự quay về bản cũ nếu lỗi.
Ghi chú phát hành yêu cầu lấy cấu hình mới (
git pull)? Chạy trước khi bấm Cập nhật (git hỏiUsernamevàPassword= Token B):cd /opt/ads-mcp && git pull --ff-only && docker compose up -d --no-build
Cách 2 - Chạy lệnh (dùng khi ghi chú phát hành yêu cầu, hoặc nút Cập nhật không dùng được). Thay X.Y.Z bằng số phiên bản mới (không có chữ v):
cd /opt/ads-mcp
docker compose exec -T db pg_dump -U adsmcp -d adsmcp -Fc > backups/truoc-cap-nhat-$(date +%F).dump
git pull --ff-only
sed -i 's/^APP_VERSION=.*/APP_VERSION=X.Y.Z/' .env
docker compose pull
docker compose up -d --no-buildSao lưu và khôi phục dữ liệu
Phần mềm tự sao lưu cơ sở dữ liệu mỗi ngày vào thư mục /opt/ads-mcp/backups, giữ 14 ngày. Nên định kỳ tải thư mục này về máy hoặc đồng bộ lên dịch vụ lưu trữ khác.
File sao lưu chứa email người dùng, mật khẩu đã băm và token quảng cáo đã mã hoá: giữ bí mật như file
.env, mã hoá trước khi đưa lên dịch vụ lưu trữ (ví dụ rclonecrypt, restic - xem docs/van-hanh.md) và không để chung chỗ với bản sao.env.
Xem danh sách bản sao lưu:
ls -lh /opt/ads-mcp/backupsSao lưu ngay:
cd /opt/ads-mcp
docker compose exec backup sh -c 'pg_dump -Fc -f /backups/adsmcp_manual_$(date +%F_%H%M%S).dump'Khôi phục từ một bản sao lưu (ghi đè dữ liệu hiện tại; thay TEN_FILE.dump bằng tên file trong thư mục backups):
cd /opt/ads-mcp
docker compose stop web worker updater
docker compose exec backup pg_restore --clean --if-exists -d adsmcp /backups/TEN_FILE.dump
docker compose up -d --no-buildChuyển sang VPS mới: làm lại bước 2 → 5, chép file .env cũ vào /opt/ads-mcp/.env (không chạy lại bước 6.1), chép file sao lưu vào /opt/ads-mcp/backups/, chạy docker compose up -d --no-build db backup, rồi chạy lệnh khôi phục ở trên.
Các lệnh hay dùng
Luôn cd /opt/ads-mcp trước khi chạy:
Việc | Lệnh |
Xem trạng thái |
|
Xem log web |
|
Xem log tất cả (theo dõi liên tục, Ctrl+C để thoát) |
|
Khởi động lại |
|
Dừng phần mềm |
|
Chạy lại |
|
Admin quên mật khẩu |
|
Admin mất 2FA |
|
Lỗi thường gặp
Hiện tượng | Cách xử lý |
| Sai |
| Đăng nhập lại kho image bằng Token A còn hạn (chỉ tích read:packages): làm lại bước 4.2. |
Mọi lệnh |
|
|
|
Bước 3 báo | Đang ở user thường: gõ |
| Gõ thiếu IP: dùng |
Trang web hiện ra nhưng mất giao diện (chữ trắng đen, không màu), F12 báo | Sub domain bắt đầu bằng |
| Xem lỗi: |
Cách A: trình duyệt báo lỗi chứng chỉ / không vào được | Kiểm tra bản ghi A đúng |
Cách B: Cloudflare báo lỗi 1033 | Tunnel chưa kết nối: kiểm tra |
Cách B: lỗi 502 | Public hostname phải là |
Cách B: lỗi chuyển hướng quá nhiều lần | File |
Trang Cập nhật báo "Chưa bật" |
|
Trang Cập nhật báo "Không tìm thấy bản phát hành nào" | Token B sai/hết hạn hoặc tài khoản GitHub mất quyền Read: tạo Token B mới (bước 1.2), sửa dòng |
Cập nhật lỗi ở bước "tải image": | Máy chủ phải ra Internet được tới |
Admin bị khoá tài khoản |
|
AI báo lỗi 524 (Cách B) | Yêu cầu quá 125 giây: nhờ AI chia nhỏ (ít tài khoản hơn, khoảng ngày ngắn hơn). |
Cần hỗ trợ: gửi cho Nextgency kết quả của docker compose ps -a và docker compose logs --tail=100 <tên dịch vụ lỗi>. Không gửi nội dung file .env.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Hosted MCP server for marketing agencies: connect Google Ads, GA4, Search Console, Meta, LinkedIn and more to Claude or ChatGPT. Pull reports and make changes via OAuth login, no setup.
Run ads on Google, Meta, LinkedIn, TikTok and more from AI. 610+ tools across 14 platforms.
Analyze, edit and launch Meta (Facebook and Instagram) ads from Claude, ChatGPT, Cursor or Codex. Query insights and campaign health, change budgets, bids, status and targeting with undo, bulk-launch many ads across campaigns and ad sets from a live ad's settings, and duplicate by post to keep social proof. Choose per ad account what the agent may do and what waits in the Agent Inbox for approval. Requires a paid Ads Uploader account with MCP access.
AI agents that manage paid ads on Meta, LinkedIn, and Google Ads from any MCP client.
Related MCP Servers
AlicenseNot gradedqualityFmaintenanceMCP server for managing Google Ads, Meta Ads, LinkedIn Ads, and TikTok Ads via AI. 210+ tools including account audits, wasted spend detection, and PMax insights.2MIT- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to create, analyze, and optimize ad campaigns across Google Ads, Meta Ads, TikTok Ads, LinkedIn Ads, Amazon Ads, and ChatGPT Ads through natural language using 400+ tools.108MIT
- AlicenseNot gradedqualityCmaintenanceHosted remote MCP for Google Ads, Meta Ads (Facebook and Instagram), GA4 and Google Search Console. Connect Claude, ChatGPT, Cursor, Claude Code or Grok with a Google or Facebook login: audits, search terms, GAQL and Insights reports, keyword research, AI-referral traffic, and approved changes to budgets, bids and negatives. OAuth 2.1, no API keys, free.8,167MIT
- AlicenseBqualityCmaintenanceEnables AI assistants and agents to read analytics and manage advertising across Google Ads, Google Analytics 4, and Meta Ads through natural language, with preview-confirm guardrails and configurable account and budget limits.21MIT