Meta Ads MCP

Panduan pasang connector Meta Ads (akun Satu Persen) di Claude dan client MCP lain. Status server: mengecek…

URL connector itu rahasia dan tidak ada di halaman ini. Formatnya https://mcp-ads.transferwawasan.com/mcp/<secret>. Minta URL lengkapnya ke admin lewat jalur privat. Siapa pun yang pegang URL ini bisa baca dan ubah iklan, jadi jangan ditempel di grup, dokumen publik, atau screenshot.

Pasang di Claude

Buka claude.ai atau aplikasi Claude desktop, lalu masuk ke Settings → Connectors.
Klik Add custom connector.
Kalau pakai paket Team/Enterprise, biasanya Owner yang menambahkan connector dulu di Admin settings → Connectors. Setelah itu anggota tinggal klik Connect.
Isi formnya:
- Name: Meta Ads
- Remote MCP server URL: URL rahasia dari admin
- Advanced settings (OAuth Client ID/Secret): biarkan kosong
Klik Add. Connector-nya akan muncul dengan 11 tool.
Di chat baru, buka menu tools/connector (ikon + atau slider di kolom chat) dan pastikan Meta Ads aktif.
Tes dengan: "List ad account yang bisa diakses." Hasilnya harus Satu Persen - Indonesian Life School (act_409022593098416).

Pasang di harness lain (DeepSeek, dll.)

Server ini adalah MCP standar dengan transport Streamable HTTP dan tanpa OAuth, jadi bisa dipakai di client MCP mana pun. Di contoh di bawah, ganti <URL-RAHASIA> dengan URL lengkap dari admin.

Pakai model yang mendukung tool / function calling. Kalau modelnya tidak bisa memanggil tool, connector-nya tidak akan terpakai.

Claude Code CLI (juga kalau diarahkan ke API DeepSeek)

claude mcp add --transport http --scope user meta-ads <URL-RAHASIA>

Cek dengan claude mcp list. Status meta-ads harus Connected.

Untuk memakai model DeepSeek, set environment sebelum menjalankan claude (nama model dan detailnya ikuti dokumentasi API DeepSeek):

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<API-KEY-DEEPSEEK>
claude

opencode

Tambahkan ke ~/.config/opencode/opencode.json (global) atau opencode.json di folder project:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "meta-ads": {
      "type": "remote",
      "url": "<URL-RAHASIA>",
      "enabled": true
    }
  }
}

Cherry Studio / aplikasi desktop dengan menu MCP

Buka Settings → MCP Servers → Add Server.
Pilih type Streamable HTTP (kadang tertulis streamableHttp). Jangan pilih SSE atau stdio.
Isi Name meta-ads dan URL <URL-RAHASIA>. Header tidak perlu diisi.
Simpan dan aktifkan. Lalu di chat, nyalakan MCP server ini dan pilih model DeepSeek yang mendukung tool calling.

Cursor

Tambahkan ke ~/.cursor/mcp.json:

{
  "mcpServers": {
    "meta-ads": { "url": "<URL-RAHASIA>" }
  }
}

VS Code (Copilot agent mode)

Dengan konfigurasi ini, VS Code menanyakan URL saat pertama kali dipakai, jadi URL rahasia tidak tersimpan di file yang bisa ikut ke-commit:

{
  "inputs": [
    { "type": "promptString", "id": "meta-ads-url", "description": "URL Meta Ads MCP", "password": true }
  ],
  "servers": {
    "meta-ads": { "type": "http", "url": "${input:meta-ads-url}" }
  }
}

Simpan di user mcp.json (Command Palette → MCP: Open User Configuration) atau di .vscode/mcp.json.

Client yang cuma mendukung stdio

Pakai jembatan mcp-remote (butuh Node.js):

{
  "mcpServers": {
    "meta-ads": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "<URL-RAHASIA>"]
    }
  }
}

Tes manual pakai curl

Kalau berhasil, respons-nya berisi daftar 11 tool:

curl -s -X POST '<URL-RAHASIA>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Di semua client ini, URL rahasia tersimpan sebagai teks biasa di file config. Jangan commit file itu ke git, jangan share dotfiles, dan jangan screenshot isinya.

Tool yang tersedia

Tool	Fungsi	Jenis
`list_ad_accounts`	Daftar ad account yang bisa diakses	baca
`list_campaigns`	Daftar campaign di akun	baca
`list_children`	Ad set / ad di bawah campaign atau ad set	baca
`get_insights`	Spend, CTR, CPC, konversi, ROAS	baca
`create_campaign`	Bikin campaign (selalu PAUSED)	ubah
`create_ad_set`	Bikin ad set (selalu PAUSED)	ubah
`upload_image`	Upload gambar untuk creative	ubah
`create_ad_creative`	Bikin creative single image	ubah
`create_ad`	Bikin ad (selalu PAUSED)	ubah
`set_status`	ACTIVE / PAUSED / ARCHIVED. ACTIVE butuh konfirmasi spend	ubah
`update_budget`	Ubah daily budget	ubah

Pengaman bawaan

Semua campaign, ad set, dan ad baru dibuat dalam status PAUSED. Tidak ada yang langsung tayang.
Mengaktifkan iklan (ACTIVE) harus lewat set_status dengan konfirmasi spend eksplisit.
Daily budget di atas Rp500.000 otomatis ditolak.
Hanya akun act_409022593098416 yang bisa disentuh.

Saran: atur izin tool yang ubah di Claude ke "Needs approval" supaya setiap aksi yang mengubah iklan harus kamu setujui dulu.

Contoh prompt

"Tampilkan spend, CTR, dan ROAS semua campaign 7 hari terakhir."
"Campaign mana yang CPC-nya paling mahal bulan ini? Kasih rekomendasi."
"Bikin draft campaign Traffic untuk webinar, daily budget Rp150.000, biarkan PAUSED."
"Pause semua ad set yang ROAS-nya di bawah 1 minggu ini."

Kalau ada masalah

Connector gagal connect atau error

Cek status di bagian atas halaman ini. Kalau offline, hubungi admin.
Pastikan URL ditempel utuh, termasuk bagian /mcp/…, tanpa spasi atau garis miring di akhir.
Kalau secret baru saja diganti, hapus connector lama lalu tambahkan lagi dengan URL baru.

Error token atau permission dari Meta

Artinya token System User perlu diperbarui atau asset-nya belum di-assign. Hubungi admin.

URL bocor

Langsung kabari admin supaya secret-nya di-rotate. URL lama otomatis mati begitu secret diganti.

Server: mcp-ads.transferwawasan.com · Transport: MCP Streamable HTTP · Meta Graph API v26.0