FB Ads MCP Server

MCP server sendiri yang bagi Claude akses terus ke data Facebook Ads (Meta Ads) kau — tanpa perlu bayar Supermetrics/Windsor.ai.

Ada 3 tools:

• list_campaigns — senarai campaign (active/paused/all)

• get_campaign_insights — spend, impressions, clicks, CPC, CTR ikut campaign

• get_account_spend_summary — ringkasan total spend untuk seluruh akaun

1. Dapatkan Facebook Access Token

1. Pergi ke Meta Business Suite → Business Settings

2. Bawah Users, pilih System Users → Add → buat satu system user (contoh: mcp-bot)

3. Assign system user tu ke Ad Account kau, dengan permission Manage Campaigns (view sudah cukup untuk ads_read)

4. Klik Generate New Token:

   • App: pilih/buat Facebook App (kena ada App ID di developers.facebook.com)

   • Permission: tick ads_read

   • Token expiry: pilih Never expire (system user token boleh permanent)

5. Copy token tu — ni akan jadi FB_ACCESS_TOKEN

6. Dapatkan Ad Account ID kau dari Business Settings → Accounts → Ad Accounts (format: act_1234567890)

Related MCP server: Meta Ads MCP Server

2. Setup Local (untuk test dulu)

npm install
cp .env.example .env.local
# isi FB_ACCESS_TOKEN, FB_AD_ACCOUNT_ID, dan MCP_SECRET (guna: openssl rand -hex 24)
npm run dev

Server akan jalan di http://localhost:3000/mcp?key=MCP_SECRET_KAU

3. Deploy ke Vercel

npm i -g vercel
vercel

Lepas deploy, pergi ke Vercel Dashboard → Project → Settings → Environment Variables, tambah FB_ACCESS_TOKEN, FB_AD_ACCOUNT_ID, MCP_SECRET (yang sama macam local), then vercel --prod untuk deploy production.

URL server kau akan jadi macam:

https://fb-ads-mcp-xxxx.vercel.app/mcp?key=MCP_SECRET_KAU

4. Connect ke Claude

1. Claude → Settings → Connectors → Add custom connector

2. Paste URL penuh (dengan ?key=... sekali) dari step 3

3. Klik Add

4. Dalam mana-mana chat, klik + → Add connectors → toggle ON connector ni

5. Cuba tanya: "Tunjuk spend campaign aku 7 hari lepas"

Nota Keselamatan

• Server ni public di internet (syarat MCP remote connector). MCP_SECRET di URL adalah satu-satunya proteksi — jangan share URL tu kat sesiapa, treat macam password.

• Token Facebook kau disimpan sebagai environment variable di Vercel, bukan dalam kod — jangan commit .env.local ke Git (dah ada dalam .gitignore sepatutnya, cek balik).

• Kalau nak lebih selamat, boleh upgrade guna OAuth (Claude custom connector ada slot untuk OAuth Client ID/Secret) — tapi untuk penggunaan solo/peribadi, shared secret ni dah cukup.