Facebook/Meta Ads MCP Server

Bu proje, Meta Ads'e arayüz görevi gören bir MCP sunucusu sağlayarak Meta Ads verilerine ve yönetim özelliklerine programatik erişim sağlar.

Kolay Tek Tıklamayla Kurulum

Daha basit bir kurulum deneyimi için hazır kurulum programları sunuyoruz:

👉 Kurulum programını indir - https://gomarble.ai/mcp

Yardım ve güncellemeler için toplulukumuza katılın

👉 Slack Topluluğu - AI in Ads

Google ads mcp server'ı da deneyin

👉 Google Ads MCP - Google Ads MCP

Ne Yapar

• MCP sunucusunu yerel olarak yükler ve yapılandırır
• Environment kurulumunu otomatik olarak yönetir
• Meta token kimlik doğrulaması için sorular sorar (isteğe bağlı)
• Meta access token sağlanmazsa, sizin adınıza token oluşturmak için GoMarble'ın sunucusuna bağlanır

Önemli Feragatname

Bu kurulum gerektirmez Meta Developer Access Token'ını manuel olarak almanızı.

Bunun yerine, GoMarble'ın sunucusuna güvenli bir şekilde bağlanarak sizin adınıza token oluşturur. GoMarble, token'ınızı depolamaz — MCP sunucusuyla kullanılmak üzere yerel olarak makinenizde kaydedilir.

---

Kurulum

Ön Gereksinimler

• Python 3.10+
• requirements.txt dosyasında listelenen bağımlılıklar

1. (İsteğe Bağlı ama Önerilir) Sanal Ortam Oluşturun ve Etkinleştirin:

   python3 -m venv venv
   source venv/bin/activate  # Windows'ta `venv\Scripts\activate` kullanın
   

   Sanal ortam kullanmak proje bağımlılıklarını temiz bir şekilde yönetmeye yardımcı olur[Kaynak].

2. Bağımlılıkları Yükleyin:

   pip install -r requirements.txt
   

3. Meta Access Token Alın: Gerekli izinlere (örn. ads_read) sahip bir Meta User Access Token güvenli hale getirin. Bunu Meta Developer portalı aracılığıyla oluşturabilirsiniz. Bu bağlantıyı takip edin.

MCP İstemcileriyle Kullanım (örn. Cursor, Claude Desktop)

Bu sunucuyu MCP uyumlu bir istemciyle entegre etmek için, YOUR_META_ACCESS_TOKEN yerine gerçek token'ınızı yazarak ve gerekirse server.py yolunu ayarlayarak aşağıdakine benzer bir konfigürasyon ekleyin.

{
  "mcpServers": {
    "fb-ads-mcp-server": {
      "command": "python",
      "args": [
        "/path/to/your/fb-ads-mcp-server/server.py",
        "--fb-token",
        "YOUR_META_ACCESS_TOKEN"
      ]
      // Sanal ortam kullanıyorsanız, venv içindeki python executable'ını belirtmeniz gerekebilir:
      // "command": "/path/to/your/fb-ads-mcp-server/venv/bin/python",
      // "args": [
      //   "/path/to/your/fb-ads-mcp-server/server.py",
      //   "--fb-token",
      //   "YOUR_META_ACCESS_TOKEN"
      // ]
    }
  }
}

Konfigürasyonda güncelleme yaptıktan sonra MCP İstemci uygulamasını yeniden başlatın.

(Not: Windows'ta, kurulumunuza bağlı olarak komut yapısını ayarlamanız veya cmd /k kullanmanız gerekebilir.)

Sunucuyu Hata Ayıklama

server.py dosyasını çalıştırarak access token'ı --fb-token argümanı aracılığıyla sağlayın.

python server.py --fb-token YOUR_META_ACCESS_TOKEN

Kullanılabilir MCP Araçları

Bu MCP sunucusu META Ads nesneleri ve verileriyle etkileşim kurmak için araçlar sağlar:

Araç Adı	Açıklama
Hesap ve Nesne Okuma
list_ad_accounts	Token'a bağlı reklam hesaplarını listeler.
get_details_of_ad_account	Belirli bir reklam hesabının detaylarını alır.
get_campaign_by_id	Belirli bir kampanyasının detaylarını alır.
get_adset_by_id	Belirli bir reklam setinin detaylarını alır.
get_ad_by_id	Belirli bir reklamın detaylarını alır.
get_ad_creative_by_id	Belirli bir reklam yaratıcı öğesinin detaylarını alır.
get_adsets_by_ids	Birden fazla reklam setinin detaylarını ID'ye göre alır.
Koleksiyonları Alma
get_campaigns_by_adaccount	Reklam hesabındaki kampanyaları alır.
get_adsets_by_adaccount	Reklam hesabındaki reklam setlerini alır.
get_ads_by_adaccount	Reklam hesabındaki reklamları alır.
get_adsets_by_campaign	Kampanyadaki reklam setlerini alır.
get_ads_by_campaign	Kampanyadaki reklamları alır.
get_ads_by_adset	Reklam setindeki reklamları alır.
get_ad_creatives_by_ad_id	Reklamla ilişkili yaratıcı öğeleri alır.
İçgörüler ve Performans Verileri
get_adaccount_insights	Reklam hesabı için performans içgörülerini alır.
get_campaign_insights	Kampanya için performans içgörülerini alır.
get_adset_insights	Reklam seti için performans içgörülerini alır.
get_ad_insights	Reklam için performans içgörülerini alır.
fetch_pagination_url	Pagination URL'den veri alır (örn. içgörülerden).
Aktivite/Değişiklik Geçmişi
get_activities_by_adaccount	Reklam hesabı için değişiklik geçmişini alır.
get_activities_by_adset	Reklam seti için değişiklik geçmişini alır.

(Not: Çoğu araç fields, filtering, limit, pagination, tarih aralıkları vb. gibi ek parametreleri destekler. Her araç için tam argüman listesi ve açıklaması için server.py içindeki detaylı docstring'lere bakın.)

(Not: Meta access token'ınızın süresi dolarsa, yeni bir tane oluşturmanız ve araçları kullanmaya devam etmek için MCP İstemcisinin konfigürasyon dosyasını yeni token'la güncelleştirmeniz gerekir.)

Bağımlılıklar

• mcp (>=1.6.0)
• requests (>=2.32.3)

Lisans

Bu proje MIT Lisansı altında lisanslanmıştır.

---

Smithery Aracılığıyla Yükleme

Facebook Ads Server'ı Claude Desktop için Smithery aracılığıyla otomatik olarak yüklemek için:

npx -y @smithery/cli install @gomarble-ai/facebook-ads-mcp-server --client claude