claude-meta-mcp
Self-hosted Meta-Connector für Claude — Ads CRUD, Pages, Instagram und Product Catalogs, ohne SaaS-Mittelsmann.
claude-meta-mcp ist ein Streamable-HTTP-Server nach dem Model-Context-Protocol-Standard, der Claude.ai (und jeden anderen MCP-Client) direkt mit der Meta-Graph-API verbindet. Du installierst ihn an deinem eigenen Server, hinterlegst dein System-User-Token und führst dann den kompletten Werbe-Workflow durch Claude aus — Bilder und Videos hochladen, Kampagnen / Ad Sets / Ads erstellen, Pages und Instagram bespielen, Product Catalogs für Dynamic Product Ads inspizieren — ohne dass deine Werbedaten je durch einen Drittanbieter laufen.
47 Tools quer durch Meta
Meta-Ads read+write (Campaigns, Ad Sets, Ads, Creatives, Bild- und Video-Upload, Ad-Preview), Facebook-Pages read+write, Instagram-Business-Publishing (Image / Video / Reel / Story / Carousel) plus Comment-Moderation und Insights, sowie Product-Catalog-Inspektion (Businesses, Catalogs, Feeds, Produkte, Diagnostics) für Dynamic Product Ads.
Sichere Defaults
Alle Create-Tools für Campaigns / Ad Sets / Ads defaulten auf status=PAUSED. Live geht nur wer explizit ACTIVE übergibt — kein Cent fließt aus Versehen.
Self-hosted
Läuft hinter nginx + pm2 cluster mode. Keine SaaS-Subscription, keine Proxy-Server zwischen dir und Meta. Deine Daten, dein Server, dein System-User-Token.
MIT-lizenziert
Forke, modifiziere, kommerziell einsetzen — alles erlaubt. Pull Requests willkommen, kontinuierliche Releases via GitHub Actions.
Warum das?
Wer Meta-Ads-Daten in Claude analysieren will, hatte bisher zwei Optionen: einen SaaS-Connector wie Windsor.ai oder Pipeboard nutzen — oder per Hand Spreadsheets exportieren. Bei beiden Wegen verlassen Werbedaten das eigene System: zur SaaS, zu Spreadsheets, am Ende in den Claude-Kontext. Für Agenturen mit NDAs oder Unternehmen mit DSG-Anforderungen ist das oft kein gangbarer Weg.
claude-meta-mcp schließt diese Lücke: Du behältst dein System-User-Token bei dir, der Server läuft an deiner Infrastruktur, und Claude bekommt nur die Daten, die du explizit per Tool-Call freigibst.
Architektur
Express 5 als HTTP-Layer, das offizielle @modelcontextprotocol/sdk für die Tool-Registrierung, ein DCR-Shim der die fehlenden OAuth-Discovery-Endpoints von Meta nachbildet. Streamable-HTTP-Transport (kein WebSocket nötig), kompatibel mit Claude Web sowie Claude Desktop und allen anderen MCP-Clients die diesen Transport unterstützen.
Authentifizierung gegenüber Meta läuft über ein Long-Lived System-User-Token, das du einmalig in einer .env hinterlegst. Pro Tool-Call wird die Graph-API mit diesem Token gerufen, das Ergebnis wird vor Rückgabe gefiltert und gerundet (PII-Stripping bei Page-Insights).
Was du brauchst
Eine Meta-Developer-App im Business-Modus mit den fünf Use Cases »Measure ad performance«, »Create and manage ads«, »Manage everything on your Page«, »Manage messaging and content on Instagram« und »Manage products with Catalog API«. Ein System-User-Token mit den Scopes ads_read, ads_management, business_management, pages_show_list / pages_manage_posts / pages_manage_metadata / pages_read_engagement, instagram_basic / instagram_content_publish / instagram_manage_comments / instagram_manage_insights und catalog_management. Außerdem einen Linux-VPS mit Node 20 + nginx und ein TLS-Zertifikat für die Connector-Domain. Das vollständige Setup inklusive Screenshots des Meta-Developer-Portals findest du im Meta-App-Setup-Guide.
Vergleich mit SaaS-Alternativen
Windsor.ai und Pipeboard sind wartungsfrei und bieten zusätzliche Datenquellen, kosten aber laufende Gebühren und exportieren deine Daten in deren Cloud. claude-meta-mcp ist kostenlos und self-hosted, deckt dafür nur Meta ab und du musst dich um Updates und Verfügbarkeit selbst kümmern. Die Wahl hängt davon ab, ob Datenschutz oder Convenience Vorrang hat.
Brauche ich Programmierkenntnisse für die Installation?
Linux-Grundkenntnisse reichen. Der Deployment-Guide ist als Schritt-für-Schritt-Anleitung geschrieben. Für die Meta-Developer-App musst du dich einmalig durch das Business-Manager-Interface klicken — dafür gibt es ebenfalls einen eigenen Guide.
Funktioniert das mit dem Free-Plan von Claude?
Custom MCP Connectors brauchen einen kostenpflichtigen Claude-Plan (Pro oder höher) — das ist eine Anthropic-Vorgabe, nicht von diesem Repo abhängig.
Werden alle Meta-Produkte unterstützt?
Aktuell Meta-Ads (Read+Write inkl. Asset-Upload), Facebook-Pages (Read+Write), Instagram-Business (Read+Write inkl. Reels / Stories / Carousel und Comment-Moderation) und Product Catalogs (Read — Businesses, Catalogs, Feeds, Produkte, Diagnostics für Dynamic Product Ads). WhatsApp-Cloud-API und Instagram-DMs sind bewusst ausgeklammert — DMs benötigen App Review auch für eigene Accounts. Catalog-Writes (Create / Update / Delete) folgen in v0.5.