claude-meta-mcp: Mein Open-Source-Connector für Claude
Wer Meta-Werbedaten oder Postings über KI steuern will, hatte bisher zwei Optionen: einen SaaS-Connector wie windsor.ai oder Pipeboard (deine Daten laufen über deren Server) oder selber Tabellen exportieren und manuell posten. Für Agenturen mit NDAs oder Firmen mit DSGVO-Anforderungen ist beides Mist.
Deshalb habe ich claude-meta-mcp gebaut — einen self-hosted Meta-Connector für Claude und andere MCP-Clients (auch ChatGPT mit MCP-Support). MIT-lizenziert, ohne SaaS-Mittelsmann.
Was es ist
Ein Streamable-HTTP-Server nach Model-Context-Protocol-Standard, der KI-Clients direkt mit der Meta Graph API v22 verbindet. Du installierst ihn auf deinem Server, hinterlegst einen System-User-Token, und greifst von Claude oder ChatGPT aus auf deine Meta Ads, Facebook Pages, Instagram-Konten und Product Catalogs zu.
Was drin steckt
Aktuell 47 Tools (v0.4), aufgeteilt in vier Bereiche:
- Meta Ads (CRUD): Campaigns, Ad Sets, Ads und Creatives anlegen, lesen, ändern, pausieren — inkl. Asset-Upload und Ad-Preview
- Facebook Pages (read + write): Postings erstellen, Insights, Engagement
- Instagram Business Publishing: Images, Videos, Reels, Stories und Carousels veröffentlichen, plus Kommentar-Moderation und Reichweiten-Analytics
- Product Catalogs (read): Businesses, Catalogs, Feeds, Produkte und Diagnostics — für Dynamic Product Ads und Shop-Catalog-Health-Checks
Alles über die offizielle Graph API. Keine Scraper, keine Workarounds.
Sichere Defaults
Alle Erstell-Tools setzen Kampagnen, Ad Sets und Ads standardmäßig auf PAUSED. Aktivieren passiert nur per expliziter zweiter Aktion. Damit kann die KI nicht aus Versehen Budget verbrennen.
Wie es technisch läuft
- TypeScript, Node 20, Express 5
- MCP SDK + OAuth 2.1 mit Dynamic Client Registration
- nginx als Reverse Proxy, pm2 im Cluster-Modus
- TLS via Let's Encrypt
Der OAuth-Shim erlaubt, dass Claude.ai den Connector über die normale „Connector hinzufügen"-Oberfläche einbinden kann — kein Tunneln, kein Hack.
Was du brauchst
- Eine Meta Developer App im Business-Modus mit den passenden Use Cases
- System-User-Token mit
ads_read,ads_management,business_managementund den Pages-/Instagram-Scopes - Linux-VPS mit Node 20
- nginx + TLS-Zertifikat
In der README ist Schritt für Schritt beschrieben, wie du die Meta App aufsetzt und den Token erzeugst — das ist meistens der nervigste Teil.
Warum Open Source
Der Code soll nicht in meiner Schublade liegen. Wer einen eigenen Connector für andere Plattformen bauen will (Google Ads, LinkedIn, TikTok), kann den OAuth-Layer und die MCP-Struktur einfach übernehmen. Lizenz: MIT — forken, anpassen, kommerziell nutzen, alles erlaubt.
Wer mitbauen oder Issues melden möchte: das Repo liegt auf GitHub.
Mehr zur Idee dahinter und zur kompletten Tool-Liste auf der Repo-Seite hier.
