Zu allen Tutorials
MasterAI

claude-meta-mcp: Mein Open-Source-Connector für Claude

6. Mai 2026·4 min·MasterAI, Claude, MCP, Open Source, Meta
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_management und 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.

Zu allen Tutorials