Open MCP Servers ist ein Zuhause für selbst gehostete Model Context Protocol (MCP)-Konnektoren. Betreiben Sie den Server auf Ihrer eigenen Maschine oder Infrastruktur, verbinden Sie ihn mit einem MCP-kompatiblen KI-Client und behalten Sie Anmeldedaten sowie Anwendungsdaten unter Ihrer Kontrolle.
Dieses Repository enthält derzeit einen produktionsreifen Meta-Konnektor, der Facebook Pages, Instagram, Threads, Ads Manager, Commerce, Conversions API, Zielgruppen und Insights abdeckt. Die Konnektor-Architektur ist bewusst unkompliziert gehalten, damit die Community Konnektoren für andere Anwendungen hinzufügen kann, ohne von einem gehosteten Gateway oder einer anbieterkontrollierten Middleware abhängig zu sein.
Sie können dieses Projekt unter der MIT-Lizenz frei nutzen, ändern, forken, hosten und weiterverbreiten. Sie sind für die Anmeldedaten, den API-Zugriff, die Hosting-Umgebung und die Bedingungen der Drittanwendungen verantwortlich, die Sie anbinden.
MCP stellt die standardisierte Schnittstelle zwischen einem KI-Client und einem Server bereit. Jede Anwendung benötigt außerdem einen Konnektor, der ihre API, ihre Authentifizierung und ihre Operationen kennt. Nutzen Sie den enthaltenen Meta-Konnektor als Referenz und fügen Sie anschließend einen neuen API-Client sowie Tool-Module für die Anwendung hinzu, die Sie unterstützen möchten.
Dieses Projekt sendet Ihre Anmeldedaten nicht an einen zentralen Dienst und erfordert kein Abonnement.
Related MCP server: Meta Marketing API MCP Server
Für Social-Media-Management über Metas Plattformen hinweg – Facebook Pages, Instagram, Threads, Ads Manager und Commerce – Entemed mehrere Dashboards mit jeweils eigenen API-Eigenheiten und Token-Abläufen. Der enthaltene Konnektor bündelt dieser APIs in einer einzigen MCP-Schnittstelle, sodass Ihr KI-Assistent Transaktionen veröffentlichen, die Performance analysieren, Anzeigenkampagnen fingieren und Interaktionen plattformübergreifend moderieren kann, an allen in einer Konversation.
Jedes Tool liefert umsetzbare Fehlermeldungen – ohne kryptische API-Codes. Token abgelaufen? Sie erhalten einen Link zur Neu-Erlangung. Fehlende Berechtigung? Sie sehen genau, welchefehlt und wo sie vergeben wird. Das bedeutet weniger Debugging und mehr Umsetzung.
Für Claude Desktop und andere MCPB-kompatible Clients können Sie ein lokales Bundle aus dem neuesten Release herunter, sobald eines verfügbar ist:
Das npm-Paket und die weiter.. eine weiter unten beschriebene Installation aus dem MCP-Source sind die portablen Optionen für Selbst-Hosting.
Das Bundle enthält das Meta-Favicon, die Produktionslaufzeit-Abhängigkeiten sowie Setup-Prompts für Meta-C und optionale Threads-Zugriffstokens.
Fügen Sie es zu Ihrer MCP-Client-Konfiguration hinzu:
{
"mcpServers": {
"meta": {
"command": "npx",
"args": ["-y", "@oliverames/meta-mcp-server"],
"env": {
"META_ACCESS_TOKEN": "your_token_here"
}
}
}
}That’s it. Ihr KI-Assistent hat jetzt Zugriff auf 200 Meta-Tools über einen Server, den Sie selbst steuern.
Sie brauchen ein Token? Öffnen Sie den Graph-API-Explorer, wählen Sie Ihre App und erstellen Sie ein. Weitere Details finden Sie in der Konfiguration.
git clone https://github.com/open-work-org/open-mcp-servers.git
cd open-mcp-servers
npm install && npm run buildDer kompilierte Server kommuniziert über stdio und funktioniert daher mit jedem MCP-Client, der lokale stdio-Server unterstützt. Selbsthosting ist das Standard-Bereitstellungsmodell; dieses Repository verlangt weder eine gehosten Konto noch eine Projektregist perem.
Sie veröffentlichen Facebook Pages (Text, Fotos, Video, Reels, Stories), Instagram² (Fotos, Reels, Stories, Karussells) und Text, Bilder, Video, GIFs und Links in Combo. Planen Sie Inhalte im Software is, teilen Sie sie gleichzeitig auf mehrere Plattformen.
> Post our holiday hours to the Facebook page
> Schedule an Instagram carousel for tomorrow at 9am
> Cross-post this photo to both Facebook and Instagram
> Publish a GIF to Threads with reply controls
> Create a Facebook Reel from this video
> Post a Story to our Facebook page
> Publish an Instagram reel with alt text for accessibility
> Share a link post on Threads with a quoteLesen und beantworten Kommentare plattformübergreifend, blenden unpassende Inhalte aus, ohne sie zu löschen, verwalten Instagram-DMs und Broadcast-Kanäle und erstellen automatisierte Antworten, wenn Sie nicht da sind.
> Show me unanswered Instagram DMs
> Hide that offensive comment on our latest post
> Reply to the top 3 comments on yesterday's reel
> Set up an instant reply for new messages
> Set our away message to "Back Monday at 9am"
> Send a DM to that customer who reached out
> What comments did we get on last week's posts?
> Update our Messenger greeting textErhalten Sie Einblicke auf jeder Ebene… Seite, Beitrag, Konto, Snacks, Adsatz und auf Daten-Anzeige. Über 70 Seiten-Metriken, umfassende Reels-Analysen (inklusive Überspringrate und Crosspost-Aufrufe) und volle Ads-Leistung ber Videoabschlussraten, ROAS und Stapel Rankings. Erstellen Sie Grafiken für Reports.
> How did our Instagram perform this month?
> Show campaign spend broken down by age group
> What's the skip rate on our latest Reel?
> Generate a bar chart comparing this week vs last
> Get our Facebook page fan demographics
> What's our follower growth trend over 90 days?
> Show me post-level engagement for our top 5 posts
> Create a pie chart of spend by campaignKompletter Lebenszyklus von Kampagneingang einführen – Erstellen, A/B-Test, Testen, und Automatisierung. A/B-Tests mit Konfidenzlevel, Advantage+ Shopping-Migration, interessen/geo-demografischem Such-, Reichweiten-Schätzung, automatische Regeln und vollständiges Pixel-Management mit Server-seitigem Conversions API.
> Create an A/B test comparing these two ad sets
> Migrate this campaign to Advantage+ Shopping
> Send a purchase conversion event via CAPI
> What's the reach estimate for women 25-34 in NYC?
> List all active campaigns and their ROAS
> Create an automated rule: pause ads over $5 CPA
> Check if our pixel is firing correctly
> Upload this image for a new ad creativeVollständige Verwaltung verschiedener Produkt-Kataloge für Facebook-Shops und Instagramshops – Produkte hinzufügen, den Bestand aktualisieren, Kollektionen organisieren und Verfügbarkeit verwalten. Alles, was eine Marke für den erfolgreichen Social-Commerce düchten.
> List all products in our catalog
> Add this new product at $29.99, in stock
> Mark the seasonal items as out of stock
> Show me our "Summer Collection" product set
> Update the description on our best-selling item
> How many products are in each catalog?
> Delete the discontinued product line
> What products are currently available?> Start a live video on our Facebook page
> Send a poll to our Instagram broadcast channel
> Schedule a live stream for Friday at 2pm
> Publish a story to Facebook with this photo
> End the live broadcast
> Send a product announcement to our broadcast channel
> What live videos have we done this month?
> What ads is our competitor running right now?Durchsuchen Sie die aktiven Anzeigen jedes Werbenden über Metas öffentliche Anzeigenbibliothek. Erfahren Sie, welche Creative Bilder eingesetzt werden, welches Targeting und welche Ausgaben Ihre Konkurrenz nutzt – ohne Anzeigenkonto. Sehen Sie sich die Stats von beliebigen öffentlichenInstagram-Unternehmenskonten anieren.
> What ads is Nike running in the US right now?
> Search the Ad Library for "sustainable fashion" ads
> Look up @competitor on Instagram — followers and posts
> Show me all active ads by this page ID
> What platforms are they running ads on?
> How much is our competitor spending on ads?Tokens debuggen, “Rechte prüfen, Rate Limits überwachen, Pixel-Zustand, Stellen Sie sicher and Business Manager-Assets verwalten. Jeder Fehler zeigt Ihnen genau, woran es liegt und wie Sie ihn beDaten beheben – nie ein kryptisches Problem.
> Check my token status and permissions
> Am I close to Instagram's publishing limit?
> Run a health check on the Meta connection
> Is our pixel receiving events?
> List all ad accounts in our Business Manager
> Share this pixel with our agency's ad account
> What Threads rate limits do we have left?
> Debug why this API call is failingAlles, was eine Marke braucht, um ihre Facebook-Präsenz, das Messaging und die Live-Übertragungen zu verwalten.
Tool | Beschreibung |
| Listet alle Facebook-Seiten auf, die du verwaltest (zuerst aufrufen — speichert Seiten-Tokens) |
| Ruft detaillierte Seiteninformationen ab (Kategorie, Follower, Beschreibung, Link) |
| Ruft einen einzelnen Beitrag anhand der ID ab |
| Erstellt einen Textbeitrag auf einer Seiteunden |
| Erstellt einen Fotobeitrag (URL oder Foto-ID der Seite) |
| Erstellt einen Videobeitrag mit optionalem Titel und Beschreibung |
| Bearbeitet die Nachricht eines bestehenden Beitrags |
| Löscht einen Beitrag |
| Ruft den Feed einer Seite mit Paginierung ab |
| Ruft nur veröffentlichte Beiträge ab |
| Ruft geplante (unveröffentlichte) Beiträge äuf |
| Ruft Beiträge ab, die für Anzeigen-Promotion geeignet sind |
| Ruft Beiträge ab, die Besucher auf der Seite verfasst haben |
| Ruft Kommentare zu einem Beitrag mit Paginierung ab |
| Antwortet als Seite auf einen Kommentar |
| Löscht einen Kommentar |
| Blendet einen Kommentar aus oder wieder ein (nicht-destruktive Moderation) |
| Markiert einen Beitrag oder Kommentar mit „Gefällt mir“ oder „Gefällt mir nicht mehr“ |
| Ruft das Reaktions-Screening ab („Gefällt mir“, „Love“, „HaHa“, „Wow“, „Traurig“, „Wütend“) |
| Seitenanalysen — über 70 Kennzahlen zu Impressionen, Likes, Fans und Video |
| Beitragsanalyse (Impressionen, Interaktion, Klicks, Reaktionen, Video) |
| Listet Nachrichtenunterhaltungen der Seite auf |
| Ruft Nachrichten innerhalb einer Unterhaltung ab |
| Sendet einem Benutzer eine Nachricht (24-Stunden-Nachrichtenfenster) |
| Aktualisiert Seitendetails (Info, Beschreibung, Website, Öffnungszeiten, Benutzername, Kategorie, Adresse) |
| Aktualisiert das Profilbild der Seite von einer URL |
| Aktualisiert das Titelbild der Seite von einer URL oder einem vorhandenen Foto |
| Erstellt ein Seiten-Event |
| Listet Events auf (bevorstehende, vergangene oder abgesagte) |
| Listet die Fotoalben der Seite auf |
| Ruft Fotos ab (hochgeladene oder markierte) |
| Listet die Videos der Seite auf |
| Ruft Beiträge ab, in denen die Seite markiert ist |
| Follower-Aufschlüsselung nach Alter, Geschlecht und Land |
| Ruft Seitenbewertungen und Sternebewertungen ab |
| Standortinformationen für Unternehmen mit mehreren Standorten |
| Ruft die Call-to-Action-Button-Konfiguration der Seite ab |
| Listet die Tabs der Seite und ihre Konfiguration |
| Ruft die URL des Seitenprofilfoto ab |
| Listet blockierte Benutzer auf |
| Blockiert einen Benutzer oder hebt die Blockierung auf |
| Abonniert die Seite für Webhook-Ereignisse |
| Veröffentlicht eine Facebook-Story (Foto oder Video) |
| Veröffentlicht ein Facebook-Reel |
| Crosspostet gleichzeitig auf Facebook + Instagram |
| Startet oder plant eine Live-Video-Übertragung |
| Listet Live-Videos auf einer Seite auf |
| Beendet eine aktive Live-Übertragung |
| Ruft die aktuellen Einstellungen für automatische Antworten ab |
| Setzt die Sofortantwort-Nachricht |
| Setzt die Abwesenheits-/Offline-Nachricht |
| Setzt den Messenger-Begrüßungstext |
Vollständige Instagram-Business-API — Veröffentlichung mit Zeitplanung, DMs, Broadcast-Kanälen, Engagement, Auffindbarkeit und Analysen.
Tool | Beschreibung |
| Instagram-Unternehmenskonten auflisten, die mit Ihren Facebook-Seiten verknüpft sind |
| Neueste Medien für ein Instagram-Konto mit Paginierung abrufen |
| Ein einzelnes Medienobjekt anhand der ID abrufen |
| Ein Foto mit optionalem Alt-Text und Zeitplanung veröffentlichen |
| Ein Reel mit automatischer Abfrage und optionaler Zeitplanung veröffentlichen |
| Eine Story veröffentlichen (Bild oder Video mit automatischer Abfrage) |
| Ein Karussell veröffentlichen (2–10 Elemente, parallele Verarbeitung, planbar) |
| Einen zuvor erstellten Mediencontainer veröffentlichen |
| Verarbeitungsstatus des Containers mit umsetzbaren Hinweisen prüfen |
| Analysen auf Kontenebene mit demografischen Aufschlüsselungen |
| Kennzahlen pro Beitrag, einschließlich Überspringrate bei Reels und Crosspost-Aufrufen |
| Kommentare zu einem Medienobjekt abrufen |
| Thread-Antworten zu einem Kommentar abrufen |
| Auf einen Kommentar antworten |
| Einen Kommentar löschen |
| Kommentar ausblenden/wieder anzeigen (nicht destruktive Moderation) |
| Produkte in einem Instagram-Shopping-Katalog nach Namen suchen |
| Nach Top- oder aktuellen Medien zu einem Hashtag suchen |
| Ihre zuletzt gesuchten Hashtags abrufen |
| Business-Discovery – beliebige öffentliche Unternehmen/Creator anhand des Benutzernames suchen |
| Aktuell aktive Stories abrufen |
| Live-Video-Medien abrufen |
| Medien abrufen, in denen Sie @erwähnt werden |
| Einzelne Elemente eines Karussells abrufen |
| Produkt-Tags auf einem Medienobjekt abrufen |
| Ein Medienobjekt löschen |
| Kommentare für Medien aktivieren oder deaktivieren |
| Status der Veröffentlichungsbegrenzung prüfen (100 Beiträge pro 24 Stunden) |
| Instagram-DM-Unterhaltungen auflisten |
| Nachrichten in einer DM-Unterhaltung abrufen |
| Eine Text-DM senden |
| Ein Bild oder einen Link per DM senden |
| Produktkataloge für Instagram Shopping auf einem professionellen Konto auflisten |
| Broadcast-Kanäle auflisten |
| Nachrichten in einem Broadcast-Kanal abrufen |
| Nachricht an einen Broadcast-Kanal senden |
| Umfrage in einem Broadcast-Kanal erstellen |
Tool | Description |
| Werbekonten auflisten, auf die Sie Zugriff haben |
| Werbekontodetails abrufen (Status, Währung, Ausgabenlimit, Guthaben) |
| Kampagnen mit Statusfilter und Paginierung auflisten |
| Vollständige Details einer einzelnen Kampagne abrufen |
| Kampagne erstellen (unterstützt Advantage+ Shopping für OUTCOME_SALES) |
| Kampagnenname, Status oder Budget aktualisieren oder zu Advantage+ migrieren |
| Kampagne löschen |
| Kampagne zu Advantage+ Shopping migrieren (behält Kampagne-ID bei) |
| Anzeigengruppen mit Filtern auflisten |
| Targeting- und Budgetdetails einer einzelnen Anzeigengruppe abrufen |
| Anzeigengruppe mit Targeting, Budget und placement_soft_opt_out erstellen |
| Targeting, Budget oder placement_soft_opt_out einer Anzeigengruppe aktualisieren |
| Anzeigengruppe löschen |
| Anzeigen mit Statusfilter auflisten |
| Details einer einzelnen Anzeige abrufen |
| Anzeige erstellen, die ein Creative mit einer Anzeigengruppe verknüpft |
| Anzeigenname, Status oder Creative aktualisieren |
| Anzeige löschen |
| Anzeigen-Creatives auflisten |
| Details eines einzelnen Creatives abrufen |
| Anzeigen-Creative mit Text, Bild und Link erstellen |
| Vorschau, wie eine Anzeige in verschiedenen Platzierungen aussieht |
| Details für eine bestimmte automatisierte Anzeigenregel abrufen |
| Benutzer mit Zugriff auf das Werbekonto auflisten |
| Bild für die Verwendung in Anzeigen-Creatives hochladen |
| Zuvor hochgeladene Anzeigenbilder auflisten |
| Video für die Verwendung in Anzeigen-Creatives hochladen |
| Zuvor hochgeladene Anzeigenvideos auflisten |
| Nach interessenbasierten Targeting-Optionen suchen |
| Nach standortbasierten Targeting-Optionen suchen (Länder, Städte, PLZ) |
| Nach demografischen Targeting-Optionen suchen |
| Alle verfügbaren Targeting-Kategorien durchsuchen |
| Potenzielle Zielgruppengröße für eine Targeting-Spezifikation schätzen |
| Anzeigenauslieferung für ein gegebenes Budget und Targeting schätzen |
| Übermittelte Leads aus einem Leadgenerierungsformular abrufen |
| Minimale Tages- und Laufzeitbudgets für ein Werbekonto nach Währung und Gebotsstrategie abrufen |
| Leadgenerierungsformulare für eine Facebook-Seite auflisten |
| Offline-Conversion-Event-Sets für ein Werbekonto auflisten |
| Meta Pixel für Conversion-Tracking auflisten |
| Neuen Pixel erstellen |
| Pixeldetails abrufen (Name, Cookie-Status, Abgleichsfelder) |
| Event-Volumen-Statistiken im Zeitverlauf abrufen (prüfen, ob der Pixel auslöst) |
| Pixel-Einstellungen aktualisieren (Name, Cookies, Abgleich, Datennutzung) |
| Pixel löschen |
| Pixel-Zugriff mit einem anderen Werbekonto teilen |
| Aktuelle Test-Events zum Debugging abrufen |
| Benutzerdefinierte Conversion-Events auflisten |
| Benutzerdefinierte Conversion aus Pixel-Events erstellen |
| Gespeicherte Zielgruppen auflisten |
| Wiederverwendbare gespeicherte Zielgruppe erstellen |
| Gespeicherte Zielgruppe löschen |
| Automatisierte Anzeigenregeln auflisten |
| Automatisierte Regel erstellen (z. B. Anzeigen bei über 5 $ CPA pausieren) |
| Automatisierte Regel löschen |
| Anzeigen-Labels zur Organisation auflisten |
| Anzeigen-Label erstellen |
| Aktivitätsprotokoll des Werbekontos abrufen |
| Seiten, Werbekonten, IG-Konten und Pixel im Business Manager auflisten |
| Einen A/B-Test erstellen, um Kampagnen oder Anzeigegruppen zu vergleichen |
| A/B-Tests für ein Werbekonto anzeigen |
| A/B-Testergebnisse mit Gewinner und Konfidenzniveau abrufen |
| Offline-Conversion-Event senden, für Ladenkaufschaft, Tele hear orders |
Vollständige Threads-API – Veröffentlichen mit GIFs, Antwortsteuerungen, Ortsmarkierungen und Analysen.
Tool | Beschreibung |
| Ruft deine Threads-Profilinformationen ab |
| Ruft deine letzten Beiträge mit Pagination ab |
| Ruft einen einzelnen Beitrag anhand der ID ab (inkl. reply_audience) |
| Durchsucht deine Beiträge nach Stichwörtern |
| Veröffentlicht einen Textbeitrag (mit Antwortsteuerung und Ort) |
| Veröffentlicht einen Bildbeitrag (mit Antwortsteuerung und Ort) |
| Veröffentlicht einen Videobeitrag mit automatischem Abruf (mit Antwortsteuerung und Ort) |
| Veröffentlicht ein Karussell (parallele Erstellung, mit Antwortsteuerung) |
| Veröffentlicht einen Beitrag mit einem Link-Anhang (mit Antwortsteuerung) |
| Veröffentlicht einen GIF-Beitrag über eine GIPHY-URL |
| Löscht einen Beitrag |
| Ruft Antworten auf einen Beitrag ab |
| Ruft den vollständigen Gesprächsbaum für einen Beitrag ab |
| Listet Follower des authentifizierten Threads-Benutzers auf |
| Listet Konten auf, denen der authentifizierte Threads-Benutzer folgt |
| Ruft Beiträge ab, die dich @erwähnen |
| Ruft einzelne Elemente eines Karussell-Beitrags ab |
| Blendet eine Antwort aus oder wieder ein |
| Teilt einen Threads-Beitrag erneut (Repost) |
| Ruft Kennzahlen für einen bestimmten Beitrag ab (Aufrufe, Likes, Antworten usw.) |
| Ruft Konto-Kennzahlen mit demografischen Aufschlüsselungen ab |
| Prüft den aktuellen Status deiner Veröffentlichungs-Ratenlimitlimits |
Verwaltung von Produktkatalogen für Facebook- und Instagram-Shops.
Tool | Beschreibung |
| Listet Produktkataloge für ein Unternehmen auf |
| Ruft Katalogdetails und Produktanzahl ab |
| Listet Produkte in einem Katalog mit Filterfunktion auf |
| Ruft die vollständigen Details eines Produkts ab |
| Fügt einem Katalog ein Produkt hinzu |
| Erstellt einen Produkt-Feed, um Produkte automatisch von einer URL aus zu synchronisieren |
| Aktualisiert Produktdetails (Name, Preis, Verfügbarkeit usw.) |
| Löscht ein Produkt aus einem Katalog |
| Listet Produkt-Feeds für einen Katalog auf |
| Listet Produktsets (Untergruppen) in einem Katalog auf |
Serverseitiges Event-Tracking zur Conversion-Optimierung.
Tool | Beschreibung |
| Sendet ein serverseitiges Conversion-Event (Purchase, Lead usw.) an einen Pixel |
| Testet das CAPI-Setup, ohne die Produktionsdaten zu beeinträchtigen |
Verwaltung von benutzerdefinierten und Lookalike-Zielgruppen für das Anzeigen-Targeting.
Tool | Beschreibung |
| Listet benutzerdefinierte Zielgruppen in einem Werbekonto auf |
| Ruft Zuschauerdetails ab (Größe, Auslieferungsstatus) |
| Erstellt eine benutzerdefinierte Zielgruppe |
| Erstellt eine Lookalike-Zielgruppe aus einer Quell-Zielgruppe |
| Löscht eine benutzerdefinierte Zielgruppe |
Analyse der Werbeleistung über die gesamte Anzeigenhierarchie hinweg mit 37 Kennzahlen, 15 Datumsvoreinstellungen und 8 Aufschlüsselungsdimensionen.
Tool | Beschreibung |
| Anzeigenkonto-Leistung – Ausgaben, Impressionen, Reichweite, Klicks, CTR, CPM, CPC, Conversions, ROAS, Videoabrufe, Qualitätsbewertung |
| Leistung pro Kampagne mit denselben umfassenden Kennzahlen |
| Leistung pro Anzeigengruppe |
| Leistung pro Anzeige |
Erstellt visuelle Diagramme aus Daten für Berichte und Präsentationen.
Tool | Beschreibung |
| Erstellt Balken-, Linien-, Kreis-, Donut- und Radar-Diagramme als PNG-Bilder |
| Erstellt Vergleichsdiagramme nebeneinander (A/B, Zeitraum vs. Zeitraum) |
Tool | Beschreibung |
| Durchsucht die aktiven Anzeigen eines beliebigen Werbetreibenden – öffentliche Transparenz-API |
| Prüft dein Token: Typ, Gültigkeit, Ablauf, Berechtigungen, zugehörige App und Benutzer |
| Prüft die Servergesundheit: Token-Status, zwischengespeicherte Tokens, API-Konnektivität |
| Sucht Facebook-Ortsdienste (Standorte) nach Name oder Koordinaten für Beitrags-Tagging |
Variable | Erforderlich | Standard | Beschreibung |
| Ja | Kein | Langlebiges Meta-Graph-API-Token für Facebook-Seiten, Instagram, Ads Manager, Commerce, Conversions-API, Audiences, Insights und Dienstprogramme |
| Nein | Kein | Threads-API-Token. Nur für die Threads-Publishing-, Replies- und Insights-Tools erforderlich. |
Öffne developers.facebook.com → Meine Apps → App erstellen → wähle den Typ Business. Füge Facebook Login, Pages API, Instagram Graph API und Marketing API hinzu.
{
"mcpServers": {
"meta": {
"command": "npx",
"args": ["-y", "@oliverames/meta-mcp-server"],
"env": {
"META_ACCESS_TOKEN": "your_token_here"
}
}
}
}{
"mcpServers": {
"meta": {
"command": "npx",
"args": ["-y", "@oliverames/meta-mcp-server"],
"env": {
"META_ACCESS_TOKEN": "your_token_here"
}
}
}
}Hole dir ein Token im Graph-API-Explorer und tausche es dann gegen ein langlebiges Token (60 Tage) ein:
curl "https://graph.facebook.com/oauth/access_token?\
grant_type=fb_exchange_token&\
client_id=YOUR_APP_ID&\
client_secret=YOUR_APP_SECRET&\
fb_exchange_token=SHORT_LIVED_TOKEN"Für dauerhaften Zugriff erstelle ein Systembenutzer-Token in Business Manager → Systembenutzer.
Beiträge verwendet ein separates Token über die OAuth-Freigabe von graph.threads.net – siehe Threads-API-Dokumentatio.
Wenn META_ACCESS_TOKEN oder THREADS_ACCESS_TOKEN in der Umgebungsvariable nicht festgelegt sind, versucht der Server automatisch, sie über die 1Password-CLI zu ermitteln:
op://Development/Meta Access Token/credential
op://Development/Threads Access Token/credentialDas bedeutet: Du kannst dir Umgebungsvariablen komplett sparen, wenn op installiert ist und ein Servicekonto oder Eine Sitzung aktiv ist. Der Ausweichmechanismus fügt beim Start ~1-2 s pro Token hinzu und wird stillschweigend übersprungen, wenn 1Password nicht verfügbar ist.
Permission | Erforderlich für |
| Auflistung von Seiten |
| Seiten-Einblicke, Reaktionen |
| Erstellen, Bearbeiten, Löschen von Beiträgen |
| Seiteneinstellungen, Webhooks, Profilbild, Titelbild |
| Getaggte Beiträge, Besucherbeiträge, Bewertungen |
| Nachrichten lesen und senden, automatisierte Antworten |
| Instagram-Kontoinformationen |
| Veröffentlichen von Fotos, Reels, Storys, Karussells |
| Instagram-Analysen |
| Kommentarverwaltung |
| Instagram-Directs |
| Lesen von Kampagnen, Anzeigengruppen, Anzeigen, Insights |
| Erstellen und Verwalten von Anzeigen, A/B-Tests |
| Business-Manager-Assets, Produktkataloge |
| Produktkatalog-CRUD |
| Threads-Profil und -Beiträge |
| Veröffentlichen auf Threads |
| Threads-Analysen |
| Verwalten von Threads-Antworten |
Claude Code – - füge zu ~/.claude/settings.json hinzu:
{
"mcpServers": {
"meta": {
"command": "node",
"args": ["/absolute/path/to/meta-mcp-server/dist/index.js"],
"env": {
"META_ACCESS_TOKEN": "your_long_lived_token",
"THREADS_ACCESS_TOKEN": "your_threads_token"
}
}
}
}Funktioniert mit jedem MCP-Client, der den stdio-Transport unterstützt. THREADS_ACCESS_TOKEN ist optional – nur für Threads-Tools erforderlich.
Der Server startet ohne konfigurierte Tokens – keine Abstürze, kein „failed„-Status in den MCP-Einstellungen. Wenn du ein Werkzeug ohne korrekte Authentifizierung aufrufst, erhältst du eine klare Einrichtungsmeldung. Der erste Aufruf sollte immer meta_list_pages sein – dies speichert die seitenübergreifenden Zugriffstokens im Cache, die für alle Seiten- und Instagram-Operationen erforderlich sind.
Jede Fehlermeldung sagt dir, was falsch gelaufen ist, warum und wie du es beheben kannst:
Was passiert | Was du siehst |
Kein Token gesetzt | Schritt-für-Schritt-Setup-Anleitung mit Link zum Graph Explorer |
Token abgelaufen (Code 190) | Direkter Link zur Neugenerierung auf developers.facebook.com |
Fehlende Berechtigung (Code 10/200) | Nennt die genau benötigte Berechtigung und wo sie zu erteilen ist |
Rate-Limit erreicht (429) | Sagt dir, du sollst warten, und verlinkt die Rate-Limit-Dokumentation von Meta |
Page-Token fehlt | Erinnert dich, zuerst |
Netzwerk nicht erreichbar | „graph.facebook.com nicht erreichbar – prüfe deine Verbindung“ |
Langlebige Tokens laufen nach 60 Tagen ab. Verwende meta_debug_token, um den Ablaufzeitpunkt zu prüfen, und erneuere sie dann:
curl "https://graph.facebook.com/oauth/access_token?\
grant_type=fb_exchange_token&\
client_id=APP_ID&client_secret=APP_SECRET&\
fb_exchange_token=CURRENT_TOKEN"Für dauerhafte Tokens erstelle einen System User in Business Manager → System Users.
src/
├── index.ts Server entry point (stdio transport)
├── constants.ts API versions, base URLs, field constants
├── types.ts TypeScript interfaces for Meta entities
├── services/
│ ├── api.ts MetaApiClient — dual Graph + Threads API
│ └── utils.ts Error handling, formatting, shared schemas
└── tools/
├── pages.ts 52 Facebook Page tools
├── instagram.ts 37 Instagram tools
├── ads.ts 62 Ads Manager tools
├── threads.ts 22 Threads tools
├── commerce.ts 10 Commerce/Catalog tools
├── conversions.ts 2 Conversions API tools
├── audiences.ts 5 Audience tools
├── insights.ts 4 Insight tools
├── charts.ts 2 Chart generation tools
├── ad_library.ts 1 Ad Library tool
└── utility.ts 3 Utility toolsDualer API-Client – Verarbeitet sowohl graph.facebook.com/v21.0 als auch graph.threads.net/v1.0 mit separaten Basis-URLs und Tokens
Page-Token-Caching – meta_list_pages cached seitenbezogene Tokens; nachfolgende Tools schlagen sie anhand der Seiten-ID nach
Zweistufige Container-Veröffentlichung – Instagram und Threads erfordern den Ablauf Container → Publish; der Server übernimmt das automatisch, einschließlich des Abfragens der Videoverarbeitung
Parallele Karussell-Verarbeitung – Alle Karussell-Elemente werden über Promise.allSettled parallel erstellt; bei Teilfehlern wird gemeldet, welche Elemente erfolgreich waren
Strikte Zod-Schemas – Jedes Tool verwendet strikte Zod-Schemas für die typsichere Parametervalidierung
Duales Ausgabeformat – Jedes Lese-Tool unterstützt response_format: "markdown" oder "json"
Elegante Authentifizierung – Der Server startet ohne Tokens und liefert beim ersten Tool-Auftruf Setup-Anleitung, statt abzustürzen
Diagramm-Generierung – QuickChart-Integration für das Rendern von Daten als PNG-Bilder für Berichte
Zielt auf die Meta Graph API v2.1.0 und die Threads API v1.0.
API | Status |
Facebook-Pages-API | Umfassend – Beiträge, Kommentare, Messaging, Insights, Events, Medien, Stories, Reals, Live-Video, automatisierte Antworten |
Instagram-Graph-API | Umfassend – Veröffentlichung, Planung, Kommentare, DMs, Broadcast-Kanöle, Hashtags, Business Discovery, Insights |
Marketing-API | Umfassend – Kampagnen, Anziegengruppen, Anzeigen, Creativs, Zielguupen, Pixel, CAPI, A/B-Tests, Attaöhe |
Threads-API | Umfassend – Veröffentlichung (Text, Bild, Video, GIF, Karussell, Link), Antwortsteuerung, Standort, Insights |
Kommerze-API | Unterstüstzt – Produktkatalog-CRUD, Produktsets |
Conertions-API | Unterstützt – serverseitiges Event-Tracking mit Testmodus |
AD-LIBARY-API | Unterstützt – öffentliche Transparenz-Suche |
WhatsApp-Business-API | Nicht abgedeckt – separate Infrastruktur und eigener Token-Ablauf |
Verwende für die lokale Entwicklung und Contribution-Checks die folgenden Befehle:
npm install
npm test # 52 tests
npm run build # TypeScript compilation
npm run test:watch # Development modeEntwicklungskonventionen: Zod-Schemas mit .strict(), response_format als Parameter für Lese-Tools und errorResult() für Tool-Fehler mit isError: true.
Neue Connectors sollten anwendungsspezifischen Code vom gemeinsamen MCP-Einstiegspunkt isoliert halten:
Füge einen API-Client unter src/services/ hinzu, dessen Anmelde-Konfiguration über Umgebungsvariablen erfolgt.
Füge unter src/tools/ ein oder mehrere Tool-Module mit strikten Zod-Eingabeschemas hinzu.
Registersiere die Tools über src/index.ts.
Dokumentiere Setup, Berechtigungen und unterstützte Operationen in docs/ und in der README.
Ergänze vor dem Öffnen eines Pull Requestsheit- und Integrationstests.
Bewahre Anmeldedaten in Umgebungsvärriablen oder einem lokalen Secret Manager auf. Committe niemals Tokens, private Schlüssel oder Kundendaten.
Dieses Projekt ist unter der MIT-Lizenz (LICENSE ) verfügbar. Es ist für private oder kommerzielle Projekte frei nutzbar, einschließlich Veränderung, Hosting und Weiterverteilung, sofern die Lizenzhinweise beachtet werden. APIs und Dienste Dritter unterliegen weiterhin den eigenen Bedingungen, Limits und Authentifizierungsanforderungen.
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Connect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP.
60+ Meta Ads tools for AI agents: audits, campaign management, audiences and CAPI tracking.
Self-hosted MCP gateway: turn any API, database or MCP server into AI connectors — no code.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/open-work-org/open-mcp-servers'
If you have feedback or need assistance with the MCP directory API, please join our Discord server