So verbindest du dein Adhook-Konto über den MCP-Server mit Claude, Claude Code oder anderen KI-Assistenten. Zusätzlich erfährst du, wie du lokale Bilder und Videos von deinem Rechner in Posts verwendest.

Was ist der Adhook MCP?

Der Adhook MCP-Server verbindet KI-Assistenten wie Claude oder ChatGPT direkt mit deinem Adhook-Konto. Anschliessend kannst du im Chat unter anderem:

Social-Media-Posts erstellen, planen und bearbeiten
Themen verwalten
Post-Boostings einrichten
Reportings abrufen und analysieren
Ad-hoc Reportings erstellen (8+ Datenquellen, 50+ Segmente, 250+ Kennzahlen)

Dafür musst du die Adhook-Oberfläche nicht öffnen.

MCP steht für Model Context Protocol. Dabei handelt es sich um einen offenen Standard, über den KI-Assistenten mit externen Diensten kommunizieren können.

Voraussetzungen

Ein Adhook-Konto mit den erforderlichen Berechtigungen
Ein Client, der Remote-MCP-Connectors unterstützt, beispielsweise:
- Claude im Browser
- Claude Desktop
- Claude Code
- ChatGPT
- ein anderer MCP-fähiger KI-Assistent

Installation und Verbindung

Server-URL:

https://mcp.adhook.io/mcp

Beim ersten Verbinden meldest du dich über OAuth mit deinem Adhook-Login an. Der Zugriff ist auf deine persönlichen Adhook-Berechtigungen beschränkt.

Dein Passwort wird nicht an den KI-Assistenten weitergegeben. Du kannst die Verbindung jederzeit in Adhook oder im jeweiligen Assistenten widerrufen.

Claude im Browser oder Claude Desktop

Öffne Einstellungen → Connectors.
Wähle Custom Connector hinzufügen.
Trage folgende URL ein:
https://mcp.adhook.io/mcp
Speichere den Connector.
Klicke auf Verbinden und melde dich mit deinem Adhook-Konto an.
Der Connector Adhook erscheint anschliessend mit den verfügbaren Tools.

Claude Code im Terminal

claude mcp add --transport http adhook https://mcp.adhook.io/mcp

Beim ersten Aufruf öffnet sich der Adhook-Login im Browser.

Mit --scope user kannst du den Connector für alle Projekte des Benutzers verfügbar machen:

claude mcp add --transport http --scope user adhook https://mcp.adhook.io/mcp

ChatGPT im Browser

Öffne Einstellungen → Plugins → Erweitert.
Aktiviere den Entwicklermodus.
Wähle Plugin erstellen.
Trage folgende URL ein:
https://mcp.adhook.io/mcp
Speichere das Plugin.
Klicke auf Verbinden und melde dich mit deinem Adhook-Konto an.
Das Plugin Adhook steht anschliessend mit den verfügbaren Tools in ChatGPT zur Verfügung.

Andere KI-Assistenten

Jeder Client mit Unterstützung für Remote-MCP-Connectors kann die folgende URL als benutzerdefinierten Connector hinzufügen:

https://mcp.adhook.io/mcp

Dies ist beispielsweise auch mit ChatGPT im Developer- beziehungsweise Connector-Modus möglich. Die genauen Schritte unterscheiden sich je nach Client.

Verfügbare MCP-Tools

Konto und Brands

Tool	Zweck
`get_current_user`	Zeigt den aktuell verbundenen Adhook-Nutzer
`get_subtenants`	Listet deine Brands auf
`find_subtenant_by_name`	Findet einen Brand anhand ihres Namens
`get_users`	Listet die Nutzer in deinem Team auf

Posts

Tool	Zweck
`get_posts`	Listet oder sucht Posts. Filter sind unter anderem nach Text, Status, Marke, Zeitraum und Kanälen möglich.
`get_post_by_id`	Ruft alle Details eines einzelnen Posts ab.
`create_post`	Erstellt einen Post mit Text, Kanälen, Bildern oder Videos, Veröffentlichungszeitpunkt, Themen, Tags und Verantwortlichen. Optional kann direkt ein Boosting eingerichtet werden.
`update_post`	Bearbeitet einen bestehenden Post, beispielsweise Text, Kanäle, Termin oder Medien.
`delete_post`	Löscht einen Post. Dies ist nur bei Posts möglich, die über den MCP erstellt wurden.
`submit_post`	Reicht einen Post zur Freigabe ein oder aktiviert ihn.

Unterstützte Kanäle sind unter anderem Facebook, Instagram, LinkedIn, Pinterest, YouTube und Google Business Profile.

Medien

Tool	Zweck
`upload_media`	Übernimmt ein öffentlich erreichbares Bild oder Video anhand seiner URL in Adhook.
`create_media_upload_url`	Erstellt eine Upload-URL für eine lokale Datei.
`get_pinterest_boards`	Listet die Pinterest-Boards einer Marke auf. Dies ist für die Erstellung von Pinterest-Posts erforderlich.

Themen und Redaktionsplanung

Tool	Zweck
`get_topics`	Listet Themen beziehungsweise Kampagnen auf.
`get_topic_by_id`	Ruft die Details eines Themas ab.
`create_topic`	Erstellt ein neues Thema.
`update_topic`	Bearbeitet ein bestehendes Thema.

Werbung und Targeting

Tool	Zweck
`get_targeting_templates`	Listet die aktiven Targeting-Vorlagen einer Marke auf. Die ID der gewünschten Vorlage wird beim Boosting über `create_post` oder `update_post` verwendet.

Das Boosting wird direkt beim Erstellen oder Aktualisieren eines Posts konfiguriert. Dabei können unter anderem Budget, Kanal, Laufzeit, Platzierungen und Targeting-Vorlage definiert werden.

Reporting

Tool	Zweck
`get_reports`	Listet die vorhandenen Berichte einer Marke auf.
`get_report_widgets`	Listet die Widgets und Kennzahlen eines Berichts auf.
`get_report_widget_data`	Ruft die Daten eines einzelnen Widgets ab.
`run_headless_report`	Führt einen Bericht ad hoc für einen bestimmten Zeitraum aus. Kann auf 8+ Datenquellen, 50+ Segmente und 250+ Kennzahlen zugreifen, um individuelle Reportings für deine Bedürfnisse zu erstellen und die Daten zu liefern.

Beispielanfragen

„Zeige mir alle geplanten Posts der Marke Beispiel AG für nächste Woche.“
„Erstelle für Beispiel AG einen LinkedIn- und Instagram-Post für nächsten Freitag um 10:00 Uhr.“
„Verwende für den Post folgenden Text und die Bilder produkt-1.jpg und produkt-2.jpg.“
„Bewirb diesen Post mit 150 CHF über sieben Tage. Verwende das Ziel Engagement und die Targeting-Vorlage DACH Breit.“
„Welche Reportings gibt es für Beispiel AG?“
„Wie hat sich die Reichweite der Marke im letzten Monat entwickelt?“

Lokale Bilder und Videos verwenden

Ein Remote-Connector wie der Adhook MCP kann nicht direkt auf Dateien auf deinem Computer zugreifen. Auch ein in den Chat gezogenes Bild wird vom KI-Assistenten nicht an den Adhook MCP weitergegeben.

Für Dateien, die nur lokal vorliegen, steht deshalb eine zusätzliche Erweiterung zur Verfügung. Diese läuft auf deinem Rechner und lädt die ausgewählte Datei zu Adhook hoch.

Wichtig: Diese Funktion steht nur mit Claude Desktop und Claude Code zur Verfügung. In claude.ai im Browser und in anderen reinen Web-Clients funktioniert sie nicht. Nutze dort öffentliche zugängliche URL's für deine Post-Medien, oder lade die Dateien vorab in die Adhook Media Library hoch und verwende die Medien URL's.

1. Adhook-Connector aktualisieren

Damit dem Assistenten das Tool create_media_upload_url zur Verfügung steht, musst du den Adhook-Connector einmal trennen und erneut verbinden.

Alternativ kannst du Claude Desktop neu starten.

2. Media-Ordner anlegen

Erstelle einen Ordner, aus dem der Assistent Dateien verwenden darf.

Beispiele:

macOS: ~/AdhookMedia
Windows: C:\Users\<Name>\AdhookMedia

3. Erweiterung installieren

Claude Desktop

Lade die Erweiterung herunter:
https://media.adhook.io/adhook-local-media-0.1.0.mcpb
Öffne die heruntergeladene Datei per Doppelklick. Claude Desktop zeigt anschliessend den Installationsdialog an.
Falls nichts passiert, öffne in Claude Desktop:
Einstellungen → Extensions → Install Extension
Wähle danach die heruntergeladene Datei aus.
Wähle im Feld Media folder den in Schritt 2 erstellten Ordner aus.
Bestätige gegebenenfalls den Hinweis, dass die Erweiterung nicht verifiziert ist.
Schliesse die Installation ab. Unter Einstellungen → Extensions erscheint anschliessend Adhook Local Media Upload als aktive Erweiterung.

Node.js oder eine vergleichbare Laufzeitumgebung muss dafür nicht separat installiert sein. Alle benötigten Bestandteile sind im Paket enthalten.

Claude Code

Führe im Terminal folgenden Befehl aus:

claude mcp add adhook-media --scope user \   --env ADHOOK_MEDIA_DIR="$HOME/AdhookMedia" \   -- npx -y @adhookio/local-media-mcp

Hierfür wird Node.js 18 oder neuer benötigt.

4. Lokale Medien verwenden

Lege das gewünschte Bild oder Video direkt im konfigurierten Media-Ordner ab.
Frage den Assistenten beispielsweise:
„Welche Bilder liegen im Media-Ordner?“
Erstelle anschliessend den Post:
„Erstelle einen Adhook-Post mit produkt.jpg und folgendem Text: …“

Der Assistent lädt die Datei automatisch hoch und fügt sie dem Post hinzu.

Gut zu wissen

Die Datei muss direkt im freigegebenen Media-Ordner liegen.
Dateien in Unterordnern werden nicht berücksichtigt.
Nenne in deiner Anfrage den genauen Dateinamen.
Ein in das Chatfenster gezogenes Bild wird nicht automatisch über die Erweiterung verwendet.
Die maximale Dateigrösse beträgt 100 MB.
Um die Erweiterung zu aktualisieren, installierst du die neue .mcpb-Version auf dieselbe Weise. Sie ersetzt die bisherige Version.

Fehlerbehebung

Problem	Lösung
Der Assistent findet keine Adhook-Tools	Prüfe die Connector-Verbindung und verbinde den Adhook-Connector erneut. Starte Claude Desktop gegebenenfalls neu.
`create_media_upload_url` fehlt	Trenne den Adhook-Connector und verbinde ihn erneut.
Die Local-Media-Erweiterung zeigt „not running“ an	Starte Claude Desktop neu.
Der Upload schlägt fehl	Prüfe in den Extension-Einstellungen, ob der Pfad zum Media-Ordner korrekt ist.
Bilder oder Videos werden nicht gefunden	Prüfe, ob die Dateien direkt im Media-Ordner und nicht in einem Unterordner liegen.
Ein Post lässt sich nicht löschen	Über den MCP können nur Posts gelöscht werden, die zuvor über den MCP erstellt wurden.

Sicherheit und Datenschutz

Die Verbindung erfolgt über OAuth mit deinem Adhook-Login. Dein Passwort wird nicht an den Assistenten weitergegeben.
Der Assistent kann nur auf Daten und Aktionen zugreifen, für die dein Adhook-Nutzer berechtigt ist.
Die Local-Media-Erweiterung läuft ausschliesslich lokal.
Die Erweiterung kann nur auf Dateien im von dir ausgewählten Ordner zugreifen.
Du kannst die Verbindung jederzeit im Assistenten oder in deinen Adhook-Einstellungen widerrufen.

Verwandte Artikel

Adhook mit KI-Assistenten verbinden (MCP)