Zum Hauptinhalt springen

Model Context Protocol (MCP) Integration erklärt

Erfahren Sie, wie das MCP von Agorapulse die Integration mit KI-Tools ermöglicht

Der Model Context Protocol (MCP) Connector von Agorapulse ermöglicht es Ihnen, Agorapulse mit dialogorientierten KI-Assistenten wie Claude, ChatGPT und Microsoft Copilot zu integrieren. So können Sie Ihre Social-Media-Aktivitäten direkt über diese KI-Tools verwalten.

Diese Integration erlaubt es Ihnen, auf Ihre Social-Media-Daten zuzugreifen, die Performance zu analysieren, Inhalte zu erstellen und Ihren Kalender mithilfe von Befehlen in natürlicher Sprache innerhalb der KI-Benutzeroberfläche zu verwalten.

In diesem Artikel behandeln wir folgende Themen:

Hinweis: Das MCP ist derzeit in den aktuellen Plänen verfügbar.


Teilnahmeberechtigung und Anforderungen

Der MCP-Connector steht allen Agorapulse-Nutzern zur Verfügung. Ausgenommen sind Nutzer mit einem Legacy-Plan.

Um den Connector nutzen zu können, benötigen Sie einen aktiven Plan für einen der folgenden KI-Dienste:

  • Claude: Pro, Max, Team oder Enterprise.

  • ChatGPT: Go, Plus, Pro oder Team.

  • Copilot: Copilot Studio

Sie benötigen außerdem die Rolle Admin in Ihren Claude-, ChatGPT- oder Copilot-Konten.


Verbindung von Agorapulse mit KI-Assistenten

Der Verbindungsprozess verwendet die OAuth-Authentifizierung, um auf Ihr Agorapulse-Konto zuzugreifen. Sie müssen die Berechtigungen überprüfen, bevor Sie die Verbindung autorisieren.

Verbindung zu ChatGPT herstellen

Sie müssen Eigentümer des ChatGPT-Kontos sein, um eine Verbindung herzustellen. Als Kontoinhaber müssen Sie Folgendes tun:

  1. Gehen Sie zu chatgpt.com und melden Sie sich in Ihrem Konto an

  2. Navigieren Sie zum Bereich Connectors:

    • Für ChatGPT Business: Gehen Sie zu Arbeitsbereich und dann Apps

    • Für ChatGPT Plus oder Pro: Gehen Sie zu Einstellungen und dann Apps

  3. Aktivieren Sie unter Erweiterte Einstellungen den Developer Mode

  4. Wählen Sie zurück auf der Seite Connectors die Option benutzerdefinierte Connectoren aus und fügen Sie die folgenden Details hinzu:

  5. Sie werden aufgefordert, die Verbindung zu autorisieren, indem Sie sich in Ihrem Agorapulse-Konto anmelden

  6. Überprüfen Sie die Berechtigungen und ermächtigen Sie ChatGPT zum Zugriff auf Ihre Agorapulse-Daten.

Ihr Agorapulse-Konto ist nun mit ChatGPT verbunden, und Sie können Ihren benutzerdefinierten MCP-Connector in Ihren Konversationen verwenden.

Verbindung zu Claude herstellen

Sie müssen Eigentümer des Claude-Kontos sein, um eine Verbindung herzustellen. Als Kontoinhaber können Sie sich mit dem MCP von Agorapulse verbinden, indem Sie im Verzeichnis von Claude unter Connectors nach Agorapulse suchen oder Agorapulse als benutzerdefinierten Connector hinzufügen.

Um Agorapulse aus dem Verzeichnis von Claude hinzuzufügen, müssen Sie Folgendes tun:

  1. Gehen Sie zu claude.ai und melden Sie sich in Ihrem Konto an

  2. Klicken Sie in der unteren linken Ecke auf Ihr Profilbild

  3. Wählen Sie Einstellungen aus und klicken Sie auf Connectors

  4. Klicken Sie oben im Fenster auf Entdecken

  5. Geben Sie in der Suchleiste Agorapulse ein

  6. Klicken Sie auf Verbinden

  7. Wenn Sie nicht bei Agorapulse angemeldet sind, werden Sie aufgefordert, sich anzumelden. Klicken Sie nach der Anmeldung auf Authorisieren

Nach der Autorisierung der Verbindung werden Sie zu Claude zurückgeleitet, wo Agorapulse nun in Ihrer Liste der Connectors angezeigt wird.

Um Agorapulse als benutzerdefinierten Connector hinzuzufügen, müssen Sie Folgendes tun:

  1. Gehen Sie zu claude.ai und melden Sie sich in Ihrem Konto an

  2. Klicken Sie in der unteren linken Ecke auf Ihr Profilbild

  3. Wählen Sie Einstellungen aus

  4. Klicken Sie auf Connectors und wählen Sie Connector hinzufügen aus

  5. Sie müssen Folgendes angeben:

  6. Als Nächstes müssen Sie entscheiden, wer diesen Connector verwenden darf:

    • Alle Mitglieder

    • Bestimmte Teams

    • Manuelle Genehmigung

  7. Nach der Konfiguration sollten Sie Folgendes beachten:

    • Der MCP-Server antwortet korrekt.

    • Die Authentifizierung (falls erforderlich) funktioniert ordnungsgemäß.

    • Der Connector liefert die erwarteten Daten.

Sobald die Verbindung hergestellt ist, können Sie Agorapulse-Befehle direkt in Ihren Gesprächen mit Claude verwenden.

Verbindung zu Copilot herstellen

  1. Melden Sie sich bei Microsoft Copilot Studio unter copilotstudio.microsoft.com an

  2. Navigieren Sie zu Ihrem Agenten und wählen Sie die Registerkarte Tools aus

  3. Klicken Sie auf Tool hinzufügen und anschließend auf Neues Tool

  4. Wählen Sie in den Optionen Model Context Protocol aus

  5. Geben Sie die erforderlichen Informationen ein:

    • Servername: Agorapulse (oder Ihr bevorzugter Name)

    • Serverbeschreibung: Zugriff auf die Social-Media-Management-Funktionen von Agorapulse

    • Server-URL: https://api.openmcp.agorapulse.com/mcp

  6. Wählen Sie den Authentifizierungstyp:

    • Für OAuth-Authentifizierung: Wählen Sie OAuth 2.0 und folgen Sie den Schritten für die dynamische Erkennung oder die manuelle Konfiguration.

  7. Klicken Sie auf Erstellen, um den Server hinzuzufügen.

  8. Wenn Sie dazu aufgefordert werden, autorisieren Sie die Verbindung, indem Sie sich bei Ihrem Agorapulse-Konto anmelden.

  9. Überprüfen Sie die Berechtigungen und autorisieren Sie Copilot Studio für den Zugriff auf Ihre Agorapulse-Daten.

Nach erfolgreicher Verbindung wird der Agorapulse MCP-Server als Tool auf der Registerkarte „Tools“ Ihres Agenten angezeigt. Alle MCP-Tools und -Ressourcen von Agorapulse stehen Ihrem Agenten automatisch zur Verfügung.


Ihre Verbindung verwalten

Jedes Teammitglied kann sich über seinen eigenen Nutzer unabhängig mit Agorapulse verbinden. Jede Verbindung ist persönlich und sicher. Sie können die Verbindung jederzeit in Ihren Claude- oder ChatGPT-Einstellungen trennen.

In ChatGPT

Um Ihren Agorapulse-Connector in ChatGPT zu trennen:

  1. Navigieren Sie zum Bereich Connectors:

    • Für ChatGPT Business: Gehen Sie zu Arbeitsbereich und dann Apps

    • Für ChatGPT Plus oder Pro: Gehen Sie zu Einstellungen und dann Apps

  2. Klicken Sie in Ihrer Liste der Connectors auf Agorapulse.

  3. Klicken Sie abschließend auf Trennen

In Claude

Um Ihren Agorapulse-Connector in Claude zu trennen:

  1. Klicken Sie in der unteren linken Ecke auf Ihr Profilbild

  2. Wählen Sie Einstellungen aus

  3. Klicken Sie auf Connectors

  4. Klicken Sie auf die drei Punkte neben Agorapulse.

  5. Wählen Sie Trennen aus

In Copilot

So verwalten Sie Ihren Agorapulse-Connector in Copilot:

  1. Gehen Sie in Ihrem Agenten zum Tab Tools.

  2. Wählen Sie den Agorapulse MCP-Server aus der Liste aus.

  3. Deaktivieren Sie Alle erlauben, um die einzelnen Tool-Steuerelemente anzuzeigen.

  4. Aktivieren Sie mithilfe der einzelnen Schalter nur die benötigten Tools.

So löschen Sie den Connector aus Copilot:

  1. Gehen Sie in Ihrem Agenten zum Tab Tools.

  2. Wählen Sie den Agorapulse MCP-Server aus der Liste aus.

  3. Suchen Sie das Tool in der Liste und bewegen Sie den Mauszeiger über den Tool-Namen. Klicken Sie auf die drei Punkte (…).

  4. Klicken Sie auf Löschen. Ein Bestätigungsfenster wird angezeigt.

  5. Klicken Sie auf Löschen, um den Connector zu entfernen.


Verwendung des Connectors

Sobald die Verbindung hergestellt ist, können Sie mit Agorapulse in natürlicher Sprache interagieren. Der KI-Assistent ruft automatisch die passenden Agorapulse-Tools auf, um Ihre Anfrage zu bearbeiten und die Ergebnisse in einem klaren, verständlichen Gesprächsformat zu präsentieren.

Hinweis: Der MCP-Connector funktioniert mit den mobilen Apps von Claude und ChatGPT, sofern Sie einen kompatiblen Plan haben. Der Connector ist auch kompatibel mit Claude Desktop, Web und Mobilgeräten.

Funktionen des MCP-Connectors

Hinweis: Die vom MCP zurückgegebenen Informationen richten sich nach den Berechtigungen, die Ihnen in der Agorapulse-App erteilt wurden.

Der Agorapulse-MCP-Connector ermöglicht es Ihnen, mehrere zentrale Aktionen in fünf Hauptkategorien durchzuführen:

Inbox

  • Inbox-Elemente über ein oder mehrere Social-Profile hinweg lesen, neueste zuerst: organische Kommentare, Anzeigenkommentare, Reel-Kommentare, private Unterhaltungen, Erwähnungen, Story-Erwähnungen und Bewertungen für Facebook, Instagram, LinkedIn, TikTok, X (Twitter) und Threads
    ​Hinweis: Abgerufene Elemente zeigen den Moderationsverlauf und bei Kommentaren den zugehörigen Beitrag an.

  • Elemente nach Inbox-Status filtern, zum Beispiel Elemente, die noch überprüft werden müssen

  • Elemente filtern, die noch auf Genehmigung warten

  • Eine private Unterhaltung Nachricht für Nachricht mit Datumsfilterung lesen

  • Öffentlich auf ein Element antworten, oder privat auf ein öffentliches Element (Facebook, Instagram oder X), mit Kontrolle darüber, wer auf X erwähnt wird

Hinweis: Antworten folgen den Inbox-Genehmigungsworkflows. Wenn ein aktiver Workflow das Profil und Ihren Nutzer abdeckt, wird die Antwort zur Genehmigung durch einen Manager in die Warteschlange gestellt, anstatt sofort veröffentlicht zu werden. Sie können nicht auf ein Element antworten, dessen Antwort bereits auf Genehmigung wartet. Ihr KI-Agent bittet Sie, eine Antwort zu bestätigen, bevor er sie sendet.

Listening

  • Die von einer Listening-Suche abgerufenen Elemente lesen, neueste zuerst. Social-Beiträge und -Kommentare sowie Nachrichtenartikel, Blogbeiträge und Forenbeiträge

  • Nach Suche, Veröffentlichungszeitraum, Quelle (Facebook, Instagram, X, LinkedIn, TikTok, YouTube, Reddit, Web-News, Blogs und Foren) und Sentiment filtern
    ​Hinweis: Wenn kein Datumsbereich festgelegt ist, werden die letzten sieben Tage abgerufen.

  • Listening-Kennzahlen anzeigen: Volumen, Engagement, Sentiment und Word Clouds, für Standard- und Wettbewerbssuchen

Veröffentlichung und Inhaltsmanagement

  • Beitragsentwürfe für Ihre Social-Media-Profile erstellen. Bilder und Videos, die Sie Ihren Beiträgen hinzufügen, müssen als öffentliche URLs geteilt werden
    ​Hinweis: Für jedes Profil wird ein eigener Entwurf erstellt. Um auf drei Netzwerken zu veröffentlichen, erstellt Ihr KI-Agent drei Entwürfe

  • Kalendernotizen suchen und erstellen

Hinweis: Netzwerkspezifische Optionen (erster Kommentar, Threads, Pinterest-Board, Google-Business-Events) werden über das MCP nicht unterstützt.

Analysen und Insights

  • Erhalten Sie demografische Daten und Einblicke in die Follower Ihrer Profile.

  • Analysieren Sie die Leistungskennzahlen der Inhalte, einschließlich Engagement, Reichweite und Impressionen.

  • Verfolgen Sie die Markenperformance über mehrere Social-Media-Konten hinweg.

  • Ermitteln Sie Ihre erfolgreichsten Inhalte anhand spezifischer Kennzahlen.

  • Überwachen Sie Kennzahlen zum Community-Management, einschließlich Antworten, Nachrichten und Reaktionszeiten.

  • Analysieren Sie die Performance von Beiträgen mit bestimmten Labels.

  • Erstellen Sie jeden in Agorapulse Reports verfügbaren Bericht: Ihr KI-Agent findet die für Ihre Profile verfügbaren Kennzahlen und berechnet die gewünschte.

  • Erhalten Sie die demografischen Daten Ihrer Video-Zuschauer (Alter, Geschlecht, Land, Region, Stadt), sofern das Netzwerk sie bereitstellt.

  • Vergleichen Sie die bezahlte und die organische Performance von Beiträgen mit bestimmten Labels.

  • Analysieren Sie das Sentiment der Nachrichten, die Sie erhalten haben (positiv, negativ, neutral).

Organisationsmanagement

  • Listen Sie alle Ihre Organisationen und Arbeitsbereiche auf.

  • Greifen Sie auf Ihre verknüpften Social-Media-Profile zu.

  • Arbeitsbereichs- und Organisationseinstellungen anzeigen.

  • Listen Sie Ihre Profilgruppen auf, d. h. die Ordner, mit denen Sie Ihre Profile organisieren, zum Beispiel nach Kund:innen oder Marken.

Hinweis: Die Anzahl der verfügbaren MCP-Tools wird im Laufe der Zeit zunehmen.

Beispielhafte Eingabeaufforderungen/ Prompts

Sobald der KI-Assistent verbunden ist, können Sie mit Agorapulse in natürlicher Sprache interagieren. Der KI-Assistent ruft automatisch die passenden Agorapulse-Tools auf, um Ihre Anfrage zu bearbeiten und die Ergebnisse in einem verständlichen, dialogorientierten Format darzustellen.

Die Tabellen in den Dropdown-Menüs unten zeigen einige Beispiel-Prompts, die Sie verwenden können:

Organisationsmanagement

Beispielaufforderung

„Auf welche Organisationen und Arbeitsbereiche habe ich Zugriff und wie viele Profile sind jeweils damit verbunden?“

„Ordne alle meine verbundenen Social-Media-Profile regionalen Gruppen zu.“

„Liste meine Profilgruppen und die Profile in jeder Gruppe auf, damit ich sehe, wie meine Kund:innen oder Marken organisiert sind.“

„Liste die Profile in meiner Gruppe [Kunde] auf und zeig mir dann die Ergebnisse des letzten Monats für jedes einzelne.“

Analyse & Berichterstattung

Beispielaufforderung

„Vergleiche die Performance von [Kunde] in diesem Monat mit dem Vormonat. Hebe die nützlichsten Veränderungen hervor, erkläre, was die Daten belegen, und empfiehl drei Prioritäten für unser nächstes Kund:innengespräch.“

„Welche Beitragsformate und Labels haben in den letzten 90 Tagen am besten abgeschnitten? Nenne mir die Top 3 und sag mir, was ich im nächsten Monat öfter tun sollte.“

„Erstelle eine einseitige Zusammenfassung der Ergebnisse dieses Quartals über alle meine Social-Media-Profile hinweg: Reichweite, Engagement, Zielgruppenwachstum und die Beiträge, die sie getragen haben. Schreib sie für eine Führungskraft, die nur zwei Minuten Zeit hat.“

„Wie schlägt sich mein Team diese Woche bei der Reaktionszeit? Zeig mir, wer am schnellsten antwortet und wo Nachrichten am längsten warten.“

Inbox

Beispielaufforderung

„Geh bitte die Inbox dieser Woche für alle meine Profile durch. Sag mir, was heute beantwortet werden muss, was eine Beschwerde ist und was warten kann.“

„Was fragen uns die Leute diese Woche am häufigsten? Gruppiere die Nachrichten nach Thema und zeig mir die drei Fragen, die immer wiederkommen.“

„Zeig mir die Kommentare, die noch niemand im Team überprüft hat, die ältesten zuerst, und fasse zusammen, worum es in jedem geht.“

Listening

Beispielaufforderung

„Wie wird in diesem Monat über unsere Marke gesprochen? Nenne mir die wichtigsten Themen, die Gesamtstimmung und die drei Erwähnungen mit dem meisten Engagement.“

„Vergleiche unseren Sentiment-Score mit dem von [Wettbewerber] in den letzten 30 Tagen und teile mir anschließend mit, über welche Themen er postet, wir aber nicht.“

„Welche Themen tauchen am häufigsten zusammen mit Erwähnungen von [Produkt] auf? Welche wachsen und sind einen Beitrag wert?“

„Welche Netzwerke erzeugen die meisten Gespräche zu [Thema] und wie hat sich das Volumen in den letzten zwei Monaten Woche für Woche entwickelt?“

Inhalt

Beispielaufforderung

„Erstelle auf unseren LinkedIn- und Facebook-Seiten einen Entwurf aus dieser Ankündigung. [Text einfügen]. Passe den Ton an das jeweilige Netzwerk an.“

„Sieh dir an, was im letzten Monat am besten funktioniert hat, und entwirf dann einen Beitrag zu [Thema] für unsere [Netzwerk]-Seite im gleichen Stil.“

„Füge am [Datum] eine Kalendernotiz hinzu, die das Team daran erinnert, die Assets für [Kampagne] vorzubereiten, und liste außerdem die Notizen auf, die wir in dieser Woche bereits haben.“

Einschränkungen

Der MCP-Connector kann Beitragsentwürfe erstellen, aber er veröffentlicht oder plant keine Inhalte. Entwürfe werden nie automatisch veröffentlicht: Überprüfen, planen und veröffentlichen Sie sie in Agorapulse.


Sicherheit und Datenschutz

Die Verbindung verwendet OAuth. Das bedeutet, dass Sie sich mit Ihrem eigenen Agorapulse-Konto anmelden und niemals einen API-Schlüssel teilen. Ihr KI-Agent sieht genau das, was Ihr Nutzer in Agorapulse sehen kann, mit Ihrer Rolle und Ihren Berechtigungen. Sie können die Verbindung jederzeit in den Einstellungen Ihres KI-Agenten trennen.

Der MCP-Connector speichert keine Daten dauerhaft; er ruft Daten nur ab, wenn Sie eine Anfrage stellen. Wie Ihr KI-Anbieter (Anthropic, OpenAI oder Microsoft) die in Ihren Konversationen geteilten Daten verarbeitet, hängt von Ihren Einstellungen und Ihrer Vereinbarung mit diesem Anbieter ab.


MCP-Connector – Häufig gestellte Fragen

In diesem Abschnitt behandeln wir die Fragen, die bei der Fehlersuche im Zusammenhang mit dem Model Context Protocol Connector hilfreich sind.

Kann ich sehen, welche KI-Agenten sich mit Agorapulse verbinden lassen?

Die aktuell unterstützten KI-Agenten können Sie in Agorapulse wie folgt einsehen:

  1. Klicken Sie auf Ihren Avatar und wählen Sie Persönliche Einstellungen

  2. Wählen Sie das Untermenü Connectors

  3. Unter KI-Agenten, die auf Ihr Konto zugreifen können, sehen Sie die KI-Agenten, die derzeit von Agorapulse unterstützt werden

  4. Klicken Sie auf Verbinden unter dem gewünschten KI-Agenten

  5. Auf der nächsten Seite sehen Sie zwei Bereiche:

    • MCP-Client konfigurieren: In diesem Bereich können Sie die MCP-Server-URL kopieren, mit der Sie Ihren KI-Agenten mit dem MCP von Agorapulse verbinden können

    • Prompts zum Ausprobieren: Kopieren Sie diese Prompts, um den Einstieg in unser MCP zu erleichtern

Warum werden meine Daten im Connector nicht angezeigt?

Falls der MCP-Connector Ihre Daten nicht anzeigt, stellen Sie sicher, dass die folgenden Bedingungen erfüllt sind:

  • Sie sind im richtigen Agorapulse-Konto angemeldet.

  • Sie verfügen über die erforderlichen Berechtigungen in Agorapulse, um auf die von Ihnen angeforderten Daten zuzugreifen.

  • Ihr Agorapulse-Plan ist aktiv

Warum schlägt die Verbindung während der Autorisierung fehl?

Falls die Verbindung während der Autorisierung fehlschlägt, versuchen Sie Folgendes:

  • Löschen Sie den Browser-Cache und die Cookies.

  • Bitte stellen Sie sicher, dass Sie einen unterstützten Browser verwenden (Chrome, Firefox, Safari oder Edge).

  • Prüfen Sie, ob Pop-ups nicht blockiert sind für claude.ai oder chatgpt.com.

  • Versuchen Sie, die Integration zu trennen und anschließend wieder zu verbinden.

Was sind „Zugriff verweigert“-Fehler?

Wenn Sie Fehlermeldungen der Art „Zugriff verweigert“ sehen, deutet dies in der Regel darauf hin, dass Sie nicht die richtige Rolle in Agorapulse besitzen. Fragen Sie bei Ihrem Organisationsinhaber oder Manager nach, um sicherzustellen, dass Sie über die entsprechenden Berechtigungen verfügen.

Warum erhalte ich einen 502-Fehler bei der Verwendung von „get_labeled_post_performance“?

Der Endpoint get_labeled_post_performance benötigt den exakten Namen des Labels und der Zeitraum muss klar definiert sein („Since -> Until“).

Beispiel:
​Nutze Agorapulse, get_labeled_post_performance für:

Organisation: (Name der Organisation)
Profil: Soziales Netzwerk_Profilnummer (Die Profilnummer findest du in der Agorapulse-URL, wenn du deine Berichte oder den Profilnamen aufrufst). Beispiel: facebook_644340

​Label: Name des Labels
Zeitraum: since **** until ***** (z. B. since 2026-01-01 until 2026-06-26)

Warum bittet mein KI-Agent um Erlaubnis, bevor er meine Organisationen oder Profile auflistet?

Einige KI-Agenten bitten um eine Bestätigung, bevor sie bestimmte Tools verwenden. Die Tools, die Ihre Organisationen, Arbeitsbereiche, Profile und Gruppen auflisten, lesen nur Daten und ändern nichts in Ihrem Konto. Sie können sie genehmigen oder in den Einstellungen Ihres KI-Agenten dauerhaft zulassen.

Gibt es ein Nutzungslimit?

Ja: bis zu 1.000 Anfragen alle 30 Minuten. Wenn Sie dieses Nutzungslimit erreichen, warten Sie einige Minuten, bevor Sie es erneut versuchen.

Hat dies deine Frage beantwortet?