fullmetrixDocs

MCP-Server

Verbinden Sie Claude, ChatGPT oder einen anderen kompatiblen KI-Assistenten mit Ihren Fullmetrix-Daten und fragen Sie Ihren Shop in dem Assistenten ab, den Sie bereits nutzen.

Mit dem Fullmetrix-MCP-Server kann Ihr gewohnter KI-Assistent, etwa Claude oder ChatGPT, Ihre Fullmetrix-Daten lesen. Sobald er verbunden ist, stellen Sie Ihre Fragen in Claude oder ChatGPT, zum Beispiel „Welche Produkte haben sich im September am besten verkauft?“, und der Assistent holt die Antwort aus Ihren Zahlen.

MCP steht für Model Context Protocol. Es ist ein offener Standard, der festlegt, wie sich ein KI-Assistent an eine Datenquelle anbindet. Jeder MCP-kompatible Assistent kann sich daher auf die gleiche Weise mit Fullmetrix verbinden.

Der Zugriff ist schreibgeschützt. Der Assistent kann Ihre Daten lesen, aber nichts in Fullmetrix, in Ihrem Shop oder in Ihren Werbekonten ändern.

Lieber in Fullmetrix bleiben?

Der in Fullmetrix integrierte KI-Assistent leistet dasselbe, ohne die App zu verlassen, und ergänzt Diagramme und teilbare Berichte. Der MCP-Server ist für den Fall gedacht, dass Sie in dem Assistenten arbeiten möchten, den Sie bereits nutzen.

Die Serveradresse

Jeder Client verwendet dieselbe Adresse.

https://app.fullmetrix.com/api/mcp

Der Server läuft über HTTP, in dem Modus, den MCP-Clients „Streamable HTTP“ nennen. Es gibt zwei Wege, sich zu verbinden.

  • Mit Ihrem Fullmetrix-Konto. Der Client leitet Sie auf eine Fullmetrix-Seite weiter, auf der Sie den Zugriff autorisieren. Das ist die empfohlene Methode, ganz ohne Schlüssel zum Kopieren.
  • Mit einem API-Schlüssel, für Clients, die keine Anmeldeseite öffnen können. Siehe unten.

Bevor Sie starten

Sie brauchen ein Fullmetrix-Konto mit mindestens einer Organisation, deren Shop verbunden und synchronisiert ist. Der Assistent liest die Daten Ihrer Organisationen, also müssen Daten zum Lesen vorhanden sein.

Der MCP-Zugang ist Teil Ihres Fullmetrix-Abonnements, ohne Zusatzkosten. Die Nutzung von Claude oder ChatGPT wird weiterhin von deren Herstellern entsprechend Ihrem dortigen Tarif abgerechnet.

Claude verbinden

Den Fullmetrix-Eintrag öffnen

Fullmetrix Analytics ist im Claude-Verzeichnis veröffentlicht. Öffnen Sie die Seite, oder suchen Sie in Claude im Bereich Connectoren Ihrer Einstellungen nach Fullmetrix.

Den Connector hinzufügen

Klicken Sie auf die Schaltfläche zum Hinzufügen. Claude öffnet eine Fullmetrix-Seite. Melden Sie sich bei Bedarf an und erteilen Sie die Freigabe wie im nächsten Abschnitt beschrieben.

Eine Frage stellen

Prüfen Sie in einer neuen Unterhaltung, ob der Fullmetrix-Connector aktiviert ist, und stellen Sie Ihre Frage.

Je nach Claude-Tarif kann das Hinzufügen von Connectoren auf bestimmte Abonnements oder auf die Administration Ihres Team-Workspace beschränkt sein. Die Adresse https://app.fullmetrix.com/api/mcp funktioniert weiterhin als benutzerdefinierter Connector, wenn Sie ihn lieber von Hand eintragen.

ChatGPT verbinden

ChatGPT akzeptiert MCP-Server als eigene App, auch Connector genannt.

Die Einstellungen für Apps öffnen

Öffnen Sie in ChatGPT die Einstellungen und dann den Bereich für Apps und Connectors. Je nach Tarif müssen Sie für das Hinzufügen einer eigenen App zuerst in den erweiterten Einstellungen den Entwicklermodus einschalten.

Die App erstellen

Erstellen Sie eine neue App. Nennen Sie sie Fullmetrix, fügen Sie die Adresse https://app.fullmetrix.com/api/mcp ein und wählen Sie die OAuth-Authentifizierung. Bestätigen Sie.

Den Zugriff autorisieren

ChatGPT öffnet die Fullmetrix-Seite. Melden Sie sich bei Bedarf an und autorisieren Sie dann den Zugriff.

Fullmetrix in einer Unterhaltung nutzen

Fügen Sie in einer Unterhaltung die Fullmetrix-App über das Werkzeugmenü hinzu und stellen Sie dann Ihre Frage.

Die Menüs von ChatGPT ändern sich oft. Wenn Sie die Option nicht finden, suchen Sie in der ChatGPT-Hilfe nach „custom connector“ oder „MCP“.

Einen anderen MCP-Client verbinden

Cursor, Visual Studio Code, Windsurf und die meisten MCP-kompatiblen Tools werden mit der Serveradresse eingerichtet. Deklarieren Sie in der MCP-Konfigurationsdatei Ihres Tools einen Remote-Server wie folgt.

{
  "mcpServers": {
    "fullmetrix": {
      "url": "https://app.fullmetrix.com/api/mcp"
    }
  }
}

Die genauen Schlüsselnamen können von Tool zu Tool abweichen. Lesen Sie dessen Dokumentation. Bei der ersten Nutzung öffnet das Tool die Fullmetrix-Autorisierungsseite in Ihrem Browser.

Mit einem API-Schlüssel verbinden

Wenn Ihr Client die Anmeldung mit einem Konto nicht unterstützt, verwenden Sie einen API-Schlüssel. Erstellen Sie ihn unter Einstellungen im Tab API-Schlüssel, wie unter Öffentliche API beschrieben. Tragen Sie ihn dann in den Header Authorization der Anfragen des Clients ein.

{
  "mcpServers": {
    "fullmetrix": {
      "url": "https://app.fullmetrix.com/api/mcp",
      "headers": {
        "Authorization": "Bearer fmx_YOUR_KEY"
      }
    }
  }
}

Ein Schlüssel gibt Zugriff auf genau eine Organisation, nämlich die, in der Sie ihn erstellt haben. Die Anmeldung mit dem Konto gibt Zugriff auf alle Ihre Organisationen.

Die Autorisierungsseite

Wenn sich ein Client mit Ihrem Konto verbindet, zeigt Fullmetrix die Seite Connect an external application. Sind Sie nicht bei Fullmetrix angemeldet, kommt zuerst die Anmeldeseite.

Die Seite beschreibt, was die Anwendung anfragt.

  • Read analytics data, das heißt, Ihre Shops, Kunden, Produkte, Bestellungen, Kampagnen, Kosten und die Daten verbundener Dienste ansehen.
  • Access authorized organizations. Verfügbar sind nur Organisationen, auf die Sie in Fullmetrix bereits Zugriff haben.

Ein Hinweis erinnert Sie daran, dass der Zugriff schreibgeschützt ist. Klicken Sie auf Authorize access, um zu bestätigen, oder auf Deny, um abzubrechen. Anschließend werden Sie automatisch zu Ihrem Client zurückgeführt.

Erscheint die Meldung „The authorization could not be completed. Please try again.“, starten Sie die Verbindung noch einmal von Ihrem Client aus.

Welche Organisationen verfügbar sind

Die Anmeldung mit dem Konto öffnet den Zugriff auf die Organisationen, die Sie in Fullmetrix sehen. Das sind die Organisationen Ihres Unternehmens, wenn Sie Administrator sind, und die, auf die ein Administrator Ihnen Zugriff gegeben hat. Der Assistent sieht nie eine Organisation, die Sie selbst nicht sehen können. Wie Sie diese Zugriffe verwalten, lesen Sie unter Team und Rollen.

Wenn Sie mehrere Organisationen haben, nennen Sie in Ihrer Frage den Shop oder die Organisation. Andernfalls fragt der Assistent die erste in der Liste ab.

Die bereitgestellten Werkzeuge

Ein MCP-Client entdeckt Werkzeuge, also Aktionen, die er aufrufen kann. Fullmetrix stellt drei bereit, alle schreibgeschützt.

WerkzeugWas es tut
describe_dataBeschreibt die verfügbaren Daten und die mit Ihren Organisationen verbundenen Dienste. Der Assistent ruft es vor seiner ersten Frage auf
query_dataLiest die Daten Ihres Shops in Fullmetrix, etwa Bestellungen, Bestellpositionen, Produkte, Varianten, Kategorien, Kunden, Kontakte, Warenkörbe, Gutscheincodes, Rückerstattungen, Abonnements und das Surfverhalten der Besucher. Es liest auch die Konfigurationsdaten Ihres Fullmetrix-Kontos
platform_queryFragt einen verbundenen Dienst ab, unter Google Ads, Meta Ads, TikTok Ads, ChatGPT Ads, Google Analytics 4, Search Console und Crisp. Haben Sie mehrere Konten beim selben Dienst, fragt es alle ab, sofern Sie nicht eines nennen

Sie rufen diese Werkzeuge nicht selbst auf. Sie stellen eine Frage in normaler Sprache, und der Assistent wählt die Werkzeuge und die Abfragen aus.

Die Zahlen stammen aus denselben Daten wie Ihre Berichte. Damit der Assistent genau Ihre Zahlen trifft, bitten Sie ihn, die Regeln aus Ihren Berichtseinstellungen anzuwenden, zum Beispiel stornierte Bestellungen auszuschließen.

Beispielfragen

  • Wie hoch war mein Umsatz im September, verglichen mit dem September des Vorjahres?
  • Was sind meine 10 meistverkauften Produkte in diesem Quartal, mit ihrem Umsatz?
  • Vergleiche meine Meta-Ads-Ausgaben und meine Umsätze Tag für Tag in den letzten 30 Tagen.
  • Welche Suchanfragen aus der Search Console bringen die meisten Klicks auf meine Produktseiten?
  • Fasse die Anfragen zusammen, die diese Woche bei Crisp eingegangen sind.

Den Zugriff beenden

Bei einer Verbindung über das Konto entfernen Sie den Fullmetrix-Connector in den Einstellungen Ihres Clients, ob Claude, ChatGPT oder ein anderer.

Bei einer Verbindung über einen API-Schlüssel öffnen Sie Einstellungen, Tab API-Schlüssel, und klicken neben dem Schlüssel auf Widerrufen. Der Client verliert den Zugriff sofort.

Häufig gestellte Fragen

Auf dieser Seite