Verbindung von Mergado mit KI-Agenten (ChatGPT, Claude, Cursor)#

Was ist MCP und warum es nutzen?#

MCP (Model Context Protocol) ist ein Standard, der es KI-Agenten (ChatGPT, Claude, Cursor und weiteren) ermöglicht, mit Ihren Daten und Diensten zu arbeiten. Nach der Verbindung über MCP kann der KI-Agent in Ihrem Namen in Mergado Projekte, Regeln und Statistiken lesen und gemäß Ihren Anweisungen damit arbeiten – all das direkt im Gespräch mit der KI.

Statt Daten aus Mergado manuell in die KI und zurück zu kopieren, holt sich die KI diese selbst und liefert Ihnen direkt das Ergebnis.

Mergado MCP HUB#

Über eine einzige MCP-Anbindung haben Sie die Werkzeuge von Mergado Editor und den verbundenen Erweiterungen gebündelt beisammen — Sie müssen keine mehreren separaten Verbindungen verwalten. Ändert eine Erweiterung ihre Werkzeuge oder kommen neue hinzu, spiegelt sich das automatisch wider, ohne dass Sie etwas umkonfigurieren müssen.

Aktuell ist im HUB Mergado Editor verfügbar, Erweiterungen wie Pricing Fox und Feed Image Editor kommen nach und nach hinzu. Pricing Fox hat vorerst auch eine eigene, separate MCP-Anbindung, die auch nach der Aufnahme in den HUB verfügbar bleibt — mehr auf pricing-fox.cz.

Beispiele, was Sie nach der Verbindung mit KI machen können#

• „Wie viele Produkte hat aktuell jedes meiner Projekte?"
• „Ich möchte alle Produkte sehen, die kein ausgefülltes EAN haben."
• „Starte den Feed-Audit für Projekt XY und fasse zusammen, was zu beheben ist."
• „Ich muss den Namen einer Position anpassen, damit er der Struktur entspricht: Hersteller + Positionsname + Größe + Farbe."

Was der Mergado-MCP-Server kann#

Nach der Verbindung erhält der KI-Agent Zugriff auf folgende Datenbereiche und Operationen in Mergado:

💡 Filterung nach Zeit: In Auswahlen (über die API create_project_query + query_products, sowie über das MCP-Werkzeug query_products) können Sie nach dem Alter des Produkts im Feed filtern (@@DAYS_IN_PROJECT) oder danach, wie lange sich ein Wert nicht geändert hat — @@DAYS_WITHOUT_INPUT_CHANGE (Tage seit der letzten Änderung am Eingang), @@DAYS_WITHOUT_OUTPUT_CHANGE (Tage seit der letzten Änderung am Ausgang) und @@DAYS_WITHOUT_CHANGE (Tage seit der jeweils neueren der beiden vorherigen Änderungen). Nützlich zum Beispiel, um Neuheiten im Feed oder Produkte zu erkennen, die lange niemand bearbeitet hat.

Der Umfang dessen, was die KI tun darf, richtet sich nach den Berechtigungen (Scopes) Ihres Zugangstokens oder Ihrer OAuth-Autorisierung – siehe Sicherheit. Erteilen Sie dem Token beispielsweise nur den Scope „Regeln lesen", kann die KI Regeln nur lesen, aber nicht bearbeiten oder löschen.

Eine vollständige Liste der einzelnen Berechtigungen (Scopes) finden Sie im Artikel Persönlicher Zugangstoken (PAT).

💡 Tipp für präzisere Arbeit mit KI: Die MCP-Verbindung gibt der KI Zugriff auf Ihre Daten in Mergado. Wenn Sie zusätzlich möchten, dass die KI auch Regeln, Elemente und Möglichkeiten von Mergado tief kennt – also genau weiß, welche Regeln existieren und wie man sie richtig aufbaut –, fügen Sie die Mergado Skills-Pakete hinzu:

• Mergado Skills – Context7
• Mergado Skills – GitHub

Verbindungsmöglichkeiten – Übersicht#

Es gibt zwei Wege:

TL;DR: Wenn Sie keinen Token generieren möchten, verwenden Sie Weg B – OAuth funktioniert in Clients, die dynamische Registrierung unterstützen (z. B. n8n oder Claude Desktop mit einem kostenpflichtigen Plan). Offizielle Konnektoren direkt in ChatGPT und Claude befinden sich noch in Vorbereitung.

Weg A: Verbindung über PAT#

Voraussetzungen#

1. Generierter PAT – siehe Persönlicher Zugangstoken (PAT).
2. Ausgewählte Berechtigungen (Scopes), die dem entsprechen, was Sie über die KI tun möchten. Möchten Sie z. B. nur Statistiken lesen, geben Sie dem Token nur einen Lese-Scope.
3. MCP-Client (Cursor, Claude Code, Claude Desktop, eigenes Skript).

Gemeinsame Angaben für alle Clients#

Cursor#

1. Öffnen Sie Settings → MCP.
2. Klicken Sie auf Add new MCP server.
3. Füllen Sie aus:
   • Name: Mergado
   • URL: https://mcp.mergado.com
   • Header: Authorization: Bearer mergado_pat_…
4. Speichern Sie und starten Sie Cursor neu.
5. Prüfen Sie im Chat, dass die Mergado-Tools in der Liste der verfügbaren Werkzeuge erscheinen.

Ausführliche Anleitung, wie Sie Mergado MCP an Cursor anbinden.

Claude Code (CLI)#

claude mcp add --transport http mergado https://mcp.mergado.com \
  --header "Authorization: Bearer mergado_pat_..."

Überprüfung, dass der Server verbunden ist:

claude mcp list

Claude Desktop#

Claude Desktop unterstützt aktuell keine direkte Verbindung zu Remote-MCP-Servern über HTTP – es kommuniziert nur über lokale Prozesse. Deshalb muss ein Zwischenglied mcp-remote verwendet werden, das als lokaler „Übersetzer" zwischen Claude Desktop und dem entfernten Server mcp.mergado.com funktioniert.

1. Installieren Sie Node.js#

mcp-remote läuft über Node.js, das Sie auf Ihrem Computer installiert haben müssen.

Was ist Node.js? Eine Umgebung, in der auf Ihrem Computer in JavaScript geschriebene Programme laufen. Manche Werkzeuge wie mcp-remote werden gerade als Node.js-Pakete vertrieben und lassen sich ohne Node.js nicht ausführen.

Laden Sie den Installer von nodejs.org/en/download/current herunter und wählen Sie die richtige Variante nach:

• Betriebssystem (Windows / macOS / Linux),
• Prozessorarchitektur – bei macOS müssen Sie ARM64 für Prozessoren mit Apple Silicon (M1 und neuer) wählen, oder x64 für ältere Macs mit Intel-Prozessoren.

Nach der Installation überprüfen Sie im Terminal (Eingabeaufforderung / Terminal):

node --version

Wird eine Version angezeigt (z. B. v22.x.x), war die Installation erfolgreich.

2. Bearbeiten Sie die Konfigurationsdatei von Claude Desktop#

Öffnen (oder erstellen) Sie die Datei:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Und fügen Sie folgende Konfiguration ein:

{
  "mcpServers": {
    "mergado": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.mergado.com",
        "--header",
        "Authorization: Bearer mergado_pat_..."
      ]
    }
  }
}

Fügen Sie anstelle von mergado_pat_... Ihren vollständigen PAT ein.

3. Starten Sie Claude Desktop neu#

Nach dem Neustart sollte in der Oberfläche von Claude Desktop der Mergado-MCP-Server als verfügbares Werkzeug erscheinen. Der erste Start kann ein paar Sekunden länger dauern – npx lädt beim ersten Ausführen das Paket mcp-remote herunter.

Tipp für kostenpflichtige Claude-Pläne (Pro, Max, Team, Enterprise): In Claude Desktop gibt es auch die Funktion Custom Connectors (Settings → Connectors → Add custom connector), die Remote-MCP-Server nativ ohne Node.js und mcp-remote unterstützt. Bei einem kostenpflichtigen Plan ist das der einfachere Weg.

Eigenes Skript / eigene Anwendung#

Wenn Sie einen eigenen MCP-Client schreiben oder ein SDK (TypeScript, Python) verwenden, verbinden Sie sich mit https://mcp.mergado.com und dem Header Authorization: Bearer <PAT>. Details zum MCP-Protokoll finden Sie in der offiziellen MCP-Spezifikation.

Weg B: Offizielle Mergado-MCP-App#

Der Mergado-MCP-Server unterstützt OAuth mit dynamischer Client-Registrierung – Sie müssen keinen Token generieren oder verwalten. Es genügt, die Adresse https://mcp.mergado.com in Ihrem MCP-Client anzugeben und den Anmeldebildschirm von Mergado zu bestätigen.

Wir bereiten außerdem offizielle Mergado-Konnektoren vor, die direkt im Konnektoren-Angebot von ChatGPT und Claude verfügbar sein werden. Sobald sie verfügbar sind, ergänzen wir hier die Anleitung zur Anbindung.

Im Gegensatz zu Weg A benötigen Sie nicht:

• einen persönlichen Zugangstoken (PAT) zu generieren oder zu verwalten,
• Node.js oder weitere Hilfswerkzeuge zu installieren,
• Konfigurationsdateien manuell zu bearbeiten.

Die Autorisierung erfolgt über den üblichen OAuth-Flow – genau wie bei der Anmeldung bei einem Webdienst „über Google" oder „über Facebook". Mergado fordert von Ihnen die Zustimmung zu konkreten Berechtigungen an, die Sie jederzeit im Bereich API und Zugänge entziehen können. Auf dem Anmeldebildschirm sehen Sie neu eine Übersicht der konkreten Berechtigungen (Scopes), um die die Anwendung bittet — Sie wissen also genau, was die jeweilige Verbindung in Mergado tun kann, noch bevor Sie zustimmen.

ChatGPT#

Ausführliche Anleitung, wie Sie Mergado MCP an die ChatGPT-Desktop-App anbinden.

Claude (Connectors Directory)#

Der offizielle Konnektor für Claude befindet sich noch in Vorbereitung. Sobald er verfügbar ist, ergänzen wir hier die Anleitung.

Sicherheit#

Ein mit Mergado verbundener KI-Agent führt Aktionen in Ihrem Namen aus. Wenn Sie ihm sagen „lösche alte Regeln", löscht er tatsächlich Regeln. Ein paar Regeln, wie Sie das im Griff behalten:

Prinzip der geringsten Berechtigung#

Geben Sie dem Token / der OAuth-Autorisierung nur die Scopes, die die KI tatsächlich benötigt. Möchten Sie nur Statistiken analysieren, geben Sie kein Schreibrecht. Die KI könnte dann theoretisch nichts in Mergado ändern, selbst wenn sie es wollte oder unterschobene Anweisungen erhielte.

Sicherheitsannotationen der Werkzeuge#

Werkzeuge, die in Mergado Daten ändern oder löschen, sind mit einer Sicherheitsannotation gekennzeichnet. KI-Clients, die diese Annotationen respektieren, verhalten sich bei solchen Werkzeugen vorsichtiger — typischerweise fordern sie vor der Ausführung eine Bestätigung von Ihnen an.

Weg A vs. Weg B aus Sicherheitssicht#

• Weg A (PAT): Der Token ist physisch in der Konfiguration des Clients gespeichert. Gerät die Konfigurationsdatei in falsche Hände (Git, geteilter Screenshot, gestohlener Laptop), müssen Sie den Token ungültig machen.
• Weg B (OAuth): Der Zugriff ist an einen konkreten Dienst gebunden (ChatGPT-/Claude-Konto), und Sie verwenden keinen „kopierbaren" Token. Aus Sicherheitssicht bequemer.

Überprüfen Sie regelmäßig Ihre Zugänge#

• Bei Weg A öffnen Sie in Mergado API und Zugänge und machen Sie Tokens ungültig, die Sie nicht mehr verwenden.
• Bei Weg B sehen Sie auf derselben Seite die Liste verbundener Anwendungen und können diese trennen.

Achten Sie auf Prompt Injection#

Wenn Sie einen KI-Agenten externe Inhalte (E-Mails, Webseiten, Produkttexte) verarbeiten lassen, könnte darin eine versteckte Anweisung enthalten sein, die versucht, die KI zu manipulieren. Deshalb:

• Erteilen Sie Schreibzugriff sparsam und nur dort, wo Sie ihn tatsächlich benötigen.
• Lassen Sie sich bei sensiblen Aktionen (Löschen, Massenbearbeitungen) die Absicht von der KI vor der Ausführung bestätigen.
• Überprüfen Sie nach der Arbeit der KI das Ergebnis in Mergado – was die KI getan hat, sehen Sie standardmäßig im Projekt/in den Regeln.

FAQ#

Der Token in Cursor / Claude Code funktioniert nicht, ich erhalte 401. Was tun?#

• Überprüfen Sie, dass der Header genau Authorization: Bearer mergado_pat_... lautet (das Wort Bearer mit einem Leerzeichen).
• Der Token in Mergado darf nicht ungültig gemacht sein und seine Gültigkeit darf nicht abgelaufen sein – siehe die Liste der Tokens unter API und Zugänge.
• Starten Sie in Cursor/Claude Code die Anwendung nach einer Konfigurationsänderung neu.

Die KI hat keinen Zugriff auf das, was ich brauche. Was tun?#

Der Token hat nicht den erforderlichen Scope. Erstellen Sie einen neuen Token mit erweiterten Berechtigungen (ein bestehender Token lässt sich nicht erweitern) und aktualisieren Sie ihn im MCP-Client.

Kann ich einen PAT gleichzeitig in mehreren KI-Werkzeugen verwenden?#

Technisch ja, wir empfehlen aber, für jedes Werkzeug einen eigenen Token zu erstellen. Wenn Sie dann den Zugriff aus einem Werkzeug entziehen möchten, genügt es, einen Token ungültig zu machen, die anderen bleiben funktionsfähig.

Kann ich mich über OAuth verbinden, auch wenn die offiziellen Konnektoren für ChatGPT und Claude noch nicht fertig sind?#

Ja. OAuth funktioniert in Clients, die dynamische Registrierung unterstützen, zum Beispiel n8n oder Claude Desktop mit einem kostenpflichtigen Plan. Es genügt, die URL https://mcp.mergado.com anzugeben, einen Token müssen Sie nicht generieren. Offizielle Konnektoren direkt in ChatGPT und Claude befinden sich noch in Vorbereitung.

Wird die Mergado-MCP-App kostenlos funktionieren?#

Ja. Die offizielle Mergado-MCP-App wird für alle Mergado-Nutzer kostenlos verfügbar sein. Der Betrieb eigener MCP-Clients (Weg A) ist ebenfalls kostenlos – Sie zahlen nur für das KI-Werkzeug, das Sie verwenden (ChatGPT Plus, Claude Pro usw.).

Welche KI-Modelle unterstützen das?#

Jeder MCP-kompatible Client. Aktuell bedeutet das vor allem: ChatGPT (Apps), Claude (Desktop, Code, Connectors), Cursor und eigene Implementierungen über das MCP-SDK.

Weiterführende Links#

• Persönlicher Zugangstoken (PAT) – was das ist und wie Sie ihn verwenden
• API und Zugänge – Verwaltung von PAT und verbundenen Anwendungen
• Mergado-API-Referenz: api-docs.mergado.com
• MCP-Spezifikation: modelcontextprotocol.io
• Mergado Skills – Context7 – vollständige Dokumentation der Regeln und Möglichkeiten von Mergado für KI-Assistenten
• Mergado Skills – GitHub
• mcp.mergado.com — Übersicht und Anleitungen zur Verbindung (OAuth wie PAT, ChatGPT, Claude, Cursor, VS Code und weitere) auf Tschechisch, Englisch, Slowakisch und Ungarisch