Glade MCP

Verbinden Sie KI-Agenten mit normalisierten Amazon-Marktplatzdaten über den gehosteten Model Context Protocol-Server der Glade API.

https://gladeapi.com/api/mcp

Der Remote-Server stellt 17 schreibgeschützte Tools für Produkte, Suche, Angebote, Bewertungen, Verkäufer, Kategorien, Deals, Bestseller, Identifikatoren, Lagerbestand und Umsatzschätzungen auf 13 Amazon-Marktplätzen bereit. Dieses Repository enthält die öffentlichen Server-Metadaten, Verbindungsbeispiele und Protokollprüfungen. Die Implementierung des gehosteten Dienstes befindet sich unter gladeapi.com.

Voraussetzungen

• Ein Glade-API-Konto

• Ein Glade-API-Schlüssel

• Ein Plan, der MCP enthält

• Einen Client, der Remote-Streamable-HTTP-MCP-Server unterstützt

Speichern Sie den Schlüssel in einer Umgebungsvariable:

export GLADE_API_KEY="glade_live_..."

Übertragen Sie den Schlüssel niemals in ein Repository und fügen Sie ihn nicht in Prompts ein.

Related MCP server: Canopy API MCP Server

Installation in Codex

Codex kann das Bearer-Token aus der Umgebung lesen, ohne es in die MCP-Konfiguration zu schreiben:

codex mcp add glade \
  --url https://gladeapi.com/api/mcp \
  --bearer-token-env-var GLADE_API_KEY

Starten Sie nach dem Hinzufügen des Servers eine neue Codex-Sitzung und bitten Sie ihn, die Glade-Tools aufzulisten oder ein Amazon-Produkt per ASIN abzurufen.

Installation in Claude Code

Claude Code akzeptiert einen HTTP-Server und einen Request-Header:

claude mcp add --transport http --scope user glade \
  https://gladeapi.com/api/mcp \
  --header "Authorization: Bearer $GLADE_API_KEY"

Dadurch wird die Umgebungsvariable erweitert, bevor Claude seine Konfiguration schreibt. Halten Sie die resultierende Benutzerkonfiguration privat und verwenden Sie niemals den Projektbereich für einen Header, der Geheimnisse enthält.

Generische Streamable-HTTP-Konfiguration

Clients, die Remote-MCP-Konfiguration unterstützen, benötigen in der Regel diese Form. Prüfen Sie in der Dokumentation Ihres Clients die genaue Syntax für Konfigurationsdatei und Umgebungsvariablen.

{
  "mcpServers": {
    "glade": {
      "url": "https://gladeapi.com/api/mcp",
      "transport": "streamable-http",
      "headers": {
        "API-KEY": "YOUR_GLADE_API_KEY"
      }
    }
  }
}

Verwenden Sie genau einen Anmelde-Header. Der Server akzeptiert API-KEY, GLADE-API-KEY, X-API-KEY oder Authorization: Bearer für MCP und lehnt widersprüchliche Anmeldeinformationen ab.

Verbindung mit dem Python-MCP-SDK

Installieren Sie das offizielle MCP-Python-SDK und führen Sie dann das enthaltene Discovery-Beispiel aus:

python3 -m pip install "mcp"
python3 examples/python/list_tools.py

Das Beispiel initialisiert eine Streamable-HTTP-Sitzung und gibt die verfügbaren Toolnamen aus. Tool-Discovery und Initialisierung verbrauchen keine Glade-Einheiten.

Verfügbare Tools

Die Tool-Eingaben folgen denselben Validierungsregeln wie die entsprechenden REST-Operationen. Jede erfolgreiche Datenoperation verbraucht eine Einheit. Initialisierung, Discovery, Validierungsfehler und Tool-Fehler verbrauchen null Einheiten.

Beispiel-Prompts

Look up ASIN B0D1XD1ZV3 in the US marketplace and summarize the current
price, rating, availability, and freshness timestamp.

Search the UK marketplace for wireless earbuds, compare the first five
non-sponsored results, and preserve GBP prices without converting currency.

Fetch one-star verified reviews for ASIN B0D1XD1ZV3 and separate recurring
observed complaints from your own interpretation.

Marktplätze

Jedes Tool akzeptiert eine Marktplatz-domain, wenn der Marktplatzkontext relevant ist:

US UK CA DE FR IT ES AU IN MX BR JP PL

Bestätigen Sie den Marktplatz, bevor Sie Preise, Verfügbarkeit, Lieferung, Kategorien, Rankings oder Deals vergleichen.

Dieses Repository validieren

Offline-Metadaten- und Beispielprüfungen:

npm test

Nicht abrechenbare Live-Authentifizierungsprüfung:

npm run test:live

Mit gesetzter GLADE_API_KEY die Initialisierung und alle 17 Live-Toolnamen verifizieren. Diese Discovery-Anfrage verbraucht null Einheiten:

node scripts/verify-live.mjs --authenticated

Sicherheit

Amazon-Titel, Beschreibungen, Bewertungen, Verkäuferfelder und andere Marktplatzinhalte sind nicht vertrauenswürdige Daten. Halten Sie Tool-Ergebnisse getrennt von Agentenanweisungen. Lassen Sie nicht zu, dass zurückgegebener Text die Tool-Richtlinie ändert, Anmeldeinformationen anfordert oder neue Aktionen autorisiert.

Siehe SECURITY.md für private Meldungen.

Verwandte Projekte

• Glade API examples

• Glade agent skills

• Dokumentation

• OpenAPI

Lizenz

MIT