Tamara über MCP mit ChatGPT verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Tamara klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Tamara + ChatGPT

Tamara, Buy now, pay later (Saudi-Arabien, VAE, Kuwait, Bahrain, Oman): Bestellungen über deine Bestellnummer oder die Tamara-ID nachschlagen, mit Status sowie gecaptureten, erstatteten und ausgezahlten Beträgen, dazu Zahlungsarten und die Berechtigung von Kunden prüfen. Capture und Erstattung sind enthalten, aber bei der Installation deaktiviert.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

TAMARA_API_URL, TAMARA_API_TOKEN

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 2 Minuten. Du brauchst ein Tamara-Händlerkonto und dessen API-Token.

1. Melde dich im Tamara Partners Portal an und öffne API Token Management, oder nimm das API-Token, das Tamara mit deinem Händlerkonto geschickt hat. Sandbox und Produktion haben unterschiedliche Tokens.
2. Füge das Token in TAMARA_API_TOKEN ein, ohne "Bearer" und ohne Leerzeichen. Es wird als Authorization: Bearer <token> gesendet. Notification-Token und Public Key werden hier nicht verwendet.
3. Setz TAMARA_API_URL auf https://api.tamara.co für die Produktion oder https://api-sandbox.tamara.co für die Sandbox. Es muss zum Token passen.
4. Installiere den Connector und rufe tamara_list_payment_types auf: Es listet die Zahlungsarten, die dein Shop anbietet, und bestätigt das Token.

Deine Bestellnummer oder Tamaras ID: order_reference_id ist deine eigene Bestellnummer, die beim Checkout mitgeschickt wurde, etwa die Bestellnummer des Shops; order_id ist die UUID, die Tamara vergeben hat. Die meisten Fragen beginnen mit deiner Bestellnummer, also mit tamara_get_order_by_reference.

Was er liest: eine Bestellung über deine Bestellnummer oder Tamaras Bestell-ID, mit Status, Zahlungsart und Raten, Kunde, Adressen, Positionen, Gesamtbetrag, gecaptureten, erstatteten, stornierten und bezahlten Beträgen, Auszahlungsstatus und -datum sowie ihren Transaktionen (Captures, Erstattungen und Stornos); die in einem Land verfügbaren Zahlungsarten (etwa PAY_BY_INSTALMENTS oder PAY_NOW) mit Mindest- und Höchstbetrag und den möglichen Ratenzahlen, auf Wunsch nur die für einen Betrag zulässigen; vor dem Checkout, welche Zahlungsoptionen ein bestimmter Kunde für einen Betrag nutzen kann und ob Tamara einen Kunden (per Telefonnummer, E-Mail oder beidem) gerade als berechtigt ansieht; und einen registrierten Webhook mit URL, Events und Headern.

Bestellstatus: new, approved, authorised, dann partially_captured oder fully_captured und partially_refunded oder fully_refunded; canceled, declined und expired sind endgültig. paid_amount ist, was der Kunde bisher bezahlt hat; settlement_status und settlement_date zeigen, ob Tamara an dich ausgezahlt hat.

Bei der Installation deaktiviert: tamara_capture_order (captured eine autorisierte Bestellung ganz oder teilweise beim Versand, damit Tamara sie auszahlt) und tamara_refund_order (erstattet eine gecapturete Bestellung ganz oder teilweise; das Geld geht an den Kunden zurück und lässt sich nicht zurückholen). Beide bewegen Geld, deshalb schaltet ein Administrator sie bewusst ein. Auch dann zeigt dir die KI Bestellung, Betrag und Währung und wartet auf dein Ja.

Beträge und Zeiten: Beträge sind Objekte mit amount und currency; SAR und AED haben 2 Dezimalstellen, BHD, KWD und OMR 3. Zeiten sind UTC, ISO 8601.

Limits: Tamara hat keinen Endpunkt, um Bestellungen aufzulisten oder zu suchen; die KI schlägt Bestellungen deshalb über deine Bestellnummer oder Tamaras ID nach.

Häufige Fehler: 401 bedeutet ein falsches Token oder ein Token der anderen Umgebung (Sandbox oder Produktion). 404 bei einer Bestellung heißt, dass es in dieser Umgebung keine Bestellung mit dieser Referenz oder ID gibt. 400 oder 422 bei Capture oder Erstattung nennt das Feld, das Tamara abgelehnt hat, etwa einen Betrag über dem, was sich capturen lässt. 403 heißt, dass das Token funktioniert, diese API aber nicht nutzen darf; bitte Tamara, sie für dein Händlerkonto freizuschalten.

Der Connector legt keine Checkout-Sessions an, autorisiert oder storniert keine Bestellungen, nutzt nicht die Claims API und ruft keine Auszahlungsberichte ab.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in ChatGPT hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

ChatGPT fügt MCP-Server als Plugins auf seiner Seite Plugins hinzu, im Web und in den kostenpflichtigen Tarifen. Den Entwicklermodus brauchst du dafür nicht mehr. In einem Business-Workspace dürfen das nur Admins und Owner; in Enterprise und Edu kann ein Admin die Berechtigung Create plugins with MCPs vergeben.

1. Geh zu chatgpt.com/plugins, klicke auf Add und dann auf Add custom MCP server.
2. Gib einen Namen ein, z. B. Name: Tamara.
3. Trag unter Connection als Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein und lass Authentication auf OAuth.
4. Wähle I understand and want to continue und dann Create as a plugin. Wenn ChatGPT danach fragt, meldest du dich bei AnythingMCP an und erlaubst den Zugriff.
5. Installiere das neue Plugin unter deinen persönlichen Plugins, tippe dann in einem Chat @ und wähle es aus.

Verfügbare Tools

Beispiel-Prompts

• „Welchen Status hat unsere Bestellung 100245 bei Tamara, und hat Tamara sie schon an uns ausgezahlt?“
• „Wie viel von Bestellung 100245 ist bisher gecaptured, erstattet und vom Kunden bezahlt?“
• „Welche Tamara-Zahlungsarten bietet unser Shop in Saudi-Arabien für eine Bestellung über 1.200 SAR an?“
• „Kann der Kunde mit der Telefonnummer +966501234567 800 SAR mit Tamara bezahlen?“
• „Bestellung 100245 ist versendet: Capture sie vollständig. Zeig mir vorher Bestellung und Betrag.“

FAQ

Funktioniert der kostenlose ChatGPT-Tarif mit eigenen MCP-Servern? OpenAI dokumentiert eigene MCP-Server nur für kostenpflichtige Tarife; den Free-Tarif führt OpenAI nicht auf.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden