Orderful mit Gemini verbinden — über MCP

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

Orderful + Gemini

Orderful-EDI-Plattform: EDI-Transaktionen (Bestellungen, Bestätigungen, Lieferavis, Rechnungen, Bestandsmeldungen) in beide Richtungen auflisten und lesen, ihren Nachrichteninhalt lesen, eine Inbox eingehender Zustellungen abarbeiten, Zustellungen annehmen oder ablehnen, Transaktionen bestätigen, neue Transaktionen senden und Beziehungen zu Handelspartnern auflisten.

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:

ORDERFUL_API_URL, ORDERFUL_API_KEY

Schritt 1 — Zugangsdaten holen

1. Melde dich bei ui.orderful.com (USA) oder ui-eu.orderful.com (EU) an.
2. Klicke auf deinen Avatar, dann Settings → Organization Settings → API Credentials, und kopiere das API Token in ORDERFUL_API_KEY. Es wird im Header orderful-api-key gesendet.
3. Setze ORDERFUL_API_URL auf deine Region, ohne abschließenden Schrägstrich: https://api.orderful.com (USA) oder https://api-eu.orderful.com (EU). Daten werden nicht zwischen Regionen geteilt; ein US-Token funktioniert nicht auf dem EU-Host.
4. Rufe orderful_get_organization auf, um den Token zu prüfen und deine EDI-Konten (ISA-IDs) zu sehen, danach orderful_list_transactions, eingegrenzt nach direction, simplified_transaction_type (PURCHASE_ORDER, INVOICE, SHIP_NOTICE...), stream oder business_number.

Empfangen: Lies die Inbound-Poller-Inbox mit orderful_list_inbox_transactions (die Inbox-ID steht in der Orderful-Oberfläche unter Communication Channels), verarbeite jedes Dokument und rufe dann orderful_accept_delivery auf oder orderful_fail_delivery mit einer Notiz. Bei JSON-Beziehungen schickst du zusätzlich orderful_acknowledge_transaction, einmal pro Transaktion; X12- und EDIFACT-Beziehungen bestätigen stattdessen mit einer 997.

Senden: orderful_create_transaction schickt eine 850, 855, 856, 810, 846 oder 860 in Orderfuls Mosaic-JSON. Nutze stream: test, bis die Beziehung live ist: Eine live-Transaktion geht an den Handelspartner. Prüfe validationStatus im Ergebnis; INVALID-Transaktionen werden nicht zugestellt.

Paginierung: bis zu 100 Transaktionen pro Seite; für die nächste Seite übergibst du den Wert nextCursor aus metadata.pagination.links.next.

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 Gemini 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.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal) — anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Orderful-Tools aufrufen.

Verfügbare Tools

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Verbinde mit Claude
• Verbinde mit ChatGPT
• Verbinde mit Cursor
• Verbinde mit Meta Muse