Nova Poshta mit Gemini verbinden — über MCP

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

Nova Poshta + Gemini

Nova Poshta (Нова Пошта), der ukrainische Paketdienst: bis zu 100 Frachtbriefe auf einmal verfolgen, Städte und Filialen oder Paketautomaten finden, Lieferpreis und Liefertermin berechnen und deine eigenen Sendungen auflisten. Sendungsverfolgung und Suche funktionieren ohne API-Key.

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:

(none — public API)

Schritt 1 — Zugangsdaten holen

1. Sendungsverfolgung, die Suche nach Städten und Filialen sowie die Berechnung von Preis und Liefertermin funktionieren ohne Key: Es gibt nichts einzurichten.
2. Nur nova_poshta_list_shipments (deine eigenen Frachtbriefe) braucht einen Key. Öffne im Geschäftskonto von Nova Poshta unter new.novaposhta.ua Settings → Security, klicke auf Create key, akzeptiere die API-Bedingungen und trage den Key in NOVA_POSHTA_API_KEY ein. Ein Key ist ein Jahr gültig; mit einem abgelaufenen Key schlägt jeder Aufruf fehl, also erneuere ihn oder leere die Variable.
3. nova_poshta_track_parcels nimmt bis zu 100 Frachtbriefnummern (TTN) entgegen. Gib die Telefonnummer des Absenders oder Empfängers mit, um den vollständigen Datensatz zu erhalten; ohne sie bekommst du nur den Status.
4. Für Preis und Liefertermin ermittelst du die Stadt mit nova_poshta_search_settlements und übergibst ihren DeliveryCity-Wert (nicht Ref) zusammen mit einer Serviceart an nova_poshta_get_delivery_price oder nova_poshta_get_delivery_date: Warehouse (Filiale), Doors (Adresse) oder Postomat (Paketautomat).

Datumsangaben haben das Format DD.MM.YYYY, das Gewicht wird in kg und der deklarierte Wert in UAH angegeben. Nova Poshta antwortet auch dann mit HTTP 200, wenn ein Aufruf fehlschlägt, daher liest der Assistent success und errors; eine unbekannte Sendungsnummer kommt als "Номер не знайдено" (Nummer nicht gefunden) zurück. Die Texte sind auf Ukrainisch, und viele Datensätze enthalten zusätzlich ein russisches DescriptionRu.

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 Nova Poshta-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