Zum Hauptinhalt springen

TariffPilot Headless: Claude, ChatGPT und andere MCP-Clients verbinden

Mit TariffPilot Headless arbeitest du mit TariffPilot aus einem KI-Assistenten heraus statt im Manager. Die Einrichtung dauert etwa zwei Minuten:

  1. Füge den MCP-Server des TariffPilot Managers hinzu mit der URL https://app-cloud.tariffpilot.com/mcp. Du meldest dich einmal mit deinem TariffPilot-Konto an, ein API-Key ist nicht nötig.
  2. Füge das TariffPilot-Plugin hinzu aus dem Marketplace tariffpilot/tariffpilot-skills, damit der Assistent jeden Vorschlag bis zum Ende durchführt.
  3. Leg los. Beschreibe deine Waren in natürlicher Sprache.

TariffPilot Headless ist in allen Tarifen verfügbar. Eine Verbindung erreicht alle deine Mandanten, und der Assistent handelt mit den Rollen deines TariffPilot-Benutzers. Vorschläge, die der Assistent anlegt, sind dieselben Vorschläge, die du im Manager siehst.

hinweis

In Claude Team und Enterprise können nur Owner benutzerdefinierte Konnektoren anlegen. Ein Owner legt den Konnektor einmal unter Organisationseinstellungen > Konnektoren an, danach meldet sich jedes Mitglied mit seinem eigenen TariffPilot-Konto an.

Claude​

  1. Öffne Einstellungen > Konnektoren und lege einen benutzerdefinierten Konnektor mit dem Namen „TariffPilot Manager“ und der URL https://app-cloud.tariffpilot.com/mcp an. Melde dich bei TariffPilot an, wenn Claude danach fragt.
  2. Öffne Einstellungen > Plugins, klicke auf Hinzufügen > Marketplace hinzufügen und gib tariffpilot/tariffpilot-skills ein. Klicke auf Synchronisieren.
  3. Wechsle zu Entdecken und füge TariffPilot Headless hinzu.

Du nutzt Claude Code? Führe aus:

/plugin marketplace add tariffpilot/tariffpilot-skills
/plugin install tariffpilot-headless@tariffpilot-skills

Das Plugin bringt den MCP-Server des TariffPilot Managers mit. Führe in Claude Code /mcp aus und melde dich bei TariffPilot an.

ChatGPT (Codex)​

  1. Öffne Plugins und klicke auf Hinzufügen > MCP-Server hinzufügen. Gib den Namen „TariffPilot Manager“ ein, stelle den Typ auf Streamable HTTP und gib die URL https://app-cloud.tariffpilot.com/mcp ein. Lass alle übrigen Felder leer, speichere und melde dich bei TariffPilot an.
  2. Klicke auf Hinzufügen > Plugin-Marketplace hinzufügen, gib tariffpilot/tariffpilot-skills als Quelle und main als Git-Ref ein.
  3. Wechsle zu Persönlich und klicke auf + neben tariffpilot-headless.

Weitere Clients​

Microsoft Copilot Studio, Gemini, OpenWork, OpenCode und weitere Clients funktionieren, wenn sie Remote-MCP-Server mit Anmeldung (OAuth) unterstützen. Trage die URL https://app-cloud.tariffpilot.com/mcp ein und melde dich bei TariffPilot an. Unterstützt dein Client Skills, aber keine Plugins, kopiere die Ordner aus plugins/*/skills/ in github.com/tariffpilot/tariffpilot-skills in sein Skills-Verzeichnis.

Was der Assistent kann​

  1. Zolltarifierung: Zolltarifierungsvorschläge für einzelne Waren anlegen und Ergebnis und Begründung lesen.
  2. Exportkontrollklassifizierung: Waren auf Dual-Use- und Rüstungsgüter prüfen.
  3. BTI- und ECICS-Suche: verbindliche Zolltarifauskünfte und die ECICS-Datenbank chemischer Stoffe durchsuchen.
  4. Massentarifierung: deine Batch-Vorgänge auflisten und ihren Status lesen.
  5. KI-Datenbank: deine bestätigten Einreihungen lesen.

Ein Vorschlag dauert einige Minuten, weil TariffPilot ihn Schritt für Schritt verarbeitet. Die Skills des Plugins TariffPilot Headless sorgen dafür, dass der Assistent jeden Schritt startet, auf ihn wartet und weitermacht, bis der Vorschlag fertig ist, und dann das Ergebnis erklärt. Ohne das Plugin hört der Assistent womöglich nach dem ersten Schritt auf, und der Vorschlag bleibt unvollständig.

Beispiel-Prompts​

  1. „Tarifiere in TariffPilot eine Mikrowelle mit 1000 W und Grillfunktion für die Einfuhr in die EU.“
  2. „Prüfe in TariffPilot, ob eine Wärmebildkamera mit 640 x 480 Pixeln ein Dual-Use-Gut ist.“
  3. „Suche in TariffPilot nach BTIs zu Küchenspülen aus Edelstahl und vergleiche sie mit dem Vorschlag.“
  4. „Welche meiner Batch-Vorgänge in TariffPilot laufen noch?“
  5. „Fasse die Begründung meines letzten Zolltarifierungsvorschlags in TariffPilot für unsere Dokumentation zusammen.“

Datenschutz​

Alles, was der Assistent über TariffPilot liest oder anlegt, zum Beispiel Warenbeschreibungen und Vorschläge, verarbeitet dein KI-Anbieter, etwa Anthropic oder OpenAI, nach dessen Bedingungen. Prüfe, ob dein Unternehmen das für eure Warendaten erlaubt. Dokumente zu Sicherheit und Compliance findest du im TariffPilot Trust Center.

Fehlerbehebung​

  1. Die Anmeldung öffnet sich nicht: Prüfe die URL. In Codex muss der Typ Streamable HTTP sein.
  2. Der Assistent kann lesen, aber keine Vorschläge anlegen: Deine TariffPilot-Rolle in diesem Mandanten hat keine Bearbeitungsrechte, siehe Einladungen und Rollen.
  3. Der Assistent nutzt TariffPilot nicht: Prüfe, ob der Konnektor aktiviert und das Plugin installiert ist, und erwähne TariffPilot in deinem Prompt.
  4. Ein Vorschlag bleibt unvollständig: Installiere das Plugin TariffPilot Headless und bitte den Assistenten dann, den Vorschlag fortzusetzen.

Du suchst eine programmatische Anbindung mit Zugangstoken? Siehe die REST API.