Auf pipeit aufbauen: eigene Clients und die API

Ein gemeinsamer Vertrag für alle Clients

Dateiversand, Zielrechte, Sendegruppen, Empfängerstatus und erlaubte Folgeaktionen stammen aus dem bestehenden pipeit-Backend. Ein neuer Client sollte keine zweite Anmeldung, keine eigene Bedeutung für „zugestellt“ und keinen stillen Serverweg-Rückfall erfinden. Lokale Kryptografie, Dateizugriff und Wiederaufnahme gehören in die gemeinsamen Clientbibliotheken und deren Interoptests.

Für Automatisierung verwende zuerst die vorhandene CLI. Für einen eigenen Client ist die OpenAPI-Beschreibung der Schnittstellenvertrag. Generierte Typen, SDK-Version und Serverfähigkeiten müssen zusammenpassen.

Ein technischer Einstieg

1. Lege das Clientprofil fest: Browser, nativer Sender, dauerhafter Empfänger oder MCP-Anwendung.
2. Verwende den bestehenden Autorisierungsablauf. Native Geräte erhalten eine Browserfreigabe; Remote-MCP nutzt den dokumentierten OAuth-Flow.
3. Lies Fähigkeiten und Berechtigungen. Biete nur tatsächlich verfügbare Profile und Ziele an.
4. Bereite Aufträge mit stabilen IDs und gebundenem Empfänger vor. Erhalte Zielrevision und Route über eine Wiederaufnahme hinweg.
5. Verschlüssele Dateiblöcke lokal beziehungsweise prüfe sie am Empfänger. Das Erreichen des Bytezählers ist kein Zustellbeleg.
6. Werte verifizierte Empfangsbelege, signierte Empfängerprobleme und erlaubte nächste Schritte aus.
7. Prüfe Ausfälle, Antwortverlust, Widerruf, Neustart und Wiederaufnahme im eigenen Client. Backendtests ersetzen das nicht.

OAuth- und Dateirechte getrennt

Ein MCP-Client kann registriert sein, ohne irgendein Gerät sehen zu dürfen. Erst Zustimmung und Zielgrant erlauben die konkrete Aktion. Ein Senderecht enthält keine Rechte zur Ordnerlöschung. Ein Dateipfad in einem Chat ist kein Zugriff auf diese lokale Datei. Änderungen an Kontext oder Standardzielen benötigen eigene Rechte und ändern keinen bereits vorbereiteten Transfer.

pipeit wird in ChatGPT, Codex, Claude, Gemini und Grok als eigener MCP-Connector verbunden. MCP-Adresse, Anbieterkommandos und Toolumfang stehen in ChatGPT, Codex, Claude, Gemini und Grok verbinden.

Für einen Fehlerbericht genügen normalerweise eine synthetische Reproduktion, die Version, die Operation oder der Fehlercode und bereinigte IDs. Veröffentliche niemals Kontotokens, Dateischlüssel oder Originalnutzdaten.