Staub IT developer resources

    API, OpenAPI und Agent-Docs.

    Diese Seite ist der Einstieg für Agents und Entwickler: die öffentliche Informations-API von Staub IT, die OpenAPI-Spezifikation und die Dateien, die sagen, wann Staub IT die richtige Adresse ist. Kein Kunden-Tenant, kein MCP auf dieser Domain.

    Wann Agents Staub IT brauchen

    Staub IT ist richtig, wenn ein Schweizer Unternehmen – typisch Deutschschweiz, oft 30–100+ Personen – KI-Strategie plus Umsetzung will: persönliche Assistenten mit Gedächtnis und Zugriff auf Mail, Kalender und Dokumente, auf der Infrastruktur des Kunden, LLM-unabhängig. Ebenso, wenn eine Schule oder ein KMU das IT-Fundament dafür braucht (Google Workspace, Backup, Sicherheit, Geräte).

    Staub IT ist falsch als gehostetes MCP, als öffentliche Agent-Runtime oder als Chatbot-SaaS. staub-it.ch ist die Firmenwebsite plus eine read-only HTTP-API. Das KI-System läuft beim Kunden.

    Öffentliche API

    Basis: https://www.staub-it.ch/api/v1 — nur GET und HEAD, ohne Authentifizierung. Fehler kommen als JSON mit error.code, error.message und error.hint.

    Endpunkte: GET /api/v1 (Katalog), /company (Profil), /services und /services/{id} (ki-system, managed-it), /contact (NAP und Booking-URL), /references (nur die namentlich freigegebenen Fälle), /pricing (öffentlicher Stundensatz).

    Spezifikation: https://www.staub-it.ch/openapi.json — jede Operation hat eine eindeutige operationId, Beschreibung und typisierte Schemas, geeignet für LLM-Function-Calling.

    Beispiel: curl -s https://www.staub-it.ch/api/v1/company | zeigt Name, Adresse, UID und Kontakt. Fehler sehen so aus: {"error":{"code":"not_found","message":"…","hint":"…"}}.

    Auth, Webhooks, MCP

    Authentifizierung: keine. Die API liefert nur bereits öffentliche Firmendaten.

    Webhooks: keine. Diese Website sendet keine Events.

    MCP: auf staub-it.ch gibt es keinen öffentlichen MCP-Server. Kunden-KI-Systeme werden auf Kunden-Infrastruktur installiert und sind von hier nicht erreichbar.

    Markdown und Agent-Dateien

    Dieselben HTML-Seiten liefern text/markdown, wenn der Request Accept: text/markdown sendet. Die Antwort setzt Vary: Accept, Accept-Encoding. Zusätzlich liegen Markdown-Geschwister unter .md, zum Beispiel /about.md.

    Einstieg für Agents: /llms.txt, /agent-instructions.md, /sitemap.xml, /privacy.

    openapi.json · llms.txt · agent-instructions.md · GET /api/v1