Ihre Verbindungen¶

OS kennt drei Arten von Verbindungen, die Sie selbst herstellen:

Ihr eigenes Konto bei einem externen Dienst. Manche Tools der AI Toolbox arbeiten mit Ihrem eigenen Konto bei einem Dienst, etwa einem Ticketsystem. Sie verbinden dieses Konto einmal, und danach nutzen die Tools es, wenn Sie sie ausführen.
Eine KI-App, die Sie mit einer Gruppe der AI Toolbox verbinden. Eine KI-App auf Ihrem eigenen Computer, etwa Claude Code oder Cursor, kann die Tools einer Gruppe nutzen. Jede Verbindung hat einen eigenen Schlüssel.
Eine KI-App, die in OS selbst arbeitet. Eine KI-App wie Claude Code, Claude Desktop oder Cursor kann mit Ihren Rechten in Ihren Organisationen arbeiten: Mitglieder nachschlagen, einen Assistenten anlegen, eine Gruppe ändern. Sie melden sich in der App an; es gibt keinen Schlüssel.

Sie sehen und verwalten nur Ihre eigenen Verbindungen. Die ersten beiden stehen auf der Seite Meine Verbindungen und kann jeder, der die AI Toolbox nutzen darf, in einer Organisation, deren Dienst die AI Toolbox enthält. Die dritte steht auf der Seite Aus einer KI-App arbeiten und funktioniert in jeder Organisation, die KI-Apps erlaubt.

Meine Verbindungen öffnen¶

Öffnen Sie AI Toolbox und wählen Sie Meine Verbindungen in der Leiste oben. Nach der Anmeldung bei einem Dienst kommen Sie auch von selbst hierher zurück.

Unter Meine Verbindungen steht jeder Dienst, für den eines Ihrer Tools eine eigene Anmeldung verlangt, mit Verbunden oder Nicht verbunden. Steht dort Keines Ihrer Tools verlangt eine eigene Anmeldung., müssen Sie nichts verbinden.

Wählen Sie Verbinden beim Dienst.
Ihr Browser geht zur Anmeldeseite des Dienstes. Melden Sie sich an und geben Sie Ihre Zustimmung.
Sie kommen zu Meine Verbindungen zurück, mit der Meldung Mit "Name" verbunden. Haben Sie abgelehnt, sagt die Meldung, dass die Verbindung abgelehnt wurde.

Von da an arbeiten die Tools dieses Dienstes mit Ihrem Konto, wenn Sie sie in der Toolbox ausführen und wenn ein Assistent sie für Sie nutzt. Solange Sie nicht verbunden sind, sagt ein solches Tool in der Toolbox, dass Sie zuerst Ihr eigenes Konto verbinden müssen. Ein Assistent kann Ihnen dann einen Link zur Anmeldung geben; danach sehen Sie hier, ob es geklappt hat.

Verbindung trennen. Wählen Sie Verbindung trennen und bestätigen Sie. OS vergisst Ihre Anmeldung; der Dienst selbst wird nicht benachrichtigt. Wollen Sie den Zugriff auch dort entziehen, tun Sie das beim Dienst.

Steht ein Dienst wieder auf Nicht verbunden, obwohl Sie verbunden hatten, ist Ihre Anmeldung beim Dienst abgelaufen oder widerrufen. Wählen Sie erneut Verbinden.

Eine KI-App mit einer Gruppe verbinden¶

Eine KI-App verbinden Sie mit einer Gruppe der AI Toolbox. Die App bekommt die Tools dieser Gruppe, die Sie in diesem Moment nutzen dürfen. Ein Tool, das später zur Gruppe hinzukommt, bekommt die App erst mit einer neuen Verbindung.

Öffnen Sie die Gruppe in der AI Toolbox und wählen Sie KI-App verbinden in der Leiste oben.
Geben Sie einen Namen ein, an dem Sie die Verbindung erkennen, zum Beispiel Laptop, Claude Code.
Wählen Sie Gültig bis: standardmäßig in 30 Tagen, höchstens 90 Tage. Danach funktioniert die Verbindung nicht mehr, und Sie erstellen eine neue.
Wählen Sie Schlüssel erstellen.

Der Bildschirm zeigt dann, nur jetzt:

die Adresse der Verbindung;
den Schlüssel. Bewahren Sie ihn wie ein Passwort auf: Wer ihn hat, nutzt die Tools der Gruppe als Sie. OS zeigt ihn nie wieder an;
einen Befehl für Claude Code und einen Block für Cursor, mit Adresse und Schlüssel bereits ausgefüllt.

Unter Nicht in dieser Verbindung nennt der Bildschirm jedes Tool der Gruppe, das die App nicht bekommt, und warum. Ein Tool, das mit Ihrem eigenen Konto bei einem Dienst arbeitet, kann eine KI-App nicht nutzen, und ein Tool, das mehr braucht als sich selbst, etwa Wissen oder ein Modell, auch nicht. Einen mit Ihnen geteilten Datenspeicher kann die App nur lesen.

Steht dort Diese Gruppe ist noch mit keinem Toolset verknüpft, kann die Gruppe noch nicht mit einer KI-App verbunden werden. Bitten Sie einen Administrator, die Gruppe zuerst mit einem Toolset zu verknüpfen.

Claude Code¶

Kopieren Sie den Befehl unter Claude Code und führen Sie ihn in einem Terminal aus. Er sieht so aus, mit der Adresse und dem Schlüssel Ihrer Verbindung:

claude mcp add --transport http kundenservice \
    https://<adresse>/api/v1/mcp/toolsets/kundenservice \
    --header "Authorization: Bearer ack_..."

Danach zeigt claude mcp list die Verbindung, und Claude Code kann die Tools der Gruppe nutzen.

Cursor¶

Kopieren Sie den Block unter Cursor in die MCP-Datei von Cursor (.cursor/mcp.json in Ihrem Projekt, oder ~/.cursor/mcp.json für alle Ihre Projekte). Stehen dort schon Server, fügen Sie nur den Eintrag dieser Verbindung zu mcpServers hinzu:

{
  "mcpServers": {
    "kundenservice": {
      "url": "https://<adresse>/api/v1/mcp/toolsets/kundenservice",
      "headers": { "Authorization": "Bearer ack_..." }
    }
  }
}

Claude Desktop¶

Claude Desktop kann eine Verbindung mit einer Gruppe nicht nutzen: Seine eigenen Konnektoren melden sich mit OAuth an und haben kein Feld für den Schlüssel. Mit Claude Desktop arbeiten Sie aber in OS selbst.

Ein neues Geheimnis, oder die Verbindung beenden¶

Unter KI-Apps auf Meine Verbindungen steht jede KI-App, die Sie mit einer Gruppe verbunden haben, mit der Gruppe, dem Anfang des Schlüssels und dem Ablaufdatum der Verbindung.

Neues Geheimnis. Haben Sie den Schlüssel verloren, oder hat ihn vielleicht jemand anderes gesehen, wählen Sie Neues Geheimnis. Der alte Schlüssel funktioniert sofort nicht mehr; der neue wird einmal angezeigt, und die Verbindung läuft am selben Tag ab wie vorher. Tragen Sie den neuen Schlüssel in Ihre KI-App ein.
Beenden. Wählen Sie Beenden und bestätigen Sie. Die KI-App kann die Tools der Gruppe danach nicht mehr nutzen.

Wer die AI Toolbox Ihrer Organisation einrichtet, kann Ihre Verbindungen ebenfalls beenden.

Wenn Sie die Toolbox nicht mehr nutzen dürfen¶

OS beendet Ihre Verbindungen mit Gruppen von selbst, wenn Sie die AI Toolbox nicht mehr nutzen dürfen: wenn Ihre Mitgliedschaft deaktiviert oder entfernt wird, wenn Sie das Recht auf die AI Toolbox verlieren, oder wenn der Dienst der Organisation die AI Toolbox nicht mehr enthält. Werden Sie aus der Organisation entfernt, vergisst OS auch die Anmeldungen Ihrer eigenen Konten bei externen Diensten.

OS aus einer KI-App nutzen¶

Eine KI-App kann auch in OS selbst arbeiten, mit Ihren Rechten: Mitglieder nachschlagen, einen Assistenten anlegen, eine Gruppe ändern. Sie verbinden die App einmal, und sie arbeitet dann in jeder Organisation, deren Mitglied Sie sind und die KI-Apps erlaubt. Was Sie nicht dürfen, darf auch die App nicht.

Öffnen Sie die Seite Aus einer KI-App arbeiten im Menü unter Ihrem Namen, oder mit der Schaltfläche Aus einer KI-App arbeiten auf Meine Verbindungen. Beide erscheinen, sobald eine Ihrer Organisationen KI-Apps erlaubt.

Unter Wo es möglich ist sehen Sie pro Organisation, was ein Administrator gewählt hat:

Einstellung	Was die App dort kann
Aus	Nichts. So beginnt jede Organisation.
Nur lesen	Ansehen, was Sie sehen dürfen, aber nichts ändern.
Lesen und ändern	Alles, was Sie dürfen, auch einladen, ändern und löschen.

Steht jede Organisation auf Aus, sagt die Seite, dass keine Ihrer Organisationen KI-Apps erlaubt. Ein Administrator Ihrer Organisation kann es einschalten (Organisationseinstellungen).

Die App verbinden¶

Kopieren Sie unter Eine KI-App verbinden die Adresse. Soll die App nur eine Sache erledigen, wählen Sie zuerst einen Bereich, etwa Mitglieder, Gruppen, KI-Assistenten oder Einstellungen: Mit weniger Tools wählt die App besser.
Wählen Sie den Reiter Ihrer App und folgen Sie dem, was dort steht:
- Claude Code: Führen Sie den Befehl in einem Terminal aus, starten Sie Claude Code und geben Sie /mcp ein.
- Claude Desktop: Öffnen Sie in Claude Einstellungen › Konnektoren, wählen Sie Benutzerdefinierten Konnektor hinzufügen, geben Sie als Namen Artific OS und als URL die Adresse ein, und wählen Sie Verbinden.
- Cursor: Legen Sie den Block in .cursor/mcp.json Ihres Projekts ab, oder in ~/.cursor/mcp.json für alle Projekte.
- Andere App: Jede App, die MCP über HTTP mit Anmeldung (OAuth) unterstützt, kann sich mit der Adresse verbinden. Eine App, die nur einen festen Schlüssel in einem Header senden kann, kann sich nicht verbinden.
Die App öffnet Ihren Browser. Melden Sie sich wie gewohnt bei OS an und wählen Sie Zugriff geben. Den Namen der App auf dieser Seite gibt die App selbst an: Geben Sie nur Zugriff, wenn Sie die App gerade selbst gestartet haben.

Für Claude Code sieht der Befehl so aus:

claude mcp add --transport http artific-os https://<adresse>/api/v1/mcp

Was die App ändert, steht im Audit-Log der Organisation mit Ihrem Namen und dem der App. Der Anbieter der App, etwa Anthropic oder Cursor, sieht, was die App liest, genau wie das, was Sie selbst hineinkopieren.

Eine App trennen¶

Unter Verbundene Apps steht jede App, die mit Ihrem Konto in Ihren Organisationen gearbeitet hat, nach ihrem ersten Aufruf: wann Sie sie zuerst und zuletzt verwendet haben und in welchen Organisationen. Wählen Sie Trennen und bestätigen Sie. Die App kann dann ab sofort nichts mehr in Ihren Organisationen tun. Um sie wieder zu verwenden, melden Sie sich in der App erneut an.

Ein Administrator kann eine App von Ihnen ebenfalls trennen, aber nur in der Organisation, die er verwaltet; in Ihren anderen Organisationen arbeitet die App weiter.

Über die API¶

Ihre eigenen Anmeldungen: GET /api/v1/organisations/{id}/toolbox/connections zeigt sie, und POST, GET und DELETE …/toolbox/mcp-servers/{name}/authorization beginnen, lesen und vergessen eine. Ihre mit einer Gruppe verbundenen KI-Apps: POST …/toolbox/mcp-connections mit group, label und expires_at erstellt eine Verbindung und gibt den Schlüssel einmal zurück; GET …/toolbox/mcp-connections zeigt sie, POST …/mcp-connections/{id}/rotate erstellt ein neues Geheimnis und DELETE …/mcp-connections/{id} beendet eine. Die KI-Apps, die in OS arbeiten: GET /api/v1/me/mcp-clients zeigt sie und DELETE /api/v1/me/mcp-clients/{client_id} trennt eine.