Je verbindingen¶

OS kent drie soorten verbindingen die je zelf maakt:

Je eigen account bij een externe dienst. Sommige tools in de AI Toolbox werken met je eigen account bij een dienst, zoals een ticketsysteem. Je verbindt dat account één keer, en daarna gebruiken de tools het als jij ze uitvoert.
Een AI-app die je met een groep van de AI Toolbox verbindt. Een AI-app op je eigen computer, zoals Claude Code of Cursor, kan de tools van een groep gebruiken. Elke verbinding heeft een eigen sleutel.
Een AI-app die in OS zelf werkt. Een AI-app zoals Claude Code, Claude Desktop of Cursor kan met jouw rechten in je organisaties werken: leden opzoeken, een assistent maken, een groep wijzigen. Je logt in vanuit de app; er is geen sleutel.

Je ziet en beheert alleen je eigen verbindingen. De eerste twee staan op de pagina Mijn verbindingen en kan iedereen die de AI Toolbox mag gebruiken, in een organisatie waarvan de dienst de AI Toolbox bevat. De derde staat op de pagina Werken vanuit een AI-app en kan in elke organisatie die AI-apps toestaat.

Mijn verbindingen openen¶

Open AI Toolbox en kies Mijn verbindingen in de balk bovenaan. Na het inloggen bij een dienst kom je hier ook vanzelf terug.

Onder Mijn verbindingen staat elke dienst waarvoor een van jouw tools een eigen login vraagt, met Verbonden of Niet verbonden. Staat er Geen van je tools vraagt om een eigen login., dan hoef je niets te verbinden.

Kies Verbinden bij de dienst.
Je browser gaat naar de inlogpagina van de dienst. Log in en geef toestemming.
Je komt terug op Mijn verbindingen, met de melding Verbonden met "naam". Weigerde je, dan zegt de melding dat de verbinding is geweigerd.

Vanaf dan werken de tools van die dienst met jouw account, als je ze in de toolbox uitvoert en als een assistent ze voor jou gebruikt. Zolang je niet bent verbonden, zegt zo'n tool in de toolbox dat je eerst je eigen account moet verbinden. Een assistent kan je dan een link geven om in te loggen; daarna zie je hier of het gelukt is.

Verbinding verbreken. Kies Verbinding verbreken en bevestig. OS vergeet je login; de dienst zelf wordt niet ingelicht. Wil je de toegang ook daar intrekken, doe dat dan bij de dienst.

Staat een dienst weer op Niet verbonden terwijl je had verbonden, dan is je login bij de dienst verlopen of ingetrokken. Kies opnieuw Verbinden.

Een AI-app met een groep verbinden¶

Een AI-app verbind je met één groep van de AI Toolbox. De app krijgt de tools van die groep die jij op dat moment mag gebruiken. Een tool die later aan de groep wordt toegevoegd, krijgt de app pas met een nieuwe verbinding.

Open in de AI Toolbox de groep en kies Verbind een AI-app in de balk bovenaan.
Vul een Naam in waaraan je de verbinding herkent, bijvoorbeeld Laptop, Claude Code.
Kies Geldig tot: standaard over 30 dagen, hooguit 90 dagen. Daarna werkt de verbinding niet meer en maak je een nieuwe.
Kies Sleutel maken.

Het scherm toont daarna, alleen nu:

het Adres van de verbinding;
de Sleutel. Bewaar die als een wachtwoord: wie hem heeft, gebruikt de tools van de groep als jij. OS laat hem nooit meer zien;
een opdracht voor Claude Code en een blok voor Cursor, met het adres en de sleutel al ingevuld.

Onder Niet in deze verbinding noemt het scherm elke tool van de groep die de app niet krijgt, en waarom. Een tool die met je eigen account bij een dienst werkt, kan een AI-app niet gebruiken, en een tool die meer nodig heeft dan zichzelf, zoals kennis of een model, ook niet. Een datastore die met je gedeeld is, kan de app alleen lezen.

Staat er Deze groep is nog aan geen toolset gekoppeld, dan kan de groep nog niet met een AI-app worden verbonden. Vraag een beheerder om de groep eerst aan een toolset te koppelen.

Claude Code¶

Kopieer de opdracht onder Claude Code en voer haar uit in een terminal. Ze ziet er zo uit, met het adres en de sleutel van jouw verbinding:

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

Daarna toont claude mcp list de verbinding, en kan Claude Code de tools van de groep gebruiken.

Cursor¶

Kopieer het blok onder Cursor naar het MCP-bestand van Cursor (.cursor/mcp.json in je project, of ~/.cursor/mcp.json voor al je projecten). Staan er al servers in, voeg dan alleen de regel van deze verbinding toe aan mcpServers:

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

Claude Desktop¶

Claude Desktop kan een verbinding met een groep niet gebruiken: de eigen connectors ervan melden zich aan met OAuth en hebben geen veld voor de sleutel. Met Claude Desktop werk je wel in OS zelf.

Een nieuw geheim of de verbinding beëindigen¶

Onder AI-apps op Mijn verbindingen staat elke AI-app die je met een groep hebt verbonden, met de groep, het begin van de sleutel en wanneer de verbinding verloopt.

Nieuw geheim. Ben je de sleutel kwijt, of heeft iemand anders hem misschien gezien, kies dan Nieuw geheim. De oude sleutel werkt meteen niet meer; de nieuwe wordt één keer getoond, en de verbinding verloopt op dezelfde dag als eerst. Zet de nieuwe sleutel in je AI-app.
Beëindigen. Kies Beëindigen en bevestig. De AI-app kan de tools van de groep daarna niet meer gebruiken.

Wie de AI Toolbox van je organisatie inricht, kan ook jouw verbindingen beëindigen.

Als je de toolbox niet meer mag gebruiken¶

OS beëindigt je verbindingen met een groep vanzelf als je de AI Toolbox niet meer mag gebruiken: als je lidmaatschap wordt gedeactiveerd of verwijderd, als je het recht op de AI Toolbox verliest, of als de dienst van de organisatie de AI Toolbox niet meer bevat. Word je uit de organisatie verwijderd, dan vergeet OS ook de logins van je eigen accounts bij externe diensten.

OS gebruiken vanuit een AI-app¶

Een AI-app kan ook in OS zelf werken, met jouw rechten: leden opzoeken, een assistent maken, een groep wijzigen. Je verbindt de app één keer en ze werkt dan in elke organisatie waarvan je lid bent en die AI-apps toestaat. Wat jij niet mag, mag de app ook niet.

Open de pagina Werken vanuit een AI-app in het menu onder je naam, of met de knop Werken vanuit een AI-app op Mijn verbindingen. Beide staan er zodra een van je organisaties AI-apps toestaat.

Onder Waar het kan zie je per organisatie wat een beheerder heeft gekozen:

Stand	Wat de app daar kan
Uit	Niets. Zo begint elke organisatie.
Alleen lezen	Bekijken wat jij mag zien, maar niets wijzigen.
Lezen en wijzigen	Alles wat jij mag, ook uitnodigen, wijzigen en verwijderen.

Staat elke organisatie op Uit, dan zegt de pagina dat geen van je organisaties AI-apps toestaat. Een beheerder van je organisatie kan het aanzetten (Organisatie-instellingen).

De app verbinden¶

Kopieer onder Een AI-app verbinden het Adres. Hoeft de app maar één ding te doen, kies dan eerst een Onderdeel, zoals Leden, Groepen, AI Assistenten of Instellingen: met minder tools kiest de app beter.
Kies het tabblad van je app en volg wat daar staat:
- Claude Code: voer de opdracht uit in een terminal, start Claude Code en typ /mcp.
- Claude Desktop: open in Claude Instellingen › Connectors, kies Aangepaste connector toevoegen, vul als naam Artific OS en als URL het adres in, en kies Verbinden.
- Cursor: zet het blok in .cursor/mcp.json van je project, of in ~/.cursor/mcp.json voor al je projecten.
- Andere app: elke app die MCP over HTTP met inloggen (OAuth) ondersteunt, kan verbinden met het adres. Een app die alleen een vaste sleutel in een header kan meesturen, kan niet verbinden.
De app opent je browser. Log in bij OS zoals altijd en kies Toegang geven. De naam van de app op die pagina geeft de app zelf op: geef alleen toegang als je de app net zelf hebt gestart.

Voor Claude Code ziet de opdracht er zo uit:

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

Wat de app wijzigt, staat in het auditlog van de organisatie met jouw naam en die van de app. De aanbieder van de app, zoals Anthropic of Cursor, krijgt te zien wat de app leest, net als wat je er zelf in plakt.

Een app verbreken¶

Onder Verbonden apps staat elke app die met jouw account in je organisaties heeft gewerkt, na haar eerste aanroep: wanneer je haar eerst en laatst gebruikte en in welke organisaties. Kies Verbreken en bevestig. De app kan dan meteen niets meer in je organisaties. Wil je haar weer gebruiken, log dan opnieuw in vanuit de app.

Een beheerder kan een app van jou ook verbreken, maar alleen in de organisatie die hij beheert; in je andere organisaties blijft de app werken.

Via de API¶

Je eigen logins: GET /api/v1/organisations/{id}/toolbox/connections toont ze, en POST, GET en DELETE …/toolbox/mcp-servers/{naam}/authorization beginnen, lezen en vergeten er een. Je AI-apps met een groep: POST …/toolbox/mcp-connections met group, label en expires_at maakt een verbinding en geeft de sleutel één keer terug; GET …/toolbox/mcp-connections toont ze, POST …/mcp-connections/{id}/rotate maakt een nieuw geheim en DELETE …/mcp-connections/{id} beëindigt er een. De AI-apps die in OS werken: GET /api/v1/me/mcp-clients toont ze en DELETE /api/v1/me/mcp-clients/{client_id} verbreekt er een.