Claude Cowork koppelen aan uw platform

1. Wat doet de koppeling?

Claude Cowork is onze koppeling met de Claude Code-CLI van Anthropic — een commandoregeltool die u lokaal op uw eigen computer kunt installeren. U geeft Claude Cowork een opdracht — bijvoorbeeld "schrijf een procedure voor het vervangen van een drukmeter" — en Claude Cowork denkt mee en levert resultaat, met directe toegang tot uw eigen bedrijfskennis op het platform.

Standaard kent Claude Cowork alleen wat u in de opdracht zet. Door uw EigenSoftware-platform te koppelen, krijgt Claude Cowork automatisch toegang tot:

• Uw kennisitems — procedures, normen, ervaringen.
• Uw ontologie — bedrijfsspecifieke begrippen, termen en hun synoniemen.
• De mogelijkheid om nieuwe kennisitems terug te schrijven naar het platform (als concept, ter goedkeuring).

2. Voor wie is dit?

De koppeling is bedoeld voor gebruikers binnen uw organisatie die:

• Al met Claude Cowork werken voor schrijf- of analysetaken.
• Bedrijfsspecifieke termen en kennis vaak in hun prompts moeten plakken — en dat eenvoudiger willen.
• Concept-procedures of -documentatie willen laten genereren die later door een collega kan worden gecontroleerd.

U heeft geen technische voorkennis nodig. Wel moet u beheerder (admin) zijn van uw tenant binnen EigenSoftware om de koppeling aan te kunnen maken.

3. In 5 stappen verbonden

Reken op ongeveer 5 minuten van begin tot eind.

1. Log in op uw platform

   Ga naar uw EigenSoftware-platform en log in als beheerder. Open de Admin-pagina en kies daar het tabblad REST API.

2. Maak een nieuwe sleutel aan

   Klik op Nieuwe API-sleutel. Geef de sleutel een duidelijke naam, bijvoorbeeld Claude Cowork op mijn laptop.

   Kies onder Permissies wat Claude Cowork mag doen:

   • Alleen lezen — Claude Cowork kan uw kennisitems en ontologie lezen, maar niets terugschrijven.
   • Lezen + schrijven (Claude Cowork) — daarnaast mag Claude Cowork kennisitems aanmaken (altijd als concept).

   Klik op Aanmaken.

3. Kopieer de configuratie

   Direct na het aanmaken verschijnt een blokje met twee dingen:

   • De sleutel zelf (begint met ski_) — voor uw eigen administratie.
   • Een kant-en-klaar Claude Cowork-configuratieblok.

   Klik op Kopieer Claude Cowork-config. De juiste tekst staat nu op uw klembord.

   Let op: de sleutel wordt slechts één keer getoond. Sluit dit venster niet voordat u op Kopieer heeft geklikt.

4. Plak het in Claude Cowork

   Open of maak het configuratiebestand van Claude Cowork aan op uw computer. De locatie verschilt per besturingssysteem:

   🖥️ Windows

   %APPDATA%\claude-code\mcp.json

   🍎 macOS / 🐧 Linux

   ~/.config/claude-code/mcp.json

   Plak de gekopieerde configuratie in dit bestand. Het ziet er zo uit (de sleutel is een voorbeeld):

   {
     "mcpServers": {
       "eigensoftware": {
         "url": "https://platform.eigensoftware.nl/mcp",
         "headers": {
           "Authorization": "Bearer ski_xxxxxxxxxxxxxxxxx"
         }
       }
     }
   }

   Sla het bestand op.

5. Start Claude Cowork opnieuw

   Sluit Claude Cowork helemaal af en start hem opnieuw. Bij het opstarten ziet u dat de verbinding eigensoftware beschikbaar is.

   U bent klaar. Test direct met een eerste opdracht (zie hieronder).

4. Permissies: kiezen wat Claude Cowork mag

Bij het aanmaken van een sleutel kiest u één van twee voorzieningen. U kunt voor verschillende gebruikers verschillende sleutels aanmaken — de ene leesalleen, de andere mag ook schrijven.

5. Wat kunt u nu doen?

Binnen Claude Cowork kunt u nu in gewone taal verwijzen naar de gekoppelde platform-data. Een paar voorbeelden:

Uw kennisbank raadplegen

Een term classificeren tegen uw ontologie

Een nieuw kennisitem laten aanmaken (lezen + schrijven)

Claude Cowork regelt automatisch welke resources hij op het juiste moment ophaalt — u hoeft geen complexe opdrachten of code te schrijven.

6. Wat gebeurt er met wat Claude Cowork schrijft?

Alles wat Claude Cowork aan uw kennisbank toevoegt komt binnen met de status "concept" en de bron "claude-code". Het verschijnt dus niet meteen in zoekresultaten of in de zichtbare kennisbank van uw medewerkers.

De normale werkstroom is:

• Claude Cowork maakt een concept aan op basis van uw opdracht.
• U opent de kennisbank in uw platform en ziet "1 nieuw concept".
• U leest het door, past zo nodig aan, en zet de status op "goedgekeurd".
• Pas dan is het zichtbaar voor uw hele tenant.

7. Is dit veilig?

De koppeling is op meerdere niveaus afgeschermd:

• Per sleutel, per tenant. Elke sleutel hoort bij precies één tenant. Claude Cowork kan nooit data van een andere klant zien.
• Versleutelde verbinding. Het verkeer tussen uw computer en het platform loopt over HTTPS (TLS) — niemand onderweg kan meelezen.
• Schrijfacties altijd als concept. Onze server dwingt dit af, ook als Claude Cowork iets anders zou willen proberen.
• Auditspoor. Elke aanroep wordt vastgelegd in uw eigen audit-log. U ziet precies wanneer een sleutel is gebruikt.
• Intrekken in één klik. Twijfels over een sleutel? Trek hem in via Admin — verbindingen werken direct niet meer.

Voor uitgebreide details over onze beveiliging: zie de pagina Informatiebeveiliging.

8. Sleutel beheren en intrekken

In het tabblad REST API ziet u een lijst van uw sleutels. Per sleutel is zichtbaar:

• Naam — zoals u hem heeft genoemd.
• Permissies — "alleen lezen" of "lezen + schrijven".
• Aangemaakt op — wanneer u de sleutel heeft gegenereerd.
• Laatste gebruik — wanneer er voor het laatst mee is gewerkt. Handig om ongebruikte sleutels te identificeren.
• Status — actief of ingetrokken.

Een sleutel intrekken

Klik op het blokje-icoon naast de sleutel. Bevestig. Verbindingen die deze sleutel gebruiken werken vanaf dat moment niet meer. De sleutel blijft zichtbaar in de lijst voor uw eigen historie.

Een sleutel permanent verwijderen

Een ingetrokken sleutel kunt u definitief wissen via het prullenbak-icoon. Daarna is hij ook uit uw historie weg.

Aanbevolen rotatie

Goede gewoonten:

• Maak een nieuwe sleutel aan als een medewerker uit dienst gaat — trek de oude in.
• Hergebruik sleutels niet over meerdere computers. Eén sleutel per installatie.
• Roteer sleutels jaarlijks, of bij vermoeden van compromittering.

9. Veelgestelde vragen

Claude Cowork zegt dat de verbinding niet werkt — wat nu?

Drie controles in volgorde:

• Heeft u Claude Cowork daadwerkelijk volledig opnieuw opgestart na het wijzigen van het configuratiebestand?
• Klopt de URL in mcp.json precies? Geen typo's in https://...?
• Begint de sleutel met ski_? En staat hij in zijn geheel in het bestand?

Werkt het dan nog niet, controleer in Admin → REST API of de sleutel actief is en wanneer hij voor het laatst is gebruikt. Als "Laatste gebruik" leeg blijft na uw poging, komt Claude Cowork het platform niet eens binnen — meestal een netwerk- of typo-probleem.

Kan ik meerdere sleutels tegelijk hebben?

Ja. Een aparte sleutel per gebruiker of computer is zelfs aan te raden — zo ziet u in de "Laatste gebruik"-kolom welke sleutel waar in gebruik is, en kunt u één sleutel intrekken zonder de anderen te raken.

Wat als Claude Cowork een concept aanmaakt dat ik niet wil?

Geen probleem. Open de kennisbank, ga naar het concept en kies "verwijderen". Omdat de status nog concept is, heeft niemand anders het gezien.

Kan ik Claude Cowork een document laten aanpassen dat al goedgekeurd is?

Ja, met een lezen+schrijven-sleutel. Claude Cowork maakt dan een nieuwe versie aan; de oude versie blijft in de geschiedenis bewaard. De status blijft concept tot u zelf goedkeurt — zo voorkomt u dat productie-documenten ongezien wijzigen.

Werkt dit ook met andere AI-tools dan Claude Cowork?

De koppeling werkt via MCP (Model Context Protocol) — een open standaard. Iedere MCP-compatibele client kan dezelfde sleutel gebruiken. Voor nu hebben we de instructies geschreven voor Claude Cowork, omdat dat de meest verspreide implementatie is.

Wordt mijn lokale code of mijn promptgeschiedenis naar EigenSoftware gestuurd?

Nee. Het platform ziet alleen wat Claude Cowork expliciet opvraagt of opschrijft — bijvoorbeeld "geef me kennisitem X" of "sla deze tekst op als nieuw concept". Uw bestanden, prompts en lokale context blijven op uw computer.