AI-assistenten koppelen (MCP)

CUTL kan binnen uw AI-assistent werken. In plaats van door de webapp te klikken, vertelt u Claude, ChatGPT, Gemini of Cursor in gewone woorden wat u wilt ("Maak een project voor Van Dijk van deze drie DXF's, 3 mm S235, 50 van elk, en geef me het totaal") en de assistent doet het voor u in CUTL: hij maakt het project aan, voegt de tekeningen toe, leest de offerte, mailt die, start de productie, nest, leest rapporten, opent STEP-modellen, offreert samenstellingen en richt uw werkplaats in.

Wat MCP is

MCP (Model Context Protocol) is de open standaard die AI-assistenten gebruiken om externe tools aan te roepen. CUTL draait een MCP-server: een set tools die uw assistent namens u kan aanroepen, met de rechten van uw rol in uw team.

Alles wat de assistent doet, gebeurt als u en verschijnt direct in CUTL als gewone projecten, onderdelen, offertes en productietaken. Wat elke tool doet, staat in Wat AI-assistenten kunnen doen.

Toolsets en hun adressen

De tools van CUTL zijn gegroepeerd in toolsets. Elke toolset heeft een eigen serveradres en wordt als aparte connector aan de assistent toegevoegd. Voeg alleen de toolsets toe die u gebruikt: een assistent kiest minder betrouwbaar uit een heel lange lijst, en een calculator die offertes maakt, heeft meestal alleen Basis nodig.

Token of aanmelding

Er zijn twee manieren om een assistent te koppelen. In beide gevallen handelt hij als u: hij kan precies lezen en wijzigen wat uw rol in CUTL u laat lezen en wijzigen, niet meer.

Het tabblad Integraties

Alles voor assistenten staat op de pagina Instellingen, tabblad Integraties. Van boven naar beneden ziet u:

1. Een AI-assistent koppelen: de Server-URL’s, elk met een knop Kopiëren; Toolset voor de voorbeelden, een keuzelijst die bepaalt welk adres de installatieteksten gebruiken (Basis staat eerst geselecteerd); per assistent een tabblad met de installatietekst en Kopiëren; de tokenwaarschuwing; een regel over gegevens en privacy; en de Muntlimieten voor assistenten.
2. De tokenlijst, met Genereer token. Daarin staan alle tokens van het team met hun label, wie ze heeft aangemaakt, wanneer ze verlopen, wanneer ze voor het laatst zijn gebruikt en hun status (Actief, Verlopen, Ingetrokken), plus een knop Intrekken.
3. Gekoppelde assistenten: de assistenten die u via aanmelding hebt gekoppeld, elk met Loskoppelen.
4. Geregistreerde clients: alleen voor teambeheerders.

Kan één blok niet worden geladen, dan wordt het gewoon weggelaten en werkt de rest van het tabblad nog.

Een token aanmaken

Het token staat alleen op deze pagina in de installatietekst, tot u de pagina verlaat of opnieuw laadt. Raakt u het kwijt, trek het dan in en maak een nieuw token aan.

Een team kan maximaal 5 actieve tokens hebben. Een zesde wordt geweigerd met "Trek eerst een ongebruikt token in: maximaal 5 actief." Elk lid kan een token aanmaken en elk token van het team intrekken. Een token handelt altijd als de persoon die het heeft aangemaakt, en werkt niet meer als die persoon het team verlaat.

Elke assistent koppelen

Het tabblad van elke assistent in Instellingen > Integraties heeft een eigen installatietekst met een knop Kopiëren. Menu's in de assistenten veranderen vaak: kijk in de actuele documentatie van de leverancier als een naam niet overeenkomt.

Claude Code (token)

Maak een token aan op het tabblad Claude Code, kopieer het commando en voer het uit in uw terminal. Het voegt een server met de naam cutl toe:

claude mcp add --transport http cutl https://api.cutl.online/mcp --header "Authorization: Bearer <token>"

Voor een andere toolset wijzigt u Toolset voor de voorbeelden, kopieert u het commando opnieuw en past u de naam cutl aan (bijvoorbeeld naar cutl-step), want twee servers kunnen niet dezelfde naam hebben. Hetzelfde token werkt voor elke toolset.

Claude Code kan zich ook aanmelden: voer het commando uit zonder het deel --header en volg de aanmeldprompt van Claude Code. CUTL toont dan de toestemmingspagina.

Cursor (token)

Maak een token aan op het tabblad Cursor en zet het blok in ~/.cursor/mcp.json (alle projecten) of in .cursor/mcp.json van één project. Heeft het bestand al een sectie "mcpServers", voeg dan alleen de vermelding "cutl" daarbinnen toe. Start daarna Cursor opnieuw of laad de MCP-servers opnieuw.

{
  "mcpServers": {
    "cutl": {
      "url": "https://api.cutl.online/mcp",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

Gemini CLI (token)

Maak een token aan op het tabblad Gemini CLI en voeg de vermelding "cutl" toe onder "mcpServers" in de settings.json van Gemini CLI. Het is hetzelfde blok als voor Cursor, met "httpUrl" in plaats van "url". Start Gemini CLI daarna opnieuw.

{
  "mcpServers": {
    "cutl": {
      "httpUrl": "https://api.cutl.online/mcp",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

Claude.ai en Claude Desktop (aanmelding)

Kopieer het adres van het tabblad Claude.ai / Desktop. Ga in Claude naar Settings, Connectors, Add custom connector en plak het. Claude opent CUTL: meld u aan als daarom wordt gevraagd, controleer de toestemmingspagina en druk op Koppelen. Er is geen token nodig. In een Claude Team- of Enterprise-organisatie voegt een eigenaar de connector toe en koppelen de leden daarna. Voor een andere toolset voegt u een extra connector toe met het adres van die toolset.

ChatGPT (aanmelding)

Alleen ChatGPT Business, Enterprise of Edu, en alleen in de webapp. Kopieer het adres van het tabblad ChatGPT, zet in ChatGPT de ontwikkelaarsmodus aan, voeg een connector met het adres toe en meld u aan bij CUTL. Er is geen token nodig. ChatGPT kan bestanden die u in de chat bijvoegt ook direct aan CUTL doorgeven.

Gemini Enterprise (aanmelding met een geregistreerde client)

1. Een teambeheerder van CUTL registreert een client (zie Geregistreerde clients) met het redirect-adres dat de beheerder van Gemini Enterprise opgeeft, en geeft de Client-ID en het Clientgeheim door.
2. De beheerder van Gemini Enterprise voegt het CUTL-adres toe als connector, met OAuth, die client-ID en dat geheim, en zet PKCE aan.
3. Een gebruiker van de connector komt op de toestemmingspagina van CUTL, die Door uw team geregistreerd toont, en drukt op Koppelen.

De toestemmingspagina

Wanneer een assistent koppelt via aanmelding, toont CUTL de pagina Een assistent koppelen (na de normale aanmelding bij CUTL als u nog niet bent aangemeld). Daarop ziet u:

• welke assistent wil koppelen;
• Na uw keuze wordt u doorgestuurd naar: het adres waarop de assistent u terug ontvangt, bijvoorbeeld claude.ai. Controleer of dit het adres van uw assistent is; is het dat niet, druk dan op Weigeren;
• Geïdentificeerd via: Een gepubliceerde clientidentiteit (de assistent heeft zijn identiteit op zijn eigen webadres gepubliceerd, zoals Claude doet), Zelfregistratie (niet geverifieerd) (CUTL kan niet instaan voor wie hem beheert) of Door uw team geregistreerd;
• Team en Aangemeld als: het team en de persoon namens wie de assistent handelt, en de Toolset;
• Het kan: "CUTL namens u gebruiken, met uw rechten" en "Gekoppeld blijven tot u het loskoppelt";
• dat de leverancier van de assistent ziet wat de assistent uit CUTL leest, zoals projectnamen, offertes en klantgegevens;
• een aftelling: het verzoek verloopt na 10 minuten.

Druk op Koppelen om het toe te staan of op Weigeren om het te weigeren; in beide gevallen gaat u terug naar de assistent. Een verzoek dat na 10 minuten, voor een tweede keer of door een andere persoon wordt geopend, meldt "Dit verzoek is verlopen of al gebruikt: start de koppeling opnieuw vanuit uw assistent."

De assistent vernieuwt zijn toegang zelf en blijft gekoppeld zolang hij CUTL minstens elke 30 dagen gebruikt. Om de koppeling direct te beëindigen, drukt u op Loskoppelen onder Gekoppelde assistenten. Als u de connector in de assistent verwijdert, eindigt de koppeling aan de kant van CUTL niet: koppel hem ook in CUTL los. Iedereen ziet alleen zijn eigen koppelingen.

Geregistreerde clients (teambeheerders)

Voor assistenten die zichzelf niet kunnen registreren, zoals Gemini Enterprise, registreert een teambeheerder een client onder Geregistreerde clients, Client registreren:

Na Registreren toont het venster Client geregistreerd de Client-ID en het Clientgeheim. Het geheim wordt maar één keer getoond en kan later niet meer worden opgevraagd: kopieer beide en druk dan op Ik heb het gekopieerd. Verwijderen verwijdert een client, en assistenten die hem gebruiken, stoppen met werken. Is het geheim kwijt, dan verwijdert u de client en registreert u een nieuwe.

Muntlimieten voor assistenten

Sommige tools besteden coins, precies zoals dezelfde actie in CUTL: een tekening aan een project toevoegen (één onderdeelberekening per onderdeel), een project kopiëren (één berekening per onderdeel) en de onderdelen van een samenstelling prijzen (één onderdeelberekening per gestart onderdeel). Alle andere tools zijn gratis. De assistent kan u de prijzen en uw saldo vertellen. Zie Coins & facturatie.

Bovenop uw saldo begrenzen de Muntlimieten voor assistenten van het team wat alle assistenten van het team samen mogen uitgeven, ongeacht welke persoon of welk token het uitgaf. Ze begrenzen niet wat mensen in de webapp uitgeven.

Onder de velden ziet u wat in het laatste uur en vandaag is gebruikt. Alleen een teambeheerder kan de limieten wijzigen, met Opslaan en Standaardwaarden herstellen; alle anderen zien ze alleen-lezen. Elke limiet moet groter zijn dan 0, de limiet per aanroep mag de limiet per uur niet overschrijden en de limiet per uur mag de limiet per dag niet overschrijden. Een leeg veld betekent "gebruik de standaardwaarde", en de standaardwaarden worden vóór deze controles ingevuld: met de standaardlimiet per aanroep van 2000 wordt een limiet per uur van 1000 geweigerd tot u ook de limiet per aanroep verlaagt.

Wanneer een aanroep een limiet zou overschrijden, vertelt de assistent u welke, hoeveel er nog over is en wanneer er weer ruimte komt, bijvoorbeeld "Deze aanroep zou 2500 coins kosten; de limiet per aanroep voor assistenten is 2000. Splits het werk op in kleinere aanroepen, of verhoog de limiet op de pagina Koppelen." De "pagina Koppelen" in deze berichten is het tabblad Integraties.

Eerst de prijs vragen

De drie betaalde tools kunnen een proefrun doen: ze controleren alles (bestanden, materialen, de status van het project) en zeggen wat het zou kosten, zonder iets uit te voeren of af te rekenen. Vraag de assistent "Hoeveel zou dat kosten? Nog niet uitvoeren", en daarna "OK, doe het maar". Een proefrun controleert de coinlimieten niet; de echte aanroep wel. Dezelfde upload opnieuw proberen rekent nooit twee keer af.

Bestanden naar CUTL krijgen: de uploadlink

Assistenten in een browser of op een telefoon kunnen niet altijd een bestand doorgeven, daarom geeft CUTL elke assistent een uploadlink.

Een bestand met een andere grootte wordt geweigerd: "Dit is niet het bestand dat de assistent heeft aangekondigd (verwacht: 49.352 bytes). Vraag om een nieuwe link." Een andere naam met de juiste grootte geeft alleen een waarschuwing en wordt toch geüpload. Een verlopen link meldt "Deze link is verlopen: vraag de assistent om een nieuwe." Het geheime deel van de link wordt uit de adresbalk verwijderd zodra de pagina opent, dus na opnieuw laden meldt de pagina dat de link onvolledig of beschadigd is: open dan de oorspronkelijke link uit de chat opnieuw.

Assistenten op uw computer (Claude Code, Cursor, Gemini CLI) kunnen het bestand zelf uploaden. Voor een project kan een assistent CUTL ook een openbare https-link naar een tekening geven, en ChatGPT kan een bestand doorgeven dat u in de chat hebt bijgevoegd. Bestanden voor de STEP- en samenstellingstools komen alleen via een uploadlink binnen.

Acties die u bevestigt

Acties die mensen buiten het gesprek bereiken, worden door de server van CUTL vastgehouden tot u ze bevestigt, wat de assistent ook besluit.

In de chat laat de assistent u eerst een voorbeeld zien van wat hij gaat doen, en handelt pas als u akkoord gaat.

Op de bevestigingspagina geeft de assistent u een link. Open die terwijl u in CUTL bent aangemeld als dezelfde persoon namens wie de assistent handelt, controleer het voorbeeld (een nieuw adres is gemarkeerd) en druk op Bevestigen of Weigeren. Ga daarna terug naar de assistent en zeg dat hij verder moet gaan: de pagina zelf voert niets uit. Een bevestiging verloopt 10 minuten nadat de assistent erom vroeg. Daarna toont de pagina een van deze meldingen:

• "Klaar: ga terug naar uw assistent en zeg dat hij door moet gaan."
• "Geweigerd. Er is niets gedaan; u kunt terug naar uw assistent."
• "Klaar: de assistent heeft dit al uitgevoerd."
• "Deze bevestiging is verlopen. Vraag uw assistent opnieuw te beginnen."
• "Deze bevestiging bestaat niet of is van iemand anders." (een verkeerde link, of die van iemand anders)

Limieten en fouten

De assistent kan niet op knoppen drukken waar CUTL een mens verwacht: een start bevestigen, verrijkingsmetingen controleren, tekeningen kiezen uit een PDF met meerdere tekeningen of een vraag bij PDF naar STEP beantwoorden. Hij vraagt u die stap in CUTL te doen en gaat daarna verder.

De demoserver

Om CUTL vanuit een assistent te proberen zonder account, koppelt u de demoserver zonder authenticatie:

claude mcp add --transport http cutl-demo https://mcp-demo.cutl.online/mcp/demo

Voeg in andere assistenten https://mcp-demo.cutl.online/mcp/demo toe als server zonder token en zonder aanmelding. Het is een verzonnen plaatwerkerij met zes tools met alleen-lezen toegang: projecten zoeken, productiestatus, de prijs van een onderdeel uitleggen, rapporten, materialen en klanten opzoeken, en nestresultaten. Daar kan niets worden aangemaakt, gewijzigd, geüpload, verzonden of afgerekend. Probeer "Wat staat er vandaag in productie?" of "Waarom kost onderdeel X zoveel?". Bij te veel aanroepen volgt "Te veel verzoeken aan de CUTL-demo; probeer het straks opnieuw".

Privacy

• Wat een tool teruggeeft (project- en onderdeelnamen, klantnamen en adressen, prijzen, opmerkingen, rapporten) wordt gelezen door de assistent, die bij zijn leverancier draait (Anthropic, OpenAI, Google enzovoort) onder de voorwaarden van die leverancier. Koppel alleen assistenten aan wie u die gegevens toevertrouwt, en alleen de toolsets die u nodig hebt.
• Bestanden die u op de uploadpagina neerzet, gaan rechtstreeks naar de opslag van CUTL, niet via de assistent.
• CUTL ziet uw gesprek niet, alleen de toolaanroepen en hun invoer. Elke toolaanroep wordt in CUTL vastgelegd.
• Tekst die door mensen is geschreven (namen, opmerkingen, teksten in tekeningen) wordt aan de assistent gegeven als gegevens waarvan hij geen instructies mag aannemen, en de bovenstaande bevestigingsregels worden door CUTL afgedwongen, wat de assistent ook besluit.
• Foutmeldingen die via de assistent worden verstuurd, bevatten uw gebruikers- en team-ID, niet uw e-mailadres.