MCP-server

Contracko's MCP-server verbindt je contractwerkruimte met de AI-assistent die je al gebruikt. Vraag Claude, ChatGPT, Gemini of Copilot iets over je contracten en ze lezen de echte gegevens: partijen, datums, waarden en de documenten zelf. Geef ze schrijftoegang en ze kunnen contracten importeren, herinneringen instellen en nieuwe overeenkomsten voor je vastleggen.

Je houdt zelf de controle. Read en Write zijn aparte rechten, jij kiest welke je toekent, en je kunt de verbinding op elk moment verbreken.

Verbind in twee stappen

1. Voeg de skills toe zodat de assistent weet hoe hij met contracten kan helpen. De skills zijn vier korte handleidingen, gepubliceerd op contracko/contracko-skills.
2. Voeg de verbinding toe zodat de assistent bij je werkruimte kan. Plak dit adres wanneer erom wordt gevraagd:

https://app.contracko.com/mcp

Er opent een browservenster. Log in bij Contracko, of start op dat scherm een gratis proefperiode als je nog geen account hebt.

Het toevoegen van de skills verbindt je werkruimte niet vanzelf. Staat Contracko al in de connectorlijst van je assistent, sla stap 2 dan over in plaats van de verbinding twee keer toe te voegen. Gebruik je Claude of Claude Code? Volg dan de Claude-stappen onder Verbind je assistent: Contracko staat in de connectordirectory van Claude.

Vink bij het inloggen Read aan zodat de assistent vragen kan beantwoorden. Vink Write alleen aan als hij contracten mag toevoegen of wijzigen. Laat Write uit tenzij je dat wilt.

Kies Read- of Write-toegang

Recht	Wat het toestaat	Wanneer toekennen
Read	Contracten vinden, geëxtraheerde datums, waarden en partijen lezen, binnen documenten zoeken, AI-analyse en opmerkingen bekijken	Altijd. Dit is genoeg om vragen over je werkruimte te stellen.
Write	Contracten importeren, velden bijwerken, documenten en opmerkingen toevoegen, contracttypen en tegenpartijen aanmaken, mappen aanmaken, hernoemen en verplaatsen, contracten vastleggen in mappen die je kunt zien, herinneringen instellen en wijzigen	Alleen als je wilt dat de assistent wijzigingen aanbrengt. Begin zonder.

Met Read kan de assistent ook laten zien wie toegang heeft tot een contract of map. Je kunt contractzoekopdrachten ook beperken tot een map die je kunt zien. Toegang wijzigen en mappen verwijderen doe je alleen in de Contracko-app. Vraag de assistent om voorgestelde wijzigingen te bevestigen voordat hij ze aanbrengt. Hij handelt namens jou en kan dus alleen contracten en mappen bereiken waartoe jij binnen je werkruimterechten toegang hebt. Zie contractrechten voor hoe toegang wordt bepaald.

Dit is iets anders dan Clara AI, die binnen Contracko werkt. Gebruik Clara in de app, en verbind via MCP wanneer je vanuit Claude, ChatGPT of een andere assistent wilt werken die je al open hebt staan.

Vind de contracten die je nodig hebt

Vraag naar een leverancier, contracttype, status, bereik voor einddatums of bereik voor opzegdatums. Je assistent kan de contractlijst verfijnen voordat deze de resultaten leest. Bijvoorbeeld: “Welke Acme-contracten eindigen of hebben volgend kwartaal opzegging nodig?” Als meerdere leveranciers dezelfde naam hebben, bevestig dan welke je bedoelt.

Je assistent moet elke pagina met overeenkomende contracten controleren voordat hij meldt dat het overzicht compleet is. Zoekopdrachten op datum sluiten contracten zonder passende datum uit, vraag dus apart naar ontbrekende datums. Alleen een einddatum betekent niet dat een contract automatisch wordt verlengd. Vragen over bedragen, valuta's, ontbrekende velden of clausules kunnen extra controles vereisen.

Gebruik je bestaande verbinding

OAuth is de standaardmanier om Contracko met je assistent te verbinden. Je hoeft geen nieuwe verbinding, vervangende API-sleutel of extra rechten te maken om betere zoekmogelijkheden te gebruiken in tools die je al hebt. Als je assistent nog oude opties toont, vernieuw dan de tools of verbind de bestaande connector opnieuw.

Als OAuth niet beschikbaar is, kun je een speciale MCP API-sleutel gebruiken. Stuur deze met elke aanvraag in de header Authorization: Bearer <je-MCP-API-sleutel>. Bewaar deze sleutel veilig en deel hem niet.

Beschikbare acties hangen af van je verbinding en rechten in de werkruimte. Behoud Read voor vragen. Geef Write alleen als je wilt dat de assistent wijzigingen maakt. Ontbreekt een actie, controleer dan de gekozen werkruimte en de rechten van de verbinding, of neem contact op met support.

Controleer onzekere wijzigingen voordat je het opnieuw probeert

Als je assistent niet kan bevestigen dat een wijziging is gelukt, controleer het contract dan in Contracko voordat je het opnieuw probeert. Een fout betekent niet altijd dat er niets is gewijzigd.

Agents en ontwikkelaars vinden argumenten voor tools en richtlijnen voor het verwerken van antwoorden in de instructies voor agentinstelling.

Verbind je assistent

Kies het product dat je gebruikt. Elke route eindigt op dezelfde manier: inloggen via het browservenster dat opent.

Claude

Voor Claude op het web, desktop, mobiel en in Cowork.

1. Open Contracko in de connectordirectory van Claude.
2. Kies Connect to Claude.
3. Log in bij Contracko via de browser die opent.

Dit werkt op elk Claude-abonnement, ook op Free. Bij Team en Enterprise zet een Owner de connector eerst aan. Een connector die je op het web of desktop toevoegt, werkt ook in de mobiele app van Claude.

Vanaf Pro kun je ook de Contracko-plugin installeren (Customize → Plugins) voor de vier contractskills, en daarna verbinden via het tabblad Connectors van de plugin.

Heb je Contracko eerder als custom connector toegevoegd? Verwijder die, anders zie je elke tool twee keer.

ChatGPT

1. Ga naar Settings → Plugins → Import marketplace en voer contracko/contracko-skills in.
2. Zet Developer mode aan.
3. Ga naar Settings → Apps → Create en plak https://app.contracko.com/mcp.
4. Log in via de browser die opent.

Grok

1. Open grok.com/connectors.
2. Voeg https://app.contracko.com/mcp toe.
3. Log in via de browser die opent.

Claude Code

Ingelogd met je Claude-account? Een connector die je in Claude hebt toegevoegd, is hier al beschikbaar. Je hoeft niets toe te voegen.

Installeer voor de skills de plugin. Die registreert ook de verbinding:

/plugin marketplace add https://github.com/contracko/contracko-skills.git
/plugin install contracko@contracko

Gebruik het volledige GitHub-adres, niet een verkorte owner/repo-naam. Typ daarna /mcp in de sessie en log in.

Gebruik je een API-sleutel zonder de plugin? Voer dit alleen uit als claude mcp list geen Contracko-item toont:

claude mcp add --transport http contracko https://app.contracko.com/mcp

Typ daarna /mcp en log in.

Codex

npx skills@latest add contracko/contracko-skills
codex mcp add contracko --url https://app.contracko.com/mcp
codex mcp login contracko

Cursor

npx skills@latest add contracko/contracko-skills

Voeg dit vervolgens toe aan .cursor/mcp.json in je project (maak het bestand aan als het er nog niet is):

{ "mcpServers": { "contracko": { "url": "https://app.contracko.com/mcp" } } }

Herstart Cursor als de verbinding niet meteen wordt opgepikt.

GitHub Copilot in VS Code

npx skills@latest add contracko/contracko-skills

Voeg dit vervolgens toe aan .vscode/mcp.json:

{ "servers": { "contracko": { "type": "http", "url": "https://app.contracko.com/mcp" } } }

Gemini CLI

npx skills@latest add contracko/contracko-skills

Voeg dit vervolgens toe aan ~/.gemini/settings.json:

{ "mcpServers": { "contracko": { "httpUrl": "https://app.contracko.com/mcp" } } }

OpenClaw

npx skills@latest add contracko/contracko-skills
openclaw mcp set contracko '{"url":"https://app.contracko.com/mcp","transport":"streamable-http"}'
openclaw mcp configure contracko --auth oauth
openclaw mcp login contracko

Hermes

npx skills@latest add contracko/contracko-skills

Voeg dit vervolgens toe aan ~/.hermes/config.yaml:

mcp_servers:
  contracko:
    url: "https://app.contracko.com/mcp"
    auth: oauth

Voer hermes mcp login contracko uit en log in.

Elke andere assistent

Plak dit in de assistent en laat hem de instructies volgen:

Fetch and execute https://contracko.com/mcp/install/prompt.md

Wil je de verbinding liever zelf toevoegen, dan is het adres nog steeds https://app.contracko.com/mcp.

Probeer dit te vragen

Eenmaal verbonden praat je met de assistent zoals je dat met een collega zou doen.

Probeer dit te vragen	Wat het doet
We zijn een klant aan het onboarden. Haal alle PDF's uit deze map en zet ze in Contracko.	Vindt de bestanden, overlegt met jou over de set, importeert ze en laat Contracko datums, partijen en types extraheren.
Ik wil geen stilzwijgende verlengingen. Wat moet opgezegd worden, loopt af, of wordt automatisch verlengd in het komende kwartaal? Zet daar overal herinneringen voor.	Somt de datums op die ertoe doen en maakt daarna herinneringen zodat je op tijd een melding krijgt.
Vergelijk de MSA van Acme met die van Beta. Wie heeft de betere aansprakelijkheidslimiet, opzegtermijn en dataverwerkingsvoorwaarden?	Zet beide contracten naast elkaar, met geciteerde clausules.
Doorloop onze leverancierscontracten op ongelimiteerde aansprakelijkheid, eenzijdige vrijwaringen en ontbrekende opzegtermijnen.	Loopt de portefeuille door en citeert de zin achter elke bevinding.
Onze indeling is een chaos. Help me een mappenstructuur voor MSA's, NDA's, SOW's en DPA's af te spreken, maak die daarna aan en leg onze contracten erin vast.	Bevestigt de structuur met je, maakt daarna de mappen aan en legt contracten vast waartoe je toegang hebt. Richt ook de types, velden en tegenpartijen in die je gebruikt.
Waar moeten we deze maand naar kijken? Wat is urgent, en wat missen we?	Rangschikt de werkruimte op urgentie en hiaten.
Loop met me door een nieuwe NDA, stuur die ter ondertekening, en leg de ondertekende PDF vast als die terugkomt.	Doorloopt de vragenlijst en legt daarna de uitgevoerde versie vast.

Je hoeft geen skill te noemen. Vragen in gewone taal is genoeg.

Wat de skills doen

Skill	Gebruik het voor
contracko	Verbinden, en daarna contracttypen, aangepaste velden, tegenpartijen en mappen organiseren
contracko-import	PDF's en Word-bestanden binnenhalen vanaf schijf, Drive, SharePoint, Box of een link
contracko-review	Opzegdatums, herinneringen, vergelijkingen, risicotaal, en wat je vervolgens moet bekijken
contracko-create	Een nieuwe overeenkomst, van vragen tot het vastleggen van de ondertekende PDF

Verbind in plaats daarvan met een token

Gebruik de browseraanmelding (OAuth) voor de meeste verbindingen. Kan je client of automatisering die niet gebruiken, maak dan een speciale MCP API-sleutel in Contracko via Settings → Integrations → API keys. Stel je client in om deze als Authorization: Bearer-header naar https://app.contracko.com/mcp te sturen. Bewaar de sleutel in de geheime instellingen van de client, niet in chat of gedeelde bestanden. Beide verbindingsmethoden volgen de toegang die je verleent en de rechten van je werkruimte.

Beheer verbindingen in Contracko

Nadat je toegang hebt goedgekeurd, verschijnt de assistent onder MCP Connections op Settings → Integrations. Je ziet wie de verbinding heeft gemaakt, welke toegang die heeft, en wanneer die voor het laatst is gebruikt.

Je kunt elke vermelde verbinding loskoppelen. Alleen de persoon die de verbinding heeft gemaakt, kan extra OAuth-toegang goedkeuren. Alleen eigenaren en admins kunnen API keys aanmaken, wijzigen of intrekken.

Bekijk een verbinding

1. Open Settings, daarna Integrations.
2. Zoek de assistent onder MCP Connections.
3. Open het rijmenu en kies Manage connection.

Het dialoogvenster toont Connected by, Last used en Current access.

Koppel een assistent los

1. Kies Disconnect in het rijmenu, of open Manage connection en gebruik de knop om los te koppelen.
2. Bevestig Disconnect.

Die assistent verliest toegang tot deze werkruimte. Andere verbindingen blijven staan. Verwijder de connector ook in de assistent, anders vraagt die opnieuw om in te loggen.

Wijzig toegang of roteer de machtiging

Je kunt OAuth-rechten niet in dit scherm wijzigen. Om Read of Write te veranderen, verbind je opnieuw vanuit de assistent en keur je de machtigingen opnieuw goed.

1. Open in Contracko Manage connection en kies Connection setup als je het MCP-adres of de clientstappen nodig hebt.
2. Verbind Contracko opnieuw in de assistent en log in.
3. Vink op het goedkeuringsscherm Read aan. Vink Write alleen aan als de assistent contracten mag wijzigen.
4. Kies Disconnect voor de oude verbinding in Contracko, zodat dezelfde assistent niet twee keer in de lijst staat.

Opnieuw verbinden is ook hoe je de OAuth-machtiging roteert. Er is geen aparte knop om een token te roteren.

Roteer of trek een API-sleutel in

Tokenverbindingen beheer je bij API keys op dezelfde pagina, niet bij MCP Connections.

1. Maak een nieuwe MCP server-sleutel als je nog een token nodig hebt. Kopieer het geheim één keer.
2. Zet het nieuwe geheim in de Authorization: Bearer-header van de client.
3. Open de oude sleutel en kies Revoke key.

Met Manage key kun je toegang toevoegen zonder het geheim te wijzigen. Sleutels verlopen na 12 maanden.

Los veelvoorkomende problemen op

"Your Contracko connection needs to be renewed." De verbinding is verlopen. Verbind opnieuw vanuit de connectorinstellingen van je assistent en log opnieuw in.

De assistent zegt dat hij geen tool kan vinden. Controleer de gekozen werkruimte en de rechten van de verbinding, en vernieuw daarna de tools van de assistent. Geef Write alleen als je wilt dat de assistent wijzigingen maakt. Neem contact op met support als de actie nog steeds ontbreekt.

De assistent kan een contract niet zien dat jij wel kunt zien. Controleer of je bent ingelogd in de juiste werkruimte, en of het contract met jou is gedeeld in Contracko.

Contracko staat er dubbel in. Je hebt twee verbindingen met dezelfde server. Verwijder in Claude de custom connector die je eerder hebt toegevoegd en houd die uit de connectordirectory. Heb je in Claude Code de plugin geïnstalleerd en ook claude mcp add uitgevoerd? Voer dan claude mcp remove contracko uit. Verwijder in andere assistenten de dubbele connector. De skills toevoegen en de verbinding toevoegen zijn losse stappen, en de verbinding twee keer toevoegen levert twee items op.

Voordat je echte contracten deelt

Contracko traint geen modellen op je contracten, en onze analyse draait onder commerciële API-voorwaarden met Zero Data Retention waar beschikbaar.

Een assistent verbinden is iets anders. Wanneer Claude, ChatGPT of een ander product Contracko aanroept, wordt je contracttekst naar dat product gestuurd, en Contracko kan daar niet bepalen wat ermee gebeurt. Zet modeltraining in dat product uit voordat je het met echte contracten gebruikt. Zie Security voor hoe wij aan onze kant met je gegevens omgaan.

Hulp nodig

Voor vragen over Contracko zelf lees je de documentatie of neem je contact met ons op.

Voor een vraag over de skills, een suggestie of een verbetering, open een issue op de skills-repository.

Wil je de machine-leesbare versie van deze documentatie voor een agent of crawler, zie agent tooling.