AI-contractbeheeragent met Hermes Agent

Met de juiste koppeling kunt u een agent voor contractbeheer met kunstmatige intelligentie (AI) draaien met Hermes Agent van Nous Research. In een illustratief voorbeeld met fictieve gegevens wordt het orderformulier van een bureau voor Vantage, zijn klantrelatiebeheersysteem (CRM), op 1 februari verlengd met een opzegtermijn van 60 dagen. Het wekelijkse overzicht van de agent waarschuwt dat de beslissing uiterlijk op 2 december nodig is. De agent vindt contracten in uw mappen en inbox, plaatst ze in één contractrepository en houdt die volgens een schema bij. Contracko verzorgt het specialistische werk: AI-contractanalyse van elk document, de datums, de herinneringen en de risicoanalyse. Hermes doet het uitvoerende werk.

Hermes Agent is de opensourceagent van Nous Research [1]. U draait hem zelf op een laptop, een kleine server of een cloudmachine, met een modelaanbieder naar keuze, en u praat ermee via de terminal of via chatapps zoals Telegram en Slack [1]. In deze handleiding geeft u Hermes een eigen contractprofiel, koppelt u de Contracko Model Context Protocol (MCP) server en stelt u cronjobs in die volgens een schema draaien.

Waarom contracten een eigen profiel verdienen

Een Hermes-profiel is een aparte agent binnen dezelfde installatie, met een eigen configuratie, persoonlijkheidsbestand, geheugen, skills en cronjobs [1]. Contractwerk heeft eigen bronnen, een eigen ritme en eigen fouten om te vermijden, dus verdient het een eigen profiel.

Voor een particulier houdt dat profiel abonnementen, de huur, de hypotheek en de verzekeringspolis bij. Voor een bedrijf werkt het als interne contractmanager: het verzamelt elke ondertekende overeenkomst, archiveert die, vult de gegevens aan en meldt elke opzegdatum voordat die verstrijkt.

Bij AI-contractbeheer gaat het vooral om de taakverdeling. Hermes en het model erachter hoeven geen contracten te lezen en voorwaarden te extraheren. Contracko doet de AI-extractie en -analyse zelf: partijen, datums, verlengings- en opzegvoorwaarden, waarde, aansprakelijkheid, verplichtingen en risico's [4]. Hermes doet wat een goede assistent doet:

• documenten vinden op schijf, in gesynchroniseerde cloudmappen of in e-mail
• ze uploaden naar Contracko en controleren wanneer elke import klaar is
• controleren of elk contract onder het juiste contracttype is binnengekomen en, als dat niet zo is, het type aanpassen en Contracko vragen het document opnieuw te lezen
• contracten in mappen plaatsen en ontbrekende contactpersonen bij wederpartijen aanvullen
• herinneringen instellen, rapporten maken en melden wat aandacht nodig heeft

De algemene werking van de koppeling leest u in wat een MCP server voor contractbeheer is.

Zo ziet een Hermes-contractagent eruit

In de map zitten onder meer een verwerkersovereenkomst (DPA, data processing agreement) en een orderformulier voor een CRM-systeem. Hieronder een illustratief gesprek in Telegram, met fictieve bedrijven en gegevens. De beheerder vraagt het contractprofiel een map met scans te verwerken:

Import everything in ~/Contracts/2025-archive into Contracko. Wait for each import, check the contract types and file each contract under its client or supplier.

Bestand	Contracttype	Map	Status
Marlow Logistics framework.pdf	Raamovereenkomst	Leveranciers / Marlow	Geïmporteerd
Pinecrest Clinic DPA.pdf	Verwerkersovereenkomst	Klanten / Pinecrest	Geïmporteerd, type gewijzigd van "Other"
Harbour St sublease.docx	Kantoorhuur	Faciliteiten	Geïmporteerd
Vantage CRM order form.pdf	Softwareabonnement	Leveranciers / Vantage	Geïmporteerd, verlengt automatisch op 1 februari

Hermes meldt dat de overeenkomst van Pinecrest eerst als "Other" binnenkwam. Daarom heeft de agent het type aangepast en Contracko gevraagd de overeenkomst opnieuw te analyseren. De nieuwe veldwaarden uit die tweede lezing wachten in Contracko op uw goedkeuring [5]. De agent merkt ook op dat het orderformulier van Vantage op 1 februari wordt verlengd met een opzegtermijn van 60 dagen, zodat de beslissing uiterlijk op 2 december nodig is.

Uw contractagent instellen

Hermes is gratis en open source onder de MIT-licentie van het Massachusetts Institute of Technology (MIT) [1]. De kosten voor model en hosting hangen af van uw opzet. Aanbieders zoals OpenRouter of OpenAI, of een Nous Portal-abonnement, rekenen voor het gebruik van het model, en een cloudmachine kost geld. Een modelendpoint dat u zelf draait, of een laptop die u al heeft, kost misschien niets extra [1]. Heeft u Hermes nog niet geïnstalleerd, volg dan de stappen in de Hermes Agent-repository van Nous Research op GitHub.

Maak een contractprofiel

Maak een profiel met de naam contracts:

hermes profile create contracts

Het krijgt een eigen config.yaml, geheugen, skills, cronjobs en gateway [1]. Beschrijf vervolgens de taak in het bestand SOUL.md van het profiel. Houd de instructie gericht op het werk:

You run our contracts in Contracko. Keep the contract repository complete, filed and up to date. Import new signed agreements as they appear, check contract types, set reminders and tell me what needs attention. Quote the clause behind each finding, and never delete anything.

U heeft geen lange lijst met goedkeuringsregels nodig. Contracko vraagt om goedkeuring van een persoon voordat nieuwe veldwaarden uit een nieuwe lezing worden toegepast en voordat de deelinstellingen van een rapport veranderen. Ook vraagt Contracko om goedkeuring voordat een rapport of rapportblok wordt verwijderd of een deellink voor een contract wordt gemaakt of ingetrokken [5]. De Contracko-skill laat de agent bovendien eerst bulkwijzigingen en de kosten ervan bevestigen aan de hand van de ruimte in uw abonnement [2].

Koppel de Contracko MCP server

Hermes communiceert met Contracko via het Model Context Protocol (MCP), de open standaard waarmee AI-agenten met andere software werken. Er is geen knop om Hermes met één klik te koppelen, maar de kortste route komt dichtbij: Contracko publiceert een Hermes-pakket met installatie-instructies, en Hermes kan het voor u installeren [2]. Deze stappen volgen die gepubliceerde instructies. Start het profiel met hermes -p contracts en plak de prompt van de MCP-pagina van Contracko:

Fetch and follow the setup instructions for Contracko MCP at https://contracko.com/mcp/install/prompt.md

Hermes installeert het pakket contracko-hermes uit de releases van de open skillsbibliotheek van Contracko en vraagt u het in te schakelen. Daarna vraagt het om toestemming voordat het de Contracko MCP server toevoegt aan de config.yaml van het profiel [2]:

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

Daarna start het de aanmelding. U kunt die ook zelf starten voor het contractprofiel en in de browser bij Contracko inloggen:

hermes -p contracts mcp login contracko

Op een server zonder browser start u de aanmelding via Secure Shell (SSH). Hermes laat zien hoe u het terugkeeradres van de aanmelding bereikt of het doorgestuurde adres terugplakt [1]. Zodra u bent aangemeld, laadt u MCP opnieuw of start u Hermes opnieuw [2]. Vraag het profiel daarna de Contracko-verbinding te controleren; het hoort de werkruimte te noemen waarbij u zich heeft aangemeld.

Wanneer het toestemmingsscherm van Contracko vraagt wat u wilt toestaan, laat dan zowel View contracts als Add and edit contracts geselecteerd [2]. Add and edit wordt alleen aangeboden als uw rol in de werkruimte dat toelaat. Zonder die toestemming kan de agent vragen beantwoorden, maar niet importeren, archiveren of herinneringen instellen.

Contracko heeft twee producten:

• Contract management is uw contractrepository: contracten, datums, herinneringen, mappen, analyses en rapporten. Hermes gebruikt dit product en verbruikt daarbij nooit Parser-credits [2].
• Contracko Parser is een afzonderlijk hulpmiddel om documenten in bulk te verwerken zonder ze aan uw repository toe te voegen. Uw contractagent heeft dit niet nodig.

Nog geen account? Via het aanmeldscherm kunt u een gratis proefperiode starten zonder creditcard, of beginnen bij prijzen.

De Contracko-skill wordt meegeleverd

Hermes ondersteunt skills: instructiemappen die een agent leren een hulpmiddel goed te gebruiken. Het Contracko-pakket bevat de enige Contracko-skill, contracko. Daardoor weet uw profiel al hoe imports werken, wanneer het moet wachten en hoe het types en datums controleert. Heeft u de koppeling handmatig gemaakt, installeer de skill dan vanuit de open skillsbibliotheek van Contracko op GitHub [1]:

hermes -p contracts skills install contracko/contracko-skills/skills/contracko

Bouw een contractrepository met tracking

Een centrale contractrepository met tracking is waar een Hermes-agent zijn waarde bewijst. Elke overeenkomst staat in één werkruimte, met datums en herinneringen die blijven werken als Hermes niets doet. Is het idee nieuw voor u, begin dan met wat een contractrepository is.

Importeer de hele stapel

Hermes leest en schrijft bestanden op de machine waarop het draait. Wijs het naar een lokale map, of naar een map in Google Drive, Dropbox of OneDrive die met die machine is gesynchroniseerd. Voor e-mail voegt u in hetzelfde mcp_servers-blok een e-mail-MCP-server voor uw mailbox toe, een die berichten kan doorzoeken en bijlagen kan lezen.

Find every signed contract under ~/Contracts and ~/Dropbox/Clients. Tell me how many files you found and wait for my go-ahead. Then import each one into Contracko, wait until every import has finished, and list any file that failed and why.

Hermes uploadt elk bestand en controleert tot de import klaar is [5]. Contracko leest het document en maakt het contractrecord aan, gekoppeld aan een nieuwe of bestaande wederpartij. De uitgebreidere versie van deze taak staat in contracten importeren en organiseren met MCP.

Contracko weet wat het moet extraheren

Contracttracking werkt alleen met de juiste velden. Wanneer een contract binnenkomt, extraheert de AI van Contracko de belangrijkste gegevens, zoals partijen, datums en verplichtingen [4]. Het contractrecord bevat velden voor verlengings- en opzegvoorwaarden, jaarlijkse en totale waarde, aansprakelijkheidslimieten en toepasselijk recht, ingevuld op basis van die extractie [5]. Contracttypes kunnen eigen aangepaste velden hebben, die Contracko kan uitlezen uit de documenten van dat type [5].

Juist bij de nuances schieten spreadsheets tekort. Een einddatum vertelt niet of een contract wordt verlengd. Contracko legt automatische verlenging en de verlengingsperiode afzonderlijk vast en houdt de opzegtermijn bij als periode vóór de einddatum [3]. De details staan in contractdatums en automatische verlengingen.

Corrigeer types en mappen

Deze stap wordt vaak overgeslagen. Geef hem aan de agent:

Check every contract imported today. If the contract type is wrong, change it and ask Contracko to read the document again. Then file each contract in the right client, supplier or facilities folder, creating folders where needed, and list the re-reads waiting for my approval.

Na een typewijziging stelt een nieuwe lezing waarden voor voor de velden van het nieuwe type, zodat een verwerkersovereenkomst verwerkingsvoorwaarden krijgt in plaats van algemene voorwaarden. U keurt in Contracko goed welke voorstellen worden toegepast. De opgeslagen velden blijven ongewijzigd totdat u dat doet [5].

Herinneringen en uw agenda

Zodra de datums zijn ingevuld, stelt één bericht herinneringen in voor de hele contractrepository:

Add a reminder 21 days before the notice deadline of every contract that renews automatically, sent to me and to each contract's owner.

De herinneringen staan in Contracko en komen per e-mail binnen, dus ze worden ook verstuurd als uw Hermes-gateway die week uitstaat [5]. Meer prompts voor deze taak vindt u in herinneringen voor contractverlenging met MCP.

De agendafeed van Contracko zet begin-, eind- en opzegdatums en herinneringen in Google Calendar, Apple Calendar of Outlook [3]. U abonneert zich eenmaal: open Calendar in Contracko, kopieer het feedadres en voeg het toe aan uw agenda-app. De stappen staan in de handleiding voor de agenda.

AI-contractanalyse voor elke overeenkomst

Stel een vraag over één overeenkomst en u krijgt een helder antwoord: waartoe die u verplicht, welke datums tellen, hoe het geld stroomt en wat ongebruikelijk is. Contracko heeft het contract al geanalyseerd, dus Hermes antwoordt op basis van die analyse [4]. Omdat SOUL.md erom vraagt, citeert Hermes de zin achter elk punt, die u in Contracko met het document kunt vergelijken.

Give me the Vantage CRM order form in five lines: term, renewal, notice, price changes and anything unusual.

Under the Pinecrest data processing agreement, how fast do we have to report a data breach?

Een illustratief antwoord op de eerste prompt, met fictieve gegevens:

Punt	Wat Contracko vond	Clausule
Looptijd	12 maanden vanaf 1 februari, jaarlijkse verlenging	"This Order Form renews automatically for successive one-year terms."
Opzegging	60 dagen vóór verlenging, per e-mail	"Customer may cancel by written notice at least 60 days before renewal."
Ongebruikelijk	Het aantal gebruikersplaatsen kan nooit omlaag	"Seat quantities may not be reduced during or at the end of a term."

Zo leest AI contracten zonder dat u ze ergens hoeft te plakken. De versie met een chatassistent staat in AI-contractbeoordeling met MCP.

AI-contractbeoordeling voor risico's en verplichtingen

Bij AI-contractbeoordeling voor de hele portefeuille stelt u dezelfde vragen tegelijk aan elke overeenkomst: waar lopen we risico en wat zijn we aan wie verschuldigd en wanneer [4]?

Which supplier contracts have uncapped liability, one-sided indemnities or a termination right only for the supplier? Sort them by renewal date.

What do we owe clients in the next 60 days under our contracts: reports, audits, notices and payments?

Een illustratieve tabel met bevindingen voor de tweede prompt, met fictieve gegevens:

Verplichting	Tegenover	Uiterlijk
Jaarlijks beveiligingsauditrapport	Pinecrest Clinic	10 januari
Bijgewerkt verzekeringscertificaat	Verhuurder Harbour St	31 januari
30 dagen vooraf kennisgeven van een wijziging van subverwerker	Pinecrest Clinic	Vóór de wijziging

Hermes leest per contract de risico- en verplichtingenanalyse van Contracko en citeert, zoals de instructies vragen, de clausule, zodat u de tekst kunt controleren voordat u handelt. Zie voor het bredere vakgebied contractrisicobeheer.

Rapporten die uw team daadwerkelijk leest

Contracko maakt rapporten op basis van de actuele gegevens in uw account. Ze blijven actueel wanneer contracten veranderen [3]. Uw Hermes-agent kan via MCP op basis van een gewoon verzoek een rapport maken, gegroepeerd per wederpartij, contracttype, status of contracteigenaar, met maten zoals de jaarlijkse waarde [5]. Na uw goedkeuring kan de agent een rapport ook delen met uw werkruimte of met bij naam genoemde collega's, omdat nieuwe deelinstellingen de oude vervangen [5].

Create a Contracko report of all contracts renewing next quarter, grouped by contract owner, with annual value.

Wie het rapport volgende maand opent, ziet de cijfers van die maand.

Vijf workflows om met cron uit te voeren

Hermes heeft een ingebouwde cronplanner. U kunt taken in gewone taal aanmaken in de chat, met /cron add of met hermes cron create. U kiest waar de resultaten naartoe gaan: terug naar de chat waar ze vandaan komen, naar Telegram of een ander gekoppeld platform, of naar een lokaal bestand [1]. Taken draaien binnen de Hermes-gateway, dus laat de gateway draaien op een machine die aan blijft. Plak een van de onderstaande prompts in uw contractprofiel en pas de paden, tijden en kanalen aan.

Taken die naar Contracko schrijven, volgen nog steeds de Contracko-skill, die de agent bulkwijzigingen en de kosten ervan laat bevestigen voordat het ze uitvoert [2]. De schrijftaken hieronder plaatsen daarom eerst een plan en handelen op uw antwoord. Maak ze aan in de chat waarin u wilt antwoorden. Afhankelijk van uw Hermes-versie en instellingen zet een antwoord in de thread van de uitvoering op Slack of in Telegram-topics de taak met volledige context voort [1]. Doet het dat niet, vraag het profiel dan in een nieuw bericht het geplaatste plan uit te voeren. Taken die alleen lezen, zoals het overzicht, lopen direct door.

Alles eenmalig importeren

Voer dit één keer uit voor het volledige archief. Het werkt zowel voor de administratie van een huishouden als voor het bestaande archief van een bedrijf.

Find every signed contract under ~/Contracts, ~/Dropbox and ~/Google Drive, and in the attachments in my mailbox. Tell me how many you found and wait for my go-ahead. Then import each one into Contracko that is not already there and wait until every import has finished. Check each contract type; fix any that are wrong and ask Contracko to read those documents again. File each contract in a folder per client, supplier or household category. Then send me a summary: how many you imported, what you filed where, which re-reads wait for my approval, and anything you could not import.

Een map op nieuwe contracten controleren

Create a cron job that runs every weekday at 07:00. Check ~/Dropbox/Signed agreements for files added since the last run and post the list, with the contract type you expect for each. When I reply to confirm, import each file into Contracko, wait for the import to finish, check the contract type and file it in the right folder. If there are no new files, post "No new files".

Ondertekende contracten uit uw inbox ophalen

De eigen e-mailgateway van Hermes ontvangt berichten die aan de agent zijn gestuurd, maar doorzoekt uw bestaande mailbox niet [1]. Voeg daarom eerst een e-mail-MCP-server voor uw mailbox toe aan het mcp_servers-blok van het profiel en controleer in de documentatie ervan of die oude berichten kan doorzoeken en bijlagen kan downloaden. De eerste uitvoering doorzoekt de mailbox. Daarna zoekt de taak naar ondertekende overeenkomsten die als bijlage binnenkomen en vult zij de wederpartij aan met gegevens uit de e-mailwisseling.

First, search my mailbox for emails with a signed contract attached. List them and wait for my go-ahead, then import each confirmed contract into Contracko that is not already there. Then create a cron job that runs every day at 18:00, finds signed contracts attached to mail received since the last run and posts the list. When I confirm, import them, and add the counterparty's contact person, email address and role from the email to the counterparty in Contracko.

Een wekelijks overzicht van deadlines ontvangen

Create a cron job for every Monday at 08:00. List every contract with a notice deadline or end date in the next 60 days, with the date and the decision I need to make. Add any contract imported last week that has no end date or no contract type. Deliver it to Telegram.

Rapporten delen met uw team

Koppel eerst Slack aan de gateway van het contractprofiel. Hermes cron levert aan uw thuiskanaal in Slack of aan een kanaal via diens Slack-identificatiecode (ID) [1].

Create a Contracko report of all contracts renewing in the next quarter, grouped by contract owner, with annual value. Then create a cron job for the first weekday of each month at 09:00 that posts to Slack the contracts renewing next month, with each one's owner and annual value, and the name of the report in Contracko.

Voer elke taak eenmaal handmatig uit en controleer het resultaat in Contracko.

Wat uw agent wel en niet kan

Hermes handelt namens u binnen de werkruimte die u bij het aanmelden koos en kan nooit een contract openen dat u zelf niet kunt openen [4]. Records die de agent maakt of bijwerkt, verschijnen in de activiteitengeschiedenis van Contracko met het label MCP [4]. Delen werkt anders. Met uw goedkeuring kan de agent een rapport delen met collega's. Ook kan de agent een tijdelijke deellink voor een contract maken die iedereen met de link kan gebruiken, als u dat contract kunt beheren en uw abonnement delen omvat [5]. Ook een deellink voor een rapport die u in de Contracko-app maakt, toont het rapport aan iedereen met de link [3].

De agent kan uw contracten niet verwijderen. De Contracko MCP server heeft geen hulpmiddel om een contract, document, map, wederpartij of contracttype te verwijderen; dat kan alleen in de Contracko-app [5]. Wat de agent wel kan verwijderen, beperkt zich tot aangepaste datums, herinneringen, rapporten, rapportblokken en deellinks voor contracten, waarbij de laatste drie pas na uw goedkeuring [5]. De agent kan ook contractgegevens bewerken, een contract uit een map halen en de lijst met aangepaste velden van een contracttype wijzigen. Vraag het daarom een typewijziging eerst te tonen voordat het die opslaat.

U kunt Hermes op elk moment ontkoppelen in Contracko via Settings, vervolgens Integrations en dan MCP Connections. De documentatie van de MCP server behandelt de rest, waaronder sleutels voor de applicatieprogrammeerinterface (API) in situaties waarin aanmelden via een browser niet mogelijk is [3].

Eén aandachtspunt geldt specifiek voor Hermes. U host het zelf, dus het aanmeldtoken voor Contracko staat op de machine waarop Hermes draait, naast de bestanden die de agent kan lezen [1]. Behandel die machine als elke andere plek met een sleutel tot uw contracten.

Contracko traint geen modellen op uw contracten [4]. Hermes stuurt contracttekst naar de modelaanbieder die u instelt. Controleer daarom de gegevensvoorwaarden van die aanbieder en schakel daar modeltraining uit als de aanbieder dat toestaat, voordat u echte contracten koppelt [4].

Waarom een koppeling beter werkt dan plakken

Een agent zonder koppeling kent alleen de documenten die hij het laatst kreeg en kan een ondertekend addendum niet onderscheiden van een oud concept. Via Hermes MCP en Contracko werkt de agent steeds met de actuele records, datums en analyses. Daardoor rapporteert een cronjob op maandag over de portefeuille van vandaag.

Veelgestelde vragen

Hoe koppel ik Hermes Agent aan een MCP server voor contractbeheer?

Plak de installatieprompt van Contracko in uw contractprofiel. Hermes installeert het pakket, vraagt om toestemming voordat het de Contracko MCP server toevoegt aan config.yaml en start de aanmelding. Op een server zonder browser begeleidt Hermes u bij de aanmelding via SSH. U hoeft niet te programmeren, maar u moet wel vertrouwd zijn met het installeren van Hermes en het bewerken van een configuratiebestand.

Heb ik een bepaald abonnement of een bepaalde regio nodig?

Geen bepaald Contracko-abonnement: elk abonnement bevat de MCP server zonder extra kosten [4]. Hermes heeft geen eigen abonnement en draait op elke machine waarop u het host, dus de kosten voor model en hosting hangen af van uw opzet [1].

Eén agent of meerdere?

Eén contractprofiel per Contracko-werkruimte houdt het eenvoudig, omdat elke aanmelding verbinding maakt met de werkruimte die u kiest [4]. Profielen zijn aparte agenten, dus uw overige Hermes-werk houdt een eigen geheugen en eigen instructies [1].

Hoe houden bedrijven contractverlengingen automatisch bij?

Ze bewaren elk contract in een contractrepository die elke verlengings- en opzegdatum kent en laten herinneringen het onthouden doen. Met Hermes en Contracko importeert de agent de contracten, extraheert Contracko de datums, stelt de agent herinneringen in Contracko in en meldt een wekelijkse cronjob wat eraan komt.

Kan ik gratis AI-contractbeoordeling proberen voordat ik de agent instel?

Ja. De tool voor gratis AI-contractbeoordeling van Contracko controleert één document. Deze staat los van de agent, die binnen uw Contracko-account werkt.

Worden mijn contractgegevens gebruikt om AI-modellen te trainen?

Niet door Contracko [4]. Aan de kant van Hermes hangt dit af van de modelaanbieder die u kiest, dus controleer diens voorwaarden en schakel training uit waar dat kan.

Bronnen

[1] Nous Research. Hermes Agent repository en documentatie (licentie, modelaanbieders, profielen, MCP-aanmelding, skills, cron en de e-mailgateway). github.com/NousResearch/hermes-agent en hermes-agent.nousresearch.com/docs

[2] Contracko. Skillsbibliotheek met het Hermes-pakket, installatiestappen, toestemmingsscherm en skillregels. github.com/contracko/contracko-skills

[3] Contracko. Helpdocumentatie over de MCP server, rapporten, contractdatums en de agendafeed. contracko.com/docs

[4] Contracko. Pagina's over de MCP server voor contractbeheer en contract-AI (toegang, activiteitengeschiedenis, abonnementen, extractie en gegevensgebruik). contracko.com/mcp/contract-management en contracko.com/features/contract-ai

[5] Contracko. Toolbeschrijvingen die de live Contracko MCP server publiceert (imports, nieuwe lezingen, herinneringen, rapporten, delen en goedkeuringen). app.contracko.com/mcp