Je team werkt in Lumo. Je agents werken headless mee.

MCP is de open standaard waarmee AI-agents gereedschappen van andere systemen gebruiken. Lumo heeft een MCP-server op /mcp. Je agent stuurt een verzoek met zijn API-sleutel, en krijgt een lijst met tools terug die hij mag gebruiken. Heeft de sleutel alleen leesrecht op contacten, dan ziet de agent ook alleen de tools om te zoeken en een persoon op te halen.

Er staan 593 tools klaar, verdeeld over 24 domeinen. Een gewone sleutel ziet er 506. De andere 87 zijn voor eigenaar- en beheerwerk en verschijnen alleen bij een sleutel met workspace:admin, en die kan alleen een eigenaar maken. Met ?toolsets= achter het adres beperk je een agent verder, bijvoorbeeld tot deals en activities.

Dus doet een agent veel meer dan contacten bijhouden. Hij zoekt met search, haalt deals op met list_deals en legt een belafspraak vast met log_activity. Hij schrijft uren met log_time of start een timer met start_timer, zie tijdregistratie. Hij zet mensen in een belcampagne met create_call_campaign en legt de uitkomst vast met record_call_outcome, zie telefonie. Hij zet mensen in een Cadence met add_people_to_cadence en haalt LinkedIn-acties op met claim_linkedin_actions. Hij leest een score met get_lead_score bij leadscoring, vult een persoon aan met enrich_person, en zoekt een vrij moment met get_planner_availability voor hij boekt met create_planner_booking in de planner. Voor marketing zijn er tools als create_marketing_campaign en record_campaign_spend.

Tools die een klant benaderen, mail versturen of iets voorgoed wissen, vragen een expliciete bevestiging met confirm: true. En elke tool is ook een REST-eindpunt onder /api/v1/tools. Een script zonder MCP-client kan dus precies hetzelfde.

• 593 tools in 24 domeinen, 506 zichtbaar voor een gewone sleutel
• De lijst met tools volgt de rechten van de sleutel en ?toolsets=
• Mail versturen, klanten benaderen en wissen vragen confirm: true
• Tot 20 verzoeken in één batch, die meetellen in de limiet
• Elk antwoord zegt dat recordtekst data is en geen opdracht

Het verschil met een agent naast je CRM is waar het werk terechtkomt. In Lumo is er geen inbox voor agents en geen apart tabblad met suggesties. Een belafspraak die je agent vastlegt, is gewoon een activiteit. Hij staat op de tijdlijn van de persoon en de deal, in de activiteitenlijst, en op de dag dat hij gepland is op Vandaag van degene die hem moet doen.

Dat werkt omdat de API en de MCP-server dezelfde schrijfroute gebruiken als het scherm. Dezelfde regels voor verplichte velden, dezelfde koppelingen, dezelfde waarschuwingen als iets niet klopt. Overtreedt de agent een regel, dan krijgt hij een fout terug met uitleg per regel, en er wordt niets half opgeslagen. Een lead die via MCP binnenkomt, krijgt de bron mcp als je agent zelf geen bron meegeeft. Een activiteit via MCP staat op naam van wie de sleutel maakte. Wil je hem bij een andere collega leggen, dan geeft je agent via de REST API een eigenaar mee. Zo filter je later precies op wat je agents hebben aangemaakt.

Ook je eigen automatiseringen reageren op wat een agent doet. Maakt de agent een lead aan, dan start een regel als "Nieuwe lead, dan beltaak voor vandaag" net zo goed als bij een lead uit een formulier. Zo werken agents en regels samen zonder dat je ze aan elkaar hoeft te knopen.

• Activiteiten van agents staan op de tijdlijn en op Vandaag
• Dezelfde validatie als in het scherm, nooit half opgeslagen
• Leads van MCP krijgen de bron mcp, zodat je erop kunt filteren
• Automations starten op wat een agent aanmaakt

Een agent die alles mag, wil niemand. Daarom draait in Lumo elke agent onder een eigen API-sleutel met rechten per onderdeel. Je kiest voor elk van de 24 onderdelen of de sleutel mag lezen, schrijven of allebei. Schrijven geeft geen leesrecht, dus een sleutel die alleen leads aanmaakt, kan je klantenbestand niet uitlezen. Webhooks beheren is een apart recht.

Elke gebruiker maakt zijn eigen sleutels, ook een lezer. Maar een sleutel komt nooit boven de rechten van zijn maker uit. Mag een verkoper de uren van collega's niet zien, dan ziet zijn agent ze ook niet. Alleen een eigenaar kan een sleutel met workspace:admin maken, en ook die werkt hoogstens als beheerder, nooit als eigenaar.

De sleutel zie je één keer. Daarna staat alleen een hash in de database, dus ook wie de database zou inzien, kan geen sleutel nabootsen. Een sleutel hoort in de Authorization-kop en wordt nooit uit de URL gelezen. Met Verloopt op geef je hem een einddatum, met Intrekken zet je hem direct uit.

De grenzen zijn hard. 600 verzoeken per minuut per sleutel, daarna een nette 429 met de wachttijd. Maximaal 1 MiB per verzoek. Onbekende velden worden geweigerd in plaats van stil genegeerd. Na 30 mislukte pogingen per minuut vanaf hetzelfde adres sluit de deur even. Alles hierover lees je bij beveiliging en privacy.

• Lezen, schrijven of beide over 24 onderdelen, plus Webhooks beheren
• Elke gebruiker maakt eigen sleutels, nooit boven zijn eigen rechten
• Alleen een eigenaar geeft een sleutel workspace:admin
• Sleutels beheren kan niet via MCP, alleen in het scherm
• 600 verzoeken per minuut, 1 MiB per verzoek, Idempotency-Key 24 uur

Niet elk team bouwt zijn eigen agent, en dat hoeft ook niet. Je kunt een agent ook configureren via de AI-assistent in Lumo. Je typt wat je wilt: "Als een lead een week zonder actie staat, maak dan een belafspraak voor de eigenaar voor vandaag." De assistent bouwt daar een automation van, met een trigger, voorwaarden en acties. Hij heeft daarvoor 52 gereedschappen: 21 om te lezen, 21 om een concept klaar te zetten en 10 die pas na jouw akkoord iets uitvoeren, zoals een automation aanzetten of een campagne versturen.

Die automation slaat hij altijd uit op. Daarna draait hij een test op een echt record uit je werkruimte en laat zien wat er zou gebeuren: Zou lopen of Zou niet lopen, met de reden. Er wordt bij die test niets opgeslagen of verstuurd. Klopt het, dan vraagt de assistent om je akkoord om de regel aan te zetten. Pas als jij op Akkoord, uitvoeren klikt, gaat hij aan.

Vanaf dat moment werkt de regel door, ook als niemand ingelogd is. De regels voor stilstaande deals en leads worden elk uur nagelopen. Dat is het soort agent dat de meeste teams eigenlijk zoeken: één die een afspraak onthoudt en hem elke dag uitvoert. Meer over wat de assistent verder kan, staat bij de AI-assistent.

• De assistent bouwt een automation uit een gewone zin
• Nieuwe regels staan altijd uit tot jij akkoord geeft
• Een test op een echt record schrijft en verstuurt niets
• Stilstandregels worden elk uur nagelopen

Het resultaat zie je niet in de agent, maar in de ochtend van je team. Wat je externe agents 's nachts hebben vastgelegd en wat je automations hebben ingepland, staat op Vandaag. Per persoon, met wat te laat is bovenaan. De accountmanager hoeft niet in een kanaal te zoeken wat de agent heeft bedacht. Het staat bij de klant.

Wat naar buiten gaat, gebeurt nooit ongemerkt. Een automation kan een mail uit een sjabloon sturen, vanuit de Gmail van de eigenaar van het record. Het bouwscherm waarschuwt dan dat dit echt een mail naar de persoon stuurt. Via MCP vraagt elke tool die mail verstuurt om confirm: true, en de assistent verstuurt een campagne pas na jouw akkoord. Wil je dat een mens het laatste woord heeft, laat een regel dan een taak "Verslag sturen" maken. Dan stuurt de accountmanager het verslag zelf.

En een stilstaande deal komt hoogstens één keer per week bij dezelfde regel aan de beurt. Een agent die elke nacht opnieuw dezelfde taak aanmaakt, overspoelt je team. Met Niet maken als er al zo'n open activiteit staat, voorkomt een regel dat ook bij dubbele aanroepen. Meer over de ritmes rond bellen en opvolgen lees je bij Cadence.

• Werk van agents en regels staat op Vandaag, per persoon
• Mail uit een automation gaat vanuit de Gmail van de eigenaar, met waarschuwing
• Een stilstaand record komt hoogstens één keer per week aan de beurt
• Een regel slaat over als er al een open activiteit staat