Waarom Attio het CRM is voor de AI-era
De meeste CRM-systemen zijn gebouwd in een tijd dat verkopers nog alles handmatig invulden. Salesforce, HubSpot, Pipedrive: stuk voor stuk krachtige tools, maar ontworpen rondom menselijke input. Attio is anders. Het is vanaf de grond opgebouwd met automatisering en AI als kern, niet als bijlage. Je kunt Attio koppelen aan AI-modellen zoals Claude via het MCP-protocol (Model Context Protocol), waardoor je CRM direct bedienbaar wordt via gewone taal. Geen formulieren meer, geen handmatig kopieer-plakwerk. Gewoon typen: 'Maak een deal aan voor Bedrijf X, 50.000 euro, sluitdatum eind september' en het gebeurt.
In deze handleiding bouw je stap voor stap een AI-gedreven CRM-opstelling: Attio als basis, Claude als je intelligente assistent, MCP als de brug ertussen, en n8n voor de automatiserings-workflows. Aan het einde heb je een systeem dat contacten aanmaakt, deals bijhoudt, follow-ups schrijft en je pipeline samenvat zonder dat jij er handmatig iets voor hoeft te doen.
Wat is MCP (Model Context Protocol) en waarom is dit de game-changer?
MCP staat voor Model Context Protocol. Het is een open standaard die Anthropic heeft gelanceerd waarmee AI-modellen zoals Claude directe toegang krijgen tot externe tools en data. Vergelijk het met een universele adapter: in plaats van voor elke tool een aparte integratie te bouwen, gebruik je MCP als gemeenschappelijke taal tussen je AI en je software.
Voor Attio betekent dit concreet: je installeert de Attio MCP Server op je computer, verbindt die met Claude Desktop, en Claude kan daarna je volledige CRM beheren. Contacten opzoeken, deals aanmaken, statussen updaten, notities toevoegen, alles via gewone zinnen. Dat is fundamenteel anders dan een chatbot die je vragen beantwoordt over je data. Claude voert acties uit in je echte CRM, in real-time.
Stap 1: Attio account aanmaken en inrichten
Ga naar attio.com en start een gratis trial. Je hebt geen creditcard nodig voor de eerste 14 dagen. Kies tijdens de onboarding voor 'Sales CRM' of 'Custom' als je workspace-type. Voor MKB-teams is de standaard sales-setup een goed startpunt.
Na het aanmaken van je workspace nodig je teamleden uit via Settings > Members. Attio werkt met drie standaard objects: People (persoonlijke contacten), Companies (bedrijven) en Deals (verkoopkansen). Je kunt objects aanpassen: extra velden toevoegen, velden verplicht maken, of nieuwe objects aanmaken voor bijvoorbeeld 'Partners' of 'Leveranciers'. Voor de meeste MKB-teams zijn de drie standaard objects meer dan genoeg.
Stel de pipeline in via Objects > Deals > Edit attributes. Voeg fases toe die passen bij je verkoopproces: Lead, Gekwalificeerd, Offerte verstuurd, Onderhandeling, Gewonnen, Verloren. Deze fases gebruik je straks ook als triggerpoints voor je automatiseringen.
Stap 2: Attio API Key aanmaken
Voor de koppeling met Claude en n8n heb je een API key nodig. Ga in Attio naar Settings > Developers > API keys. Klik op 'Create API key', geef hem een duidelijke naam (bijvoorbeeld 'Claude MCP' of 'n8n Workflows'), en stel de rechten in. Voor de meeste use cases heb je read en write rechten nodig op People, Companies en Deals.
Kopieer de key direct nadat je hem aanmaakt. Attio toont hem maar eenmalig. Sla hem op in een .env bestand in je projectmap, nooit hardcoded in scripts die je deelt of in git commit.
Als je werkt met meerdere omgevingen (development, productie), maak dan aparte API keys per omgeving. Zo kun je rechten per omgeving beperken en keys roteren zonder downtime.
Stap 3: Attio MCP Server installeren
De Attio MCP Server is een Node.js-pakket dat je lokaal draait als brug tussen Claude en Attio. Claude praat via het MCP-protocol met de server, en de server vertaalt die instructies naar Attio API-calls. Je hebt Node.js 18 of hoger nodig. Check je versie via:
Installeer de MCP server globaal via npm:
Na installatie configureer je de server door een configuratiebestand aan te maken voor Claude Desktop. Dit bestand vertelt Claude welke MCP-servers beschikbaar zijn en hoe die gestart moeten worden.
Stap 4: Claude Desktop koppelen aan Attio
Download Claude Desktop van claude.ai/download. Kies de versie voor je besturingssysteem (Mac of Windows). Na installatie open je de app en log je in met je Anthropic account.
Het MCP-configuratiebestand plaatst je op de volgende locatie:
Maak het bestand aan (of pas het aan als het al bestaat) met de JSON-configuratie uit stap 3. Vervang 'your_api_key_here' door je echte Attio API key. Herstart Claude Desktop volledig na het opslaan. Je kunt de verbinding testen door in Claude te typen: 'Hoeveel contacten heb ik in Attio?' Als de verbinding werkt, geeft Claude een concreet getal terug uit je Attio workspace.
In het linker paneel van Claude Desktop zie je na een succesvolle configuratie een klein icoon of indicator dat MCP-tools actief zijn. Klik erop om te zien welke Attio-acties beschikbaar zijn: contacten ophalen, deals aanmaken, notities toevoegen, enzovoort.
Stap 5: Basis AI-taken uitvoeren in Attio via Claude
Nu de koppeling staat, kun je Attio volledig bedienen via Claude. Hier zijn de meest gebruikte commando's voor dagelijks gebruik in een MKB salesteam.
Contact aanmaken: typ letterlijk 'Maak een nieuw contact aan: Jan Jansen, jan@bedrijf.nl, Bedrijf BV, telefoonnummer 06-12345678'. Claude maakt het contact aan in Attio, koppelt het automatisch aan het bedrijf als dat al bestaat, en bevestigt de actie met de details.
Deal aanmaken: 'Maak een deal aan voor Bedrijf BV, waarde 25.000 euro, fase Offerte verstuurd, sluitdatum 30 september 2026'. Claude koppelt de deal automatisch aan het bestaande bedrijf en de contactpersoon.
Status updaten: 'Update de deal met Bedrijf BV naar fase Gewonnen' of 'Zet de deal op Verloren en voeg toe als reden: prijs te hoog'. Notities toevoegen: 'Voeg een notitie toe aan Jan Jansen: meeting gehad op 1 augustus, interesse in premium pakket, follow-up volgende week'.
Stap 6: Attio API direct gebruiken (voor developers)
Naast de MCP-koppeling kun je de Attio REST API direct aanspreken vanuit je eigen code of scripts. Dit is handig voor bulkoperaties, custom dashboards, of integraties die buiten Claude om lopen.
De Attio API volgt de REST-standaard en retourneert JSON. Alle records hebben een unieke UUID die je gebruikt als referentie bij updates. Gebruik de GET /v2/objects/{object}/records endpoint om bestaande records op te halen voor je een update doet. Dit voorkomt duplicaten.
Stap 7: n8n koppelen aan Attio
n8n is een open-source automatiseringstool waarmee je workflows bouwt zonder te coderen. Attio heeft een native node in n8n, wat de integratie eenvoudig maakt. Installeer n8n lokaal via npm of gebruik n8n Cloud (cloud.n8n.io).
Voorbeeld workflow 1: Nieuwe lead via Typeform of Tally formulier automatisch als contact in Attio aanmaken. Trigger: Typeform submission. Actie: Attio > Create Record (People). Map de formuliervelden naar Attio-attributen (naam, e-mail, bedrijf).
Voorbeeld workflow 2: Deal gewonnen in Attio triggert een welkomstmail via Gmail en een Slack-notificatie. Trigger: Attio > Deal stage changed to 'Gewonnen'. Acties: Gmail > Send email, Slack > Send message.
Stap 8: AI-gestuurde lead scoring instellen
Attio heeft ingebouwde AI-features die automatisch velden kunnen vullen op basis van beschikbare data. Maar voor geavanceerdere lead scoring gebruik je Claude via MCP of n8n + OpenAI.
Maak eerst een custom veld aan in Attio: ga naar Objects > People > Edit attributes > Add attribute. Noem het 'AI Lead Score', type: Number (0-100). Dit veld update je via de API of n8n na elke Claude-analyse.
Gebruik de volgende prompt-template in Claude (via MCP of n8n AI-node) om een lead te scoren:
Verwerk de score in een n8n workflow: Attio trigger (nieuw contact) > Claude AI node (scoring prompt) > Attio update (schrijf score naar veld). Zo heeft elk nieuw contact binnen 30 seconden een lead score.
Stap 9: Automatische follow-up via AI + Attio
Een van de krachtigste automatiseringen: contacten die 7 dagen geen activiteit hebben gehad krijgen automatisch een gepersonaliseerde follow-up mail. Dit is de workflow:
1. n8n scheduled trigger: elke ochtend om 8:00 uur. 2. Attio filter: haal alle contacts op met laatste activiteit ouder dan 7 dagen en status 'Actief'. 3. Claude AI node: genereer per contact een persoonlijke follow-up mail op basis van naam, bedrijf, laatste notitie, en open deal. 4. Gmail node: stuur de mail vanuit het persoonlijke emailadres van de accountmanager. 5. Attio update: log de follow-up als activiteit bij het contact.
Attio Sequences kun je ook direct instellen voor geautomatiseerde e-mailreeksen zonder externe tools. Ga naar Sequences in Attio, maak een nieuwe sequence aan, en koppel die aan een deal-fase of contactattribuut. Attio stuurt automatisch e-mails na X dagen inactiviteit.
Stap 10: Dashboard en rapportage met AI
Attio heeft een ingebouwde reporting module. Ga naar Reports en maak views aan voor je sales pipeline: aantal deals per fase, totale pipeline waarde, gemiddelde deal-duur, win rate per accountmanager. Sla deze views op als favorieten voor dagelijks gebruik.
Voor team-meetings gebruik je de AI-samenvatting via Claude. Vraag in Claude (met MCP actief): 'Geef me een samenvatting van mijn open deals, gesorteerd op waarde. Welke deals lopen risico en waarom?' Claude analyseert je pipeline en geeft concrete aanbevelingen: deals zonder recente activiteit, deals die al langer dan gemiddeld in een fase zitten, of contacten die een follow-up verdienen.
Je kunt ook een wekelijks rapport automatiseren via n8n: elke vrijdag om 16:00 vraagt n8n via de Attio API alle open deals op, stuurt die naar Claude voor analyse, en mailt het rapport naar het management. Volledig automatisch, altijd actueel.
Troubleshooting: 5 veelvoorkomende problemen
1. MCP server start niet op
Probleem: 'attio-mcp: command not found' of de server crasht direct na opstarten. Oplossing: Controleer je Node.js versie (minimaal 18). Als je nvm gebruikt: 'nvm use 20'. Controleer ook het pad van de global npm installatie: 'npm root -g'. Zorg dat dit pad in je PATH-variabele staat. Op macOS voeg je dit toe aan ~/.zshrc: export PATH="$(npm root -g)/../.bin:$PATH"
2. Claude ziet Attio tools niet
Probleem: Claude reageert alsof hij geen Attio-tools heeft, of zegt 'I don't have access to Attio'. Oplossing: Controleer het pad van je claude_desktop_config.json (let op hoofdletters in de mapnaam). Herstart Claude Desktop volledig (niet alleen het venster sluiten, maar de app helemaal afsluiten). Controleer via 'cat ~/.claude/claude_desktop_config.json' of het bestand correct is opgeslagen.
3. API rate limits (429 error) bij grote imports
Probleem: Bij het importeren van honderden contacten krijg je 429 Too Many Requests errors. Oplossing: Attio heeft rate limits per API key. Voeg een delay toe tussen requests: 'time.sleep(0.5)' tussen elke API-call in Python. Of gebruik de Attio CSV import functie voor bulkimports via Settings > Import. Die heeft geen API rate limits.
4. Duplicaten bij contactimport
Probleem: Contacten worden meerdere keren aangemaakt bij herhaalde imports of syncs. Oplossing: Gebruik de Attio 'upsert' functionaliteit via de API. Zoek eerst op e-mailadres voor je een nieuw contact aanmaakt. Als het e-mailadres al bestaat, update dan het bestaande record in plaats van een nieuw aan te maken. In n8n gebruik je de 'Update or Create' operatie in de Attio node.
5. Rechten-fout bij deals aanmaken (scope ontbreekt)
Probleem: 'Forbidden' of 'Insufficient scope' error bij het aanmaken of updaten van deals. Oplossing: Je API key heeft niet de juiste rechten. Ga naar Settings > API keys, verwijder de oude key, en maak een nieuwe aan met expliciet 'write' rechten op Deals. Sommige Attio plans beperken API-rechten op specifieke objects. Controleer ook je Attio abonnement: de gratis trial heeft beperkte API-toegang.
Uitbreidingen en vervolgstappen
Nu je de basis staat, zijn hier vier krachtige uitbreidingen die je direct kunt implementeren:
Attio + Slack: Stuur automatisch een Slack-bericht naar je sales-kanaal als een deal gewonnen wordt of als een grote deal (boven een bepaald bedrag) de Offerte-fase bereikt. Bouw dit als n8n workflow met Attio trigger en Slack node. Zo weet het hele team direct van elke commerciele succes.
Attio + Calendly: Koppel je Calendly account via n8n aan Attio. Als iemand een meeting boekt, maakt n8n automatisch een contact aan in Attio (als die er nog niet is) en logt de meeting als activiteit. Na de meeting trigger je een Claude-prompt om een samenvatting te schrijven op basis van de meeting-notes.
Attio + e-mail inbox: Via n8n kun je inkomende e-mails analyseren. Als iemand een e-mail stuurt die niet als contact in Attio staat, maakt n8n automatisch een nieuw contact aan. Claude analyseert de e-mail en voegt relevante tags of notities toe: 'interesse in product X', 'vraag over prijs'.
Meerdere AI-modellen: Je hoeft niet uitsluitend op Claude MCP te vertrouwen. Via n8n kun je ook OpenAI of Google Gemini gebruiken als AI-laag. Dit is handig als je specifieke taken wilt verdelen: Claude voor lange analyses en schrijftaken, GPT-4o voor snelle classificaties en lead scoring. Gebruik de AI-node in n8n om te wisselen tussen modellen.
Conclusie: Attio + AI is je concurrentievoordeel
Attio is het CRM dat echt gebouwd is voor hoe we in 2026 werken: AI-gedreven, flexibel, en verbonden met de rest van je werkstroom. De combinatie van Attio, Claude via MCP, en n8n geeft je een volledig geautomatiseerd CRM-systeem dat loopt terwijl jij je focust op wat telt: echte gesprekken met klanten en strategische beslissingen.
Voor MKB-teams is dit geen technologie van de toekomst meer. Je kunt dit vandaag opzetten, met gratis tools (Attio trial, Claude free tier, n8n open-source), en binnen een dag een werkend systeem hebben. Begin klein: installeer de MCP server, test een paar commando's in Claude, en voeg stap voor stap automatiseringen toe. Voor je het weet, beheert je AI je CRM voor je.
