MCP

MCP voor je administratie

Verbind een ondersteunde AI-client met Admillio. Raadpleeg gegevens en voer beschikbare handelingen uit binnen je rechten. MCP is onderdeel van Business.

Claude en ChatGPT: inloggen, geen code
Cursor en VS Code met één knop
Lezen én schrijven: facturen, bonnen, rapportages

Probeer 30 dagen gratis Alle functies

AI-koppelingen (MCP)

Bijvoorbeeld

Wat is mijn openstaande debiteuren-saldo?
Toon de openstaande bonnen van deze maand.
Maak een conceptfactuur voor Acme van €1.500 excl. 21% BTW.
Zoek uitgaven van vorige maand zonder grootboekrekening.
Bereken mijn concept-BTW-aangifte voor dit kwartaal.

Wat je ermee kan

Ondersteunde handelingen, binnen je toegangsrechten.

Binnen de administraties waarvoor je toestemming hebt. De beschikbare functies hangen af van rechten en pakket.

Verkoop

Contacten opzoeken, aanmaken en bijwerken
Conceptfacturen maken, bijwerken en versturen
Een betaling registreren of een creditnota maken
Offertes maken, versturen en omzetten naar factuur

Inkoop

Uitgaven en bonnen opvragen
Een nieuwe uitgave boeken of categoriseren
Controleren of een bon al bestaat

Bank

Rekeningen en transacties inzien
Transacties matchen aan facturen of uitgaven

Rapportages

Dashboardtotalen en recente activiteit
Winst-en-verliesrekening en balans
Openstaande posten (debiteuren en crediteuren)
Concept-BTW-aangifte, indienen blijft handmatig

Grootboek & uren

Journaalregels en memoriaalboekingen aanmaken
Uren registreren

Koppelen

Zo koppel je Admillio.

Claude en ChatGPT koppel je door in te loggen, zonder code. Cursor en VS Code met één knop, Claude Code met één commando.

Claude of ChatGPT: plak de link

Ga in Claude of ChatGPT naar Connectors, kies "Aangepaste connector" en plak https://admillio.com/api/mcp. Je logt in bij Admillio, klikt op Toestaan en de koppeling staat.

Cursor, VS Code of Claude Code: één klik

Log in, ga naar Instellingen → AI-koppelingen en kies je app. Cursor en VS Code openen vanzelf; voor Claude Code krijg je een commando om te plakken.

Zelf instellen

Voor andere apps

Werkt je app met een sleutel in plaats van inloggen? Maak er een bij Instellingen → AI-koppelingen en plak deze instellingen.

mcp.json (Cursor)

{
  "mcpServers": {
    "admillio": {
      "url": "https://admillio.com/api/mcp",
      "headers": {
        "Authorization": "Bearer admillio_mcp_..."
      }
    }
  }
}

Claude Code

claude mcp add --transport http admillio https://admillio.com/api/mcp --header "Authorization: Bearer admillio_mcp_..."

Link: https://admillio.com/api/mcp
Sleutel: Het admillio_mcp_... token uit Instellingen → AI-koppelingen

Niets te installeren. Altijd de laatste versie.

Lokaal via npm

Voor de Claude-app op je computer via het configuratiebestand, of als je de server zelf wilt draaien. Vereist Node.js 20 of hoger. Open source, Apache-2.0.

claude_desktop_config.json

{
  "mcpServers": {
    "admillio": {
      "command": "npx",
      "args": ["-y", "@admillio-app/mcp-server@latest"],
      "env": {
        "ADMILLIO_BASE_URL": "https://admillio.com",
        "ADMILLIO_AUTH_TOKEN": "admillio_mcp_..."
      }
    }
  }
}

ADMILLIO_BASE_URL: https://admillio.com
ADMILLIO_AUTH_TOKEN: Het admillio_mcp_... token uit Instellingen → AI-koppelingen

@admillio-app/mcp-server op npm

Wat kan de AI in Admillio?

68 tools in zeven onderdelen en voor boekhoudkantoren nog 12 kantoortools. Lezen verandert niets; schrijven maakt, wijzigt of verstuurt iets, altijd binnen wat jij in Admillio mag.

Verkoop

40 tools · 16 lezen · 24 schrijven

Klanten, facturen en offertes maken en versturen, betalingen, aanbetalingen, abonnementen en automatische incasso.

Alle 40 tools

list_contactsLezenJe klanten en leveranciers opzoeken en tonen.
get_contactLezenDe gegevens van één klant of leverancier bekijken.
get_contact_overviewLezenPer klant of leverancier de facturen, uitgaven, offertes en totalen zien.
create_contactSchrijvenEen nieuwe klant of leverancier toevoegen.
update_contactSchrijvenGegevens van een klant of leverancier wijzigen.
delete_contactSchrijvenKlanten of leveranciers verwijderen; hun facturen en uitgaven blijven bestaan.
list_sales_invoicesLezenJe verkoopfacturen tonen, bijvoorbeeld alle onbetaalde of die van één klant.
get_sales_invoiceLezenEén verkoopfactuur met alle regels bekijken.
create_sales_invoiceSchrijvenEen conceptfactuur maken; Admillio kiest het factuurnummer en rekent de btw uit.
update_sales_invoiceSchrijvenEen conceptfactuur aanpassen: datums, klant, opmerking of regels.
register_paymentSchrijvenEen ontvangen (deel)betaling op een factuur boeken.
send_sales_invoiceSchrijvenEen factuur per e-mail naar de klant sturen.
credit_sales_invoiceSchrijvenEen creditnota maken voor een verstuurde factuur.
copy_sales_invoiceSchrijvenEen factuur kopiëren als nieuw concept.
delete_sales_invoiceSchrijvenEen conceptfactuur verwijderen (verstuurde facturen niet).
get_next_invoice_numberLezenHet volgende factuurnummer opvragen.
send_invoice_reminderSchrijvenEen betalingsherinnering sturen voor een openstaande factuur.
list_quotesLezenJe offertes tonen, bijvoorbeeld de openstaande of geaccepteerde.
get_quoteLezenEén offerte bekijken.
get_next_quote_numberLezenHet volgende offertenummer opvragen.
create_quoteSchrijvenEen conceptofferte maken.
update_quoteSchrijvenEen offerte aanpassen.
send_quoteSchrijvenEen offerte met pdf per e-mail naar de klant sturen.
reopen_rejected_quoteSchrijvenEen afgewezen offerte weer openzetten, met 30 dagen extra geldigheid.
convert_quote_to_invoiceSchrijvenEen offerte omzetten in een conceptfactuur; de offerte wordt geaccepteerd.
create_down_payment_invoiceSchrijvenEen aanbetalingsfactuur maken voor een offerte, als percentage of bedrag.
create_final_invoiceSchrijvenDe eindfactuur van een offerte maken, met de aanbetalingen verrekend.
delete_quoteSchrijvenEen offerte verwijderen.
list_workflowsLezenJe workflows bekijken: betaaltermijn, herinneringen en incasso per soort.
list_extra_fieldsLezenJe eigen velden voor contacten, facturen en offertes bekijken.
list_recurring_invoicesLezenJe periodieke facturen (abonnementen) tonen, met volgende factuurdatum en status.
get_subscriptionLezen · Business (automatische incasso)Details van een abonnement met automatische incasso: machtiging, opzegtermijn en logboek.
cancel_subscriptionSchrijven · Business (automatische incasso)Een abonnement opzeggen: per einde periode, op een datum of direct.
resume_subscriptionSchrijven · Business (automatische incasso)Een gepauzeerd abonnement hervatten.
get_invoice_direct_debitLezen · Business (automatische incasso)Zien hoe de automatische incasso van een factuur ervoor staat.
cancel_invoice_direct_debitSchrijven · Business (automatische incasso)Een geplande afschrijving van een factuur annuleren.
retry_invoice_direct_debitSchrijven · Business (automatische incasso)Een mislukte of teruggeboekte afschrijving opnieuw plannen.
list_mandatesLezen · Business (automatische incasso)De incassomachtigingen van een klant bekijken.
revoke_mandateSchrijven · Business (automatische incasso)Een incassomachtiging intrekken.
list_productsLezenJe producten met prijs en btw tonen.

Inkoop

8 tools · 4 lezen · 4 schrijven

Uitgaven en bonnen toevoegen, controleren op dubbel, een kostenrekening kiezen en boeken.

Alle 8 tools

list_expensesLezenJe uitgaven, inkoopfacturen en bonnen tonen, per periode of status.
get_expenseLezenEén uitgave bekijken.
create_expenseSchrijvenEen uitgave of bon toevoegen. Met het recht boeken meteen goedgekeurd en geboekt, anders staat hij op te verwerken.
update_expenseSchrijvenEen uitgave aanpassen of goedkeuren.
categorize_expenseSchrijvenEen kostenrekening aan een uitgave toewijzen (en herboeken).
delete_expenseSchrijvenEen uitgave met zijn boekingen verwijderen (niet in een ingediende btw-periode).
check_duplicate_expenseLezenControleren of een inkoopfactuur al geboekt is.
suggest_ledger_for_expenseLezenEen voorstel voor de kostenrekening van een uitgave vragen; boekt niets.

Bank

5 tools · 3 lezen · 2 schrijven

Rekeningen en transacties bekijken, koppelen aan facturen en uitgaven en boeken met voorstellen.

Alle 5 tools

list_bank_accountsLezenJe bankrekeningen tonen.
list_bank_transactionsLezenBanktransacties tonen en zoeken, bijvoorbeeld de nog niet verwerkte.
suggest_ledger_for_transactionLezenEen boekingsvoorstel voor een banktransactie vragen; boekt niets.
match_bank_transactionSchrijvenEen banktransactie aan een factuur of uitgave koppelen, of op een grootboekrekening boeken.
rematch_bank_transactionsSchrijvenAlle open transacties opnieuw laten koppelen en boeken volgens je vaste regels.

Grootboek

4 tools · 2 lezen · 2 schrijven

Rekeningschema en journaalposten bekijken, journaal- en memoriaalboekingen maken.

Alle 4 tools

list_ledger_accountsLezen · Pro (boekhouden)Je rekeningschema (grootboekrekeningen) bekijken.
list_journal_entriesLezen · Pro (boekhouden)Journaalposten (boekingen) in een periode bekijken.
create_journal_entrySchrijven · Pro (boekhouden)Een journaalpost boeken (debet gelijk aan credit).
create_memorial_entrySchrijven · Pro (boekhouden)Een memoriaalboeking (correctie) maken, met btw-splitsing per regel.

Uren

2 tools · 1 lezen · 1 schrijven

Uren bekijken en registreren.

Alle 2 tools

list_time_entriesLezenJe geregistreerde uren in een periode tonen.
create_time_entrySchrijvenGewerkte uren registreren.

Rapportages

6 tools · 6 lezen · 0 schrijven

Dashboard, winst en verlies, balans, openstaande posten en de btw-aangifte berekenen.

Alle 6 tools

get_dashboard_statsLezenOverzicht van deze maand: omzet, uitgaven, openstaande facturen en btw.
get_income_statementLezenWinst-en-verliesrekening over een periode.
get_balance_sheetLezenBalans per datum.
get_outstanding_invoicesLezenWie jou nog moet betalen en wie jij nog moet betalen.
calculate_vat_returnLezen · Pro (btw-aangifte)De btw-aangifte van een periode berekenen; indienen blijft handmatig.
list_vat_submissionsLezen · Pro (btw-aangifte)Je ingediende btw-aangiftes bekijken.

Instellingen

3 tools · 3 lezen · 0 schrijven

Bedrijfsgegevens, meldingen en zoeken door je hele administratie.

Alle 3 tools

get_profileLezenJe bedrijfsgegevens bekijken: naam, KvK, btw-nummer, adres en pakket.
list_notificationsLezenJe meldingen bekijken.
global_searchLezenZoeken door je hele administratie: facturen, klanten, uitgaven en offertes.

Kantoor

12 tools · 8 lezen · 4 schrijven

Alleen met een kantoorkoppeling: je klanten, de samenwerking-inbox over alle klanten, berichten, verzoeken en documenten per klant, deadlines, kantooruren en interne taken.

Alle 12 tools

list_clientsLezenDe klanten waar je via de koppeling bij mag, met je rechten en hun pakket. De AI begint hiermee.
kantoor_inboxLezenSamenwerking-inbox over alle klanten: ongelezen berichten, beantwoorde verzoeken en interne taken.
list_client_messagesLezen · Business (samenwerken)Het gesprek met één klant lezen.
send_client_messageSchrijven · Business (samenwerken)Een bericht aan één klant sturen, op jouw naam (niet meer als je toegang afloopt).
list_client_requestsLezen · Business (samenwerken)Verzoeken aan één klant bekijken, met status.
create_client_requestSchrijven · Business (samenwerken)Eén klant iets vragen, om een document of om een ontbrekende bon (niet meer als je toegang afloopt).
list_client_documentsLezen · Business (samenwerken)Gedeelde documenten van één klant bekijken.
list_kantoor_tasksLezenInterne taken van het kantoor: aan mij, door mij, niet verdeeld of alles.
complete_kantoor_taskSchrijvenEen interne taak op klaar (of open of bezig) zetten.
list_deadlinesLezenDeadline-overzicht: per klant de status van de standaardtaken, zoals de btw-aangifte.
list_kantoor_hoursLezenUren van het kantoor op klanten (niet de uren in de administratie van de klant).
log_kantoor_hoursSchrijvenUren van het kantoor schrijven op één klant, om later te factureren.

Een eigen koppeling werkt met het Business-pakket, waarin alles zit. Werkt je boekhoudkantoor via een kantoorkoppeling in je administratie, dan gelden jouw pakket (Pro of Business bij een tool) en de rechten die je het kantoor gaf. Btw-aangifte indienen en geld terugbetalen kan bewust niet via de AI.

Instellingen per app

Precies wat je waar invult. Vervang admillio_mcp_... door je eigen sleutel uit Instellingen → AI-koppelingen. Kan de app inloggen (OAuth), dan heb je geen sleutel nodig.

Claude (claude.ai en de Claude-app)

Instellingen → Connectors → Aangepaste connector toevoegen. Naam Admillio, URL https://admillio.com/api/mcp, geavanceerde instellingen leeg. Klik op Verbinden, log in bij Admillio en klik op Toestaan. Bij Claude Team of Enterprise voegt een beheerder de connector eerst toe onder Organisatie-instellingen → Connectors.

URL

https://admillio.com/api/mcp

ChatGPT

Zet de ontwikkelaarsmodus aan (Instellingen → Apps → Geavanceerd) en maak een connector met https://admillio.com/api/mcp en OAuth als manier van inloggen. ChatGPT stuurt je naar Admillio om toestemming te geven. ChatGPT werkt alleen remote en alleen met inloggen: geen sleutel, geen npm-pakket.

URL

https://admillio.com/api/mcp

Cursor

In ~/.cursor/mcp.json (alle projecten) of .cursor/mcp.json (één project). Laat je de headers weg, dan logt Cursor in via OAuth.

~/.cursor/mcp.json

{
  "mcpServers": {
    "admillio": {
      "url": "https://admillio.com/api/mcp",
      "headers": {
        "Authorization": "Bearer admillio_mcp_..."
      }
    }
  }
}

VS Code (GitHub Copilot, agent-modus)

In .vscode/mcp.json of je gebruikersconfiguratie (MCP: Open User Configuration). Let op: hier heet het blok "servers", niet "mcpServers". VS Code vraagt de sleutel één keer en bewaart hem versleuteld.

.vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "admillio-token",
      "description": "Admillio MCP-sleutel (admillio_mcp_...)",
      "password": true
    }
  ],
  "servers": {
    "admillio": {
      "type": "http",
      "url": "https://admillio.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:admillio-token}"
      }
    }
  }
}

Claude Code

Met een sleutel (eerste commando), of zonder sleutel: voeg de server toe en log daarna in met /mcp in Claude Code. Met -s user werkt hij in al je projecten.

Claude Code

claude mcp add --transport http admillio https://admillio.com/api/mcp --header "Authorization: Bearer admillio_mcp_..."

Claude Code (OAuth)

claude mcp add --transport http admillio https://admillio.com/api/mcp

Codex (OpenAI)

Inloggen via OAuth met twee commando's. Of zet de sleutel in de omgevingsvariabele ADMILLIO_TOKEN en gebruik ~/.codex/config.toml.

Codex (OAuth)

codex mcp add admillio --url https://admillio.com/api/mcp
codex mcp login admillio

~/.codex/config.toml

[mcp_servers.admillio]
url = "https://admillio.com/api/mcp"
bearer_token_env_var = "ADMILLIO_TOKEN"

Claude-app via het configuratiebestand

claude_desktop_config.json kent alleen lokale servers: gebruik daar het npm-pakket (Lokaal via npm, hierboven), of koppel via Connectors.

claude_desktop_config.json

{
  "mcpServers": {
    "admillio": {
      "command": "npx",
      "args": ["-y", "@admillio-app/mcp-server@latest"],
      "env": {
        "ADMILLIO_BASE_URL": "https://admillio.com",
        "ADMILLIO_AUTH_TOKEN": "admillio_mcp_..."
      }
    }
  }
}

Andere MCP-clients: Windsurf, Zed, Gemini CLI, Continue

Elke client met Streamable HTTP werkt met de URL en de header Authorization: Bearer admillio_mcp_..., of logt zelf in via OAuth als je de header weglaat. Kent een client alleen lokale (stdio) servers, gebruik dan het npm-pakket.

Windsurf: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "admillio": {
      "serverUrl": "https://admillio.com/api/mcp",
      "headers": {
        "Authorization": "Bearer admillio_mcp_..."
      }
    }
  }
}

Zed: settings.json

{
  "context_servers": {
    "admillio": {
      "url": "https://admillio.com/api/mcp",
      "headers": {
        "Authorization": "Bearer admillio_mcp_..."
      }
    }
  }
}

Gemini CLI: ~/.gemini/settings.json

{
  "mcpServers": {
    "admillio": {
      "httpUrl": "https://admillio.com/api/mcp",
      "headers": {
        "Authorization": "Bearer admillio_mcp_..."
      }
    }
  }
}

Continue: .continue/mcpServers/admillio.yaml

name: Admillio
version: 0.0.1
schema: v1
mcpServers:
  - name: Admillio
    type: streamable-http
    url: https://admillio.com/api/mcp
    requestOptions:
      headers:
        Authorization: Bearer ${{ secrets.ADMILLIO_TOKEN }}

Voor boekhoudkantoren: één koppeling voor al je klanten

Met een kantoorkoppeling werkt de AI in alle klanten van je kantoor waar jij bij mag. Hij kiest per vraag de klant (administratie_id) en per klant gelden de rechten die die klant en je kantoor je gaven. Daarbij krijg je de kantoortools: de samenwerking-inbox over alle klanten, berichten, verzoeken en documenten per klant, deadlines, kantooruren en interne taken.

Claude, ChatGPT en Codex: dezelfde link https://admillio.com/api/mcp. Kies bij het inloggen bij Admillio "Alle klanten van je kantoor".
Andere apps: maak een kantoortoken bij Kantoor → MCP-koppeling en gebruik hem als Bearer-sleutel, net als hierboven.
Kent je app alleen lokale servers (zoals het configuratiebestand van de Claude-app)? Gebruik dan het pakket @admillio-app/mcp-office-server. Dat stuurt alles door naar de server; de controles gebeuren daar.

mcp.json (Cursor, Windsurf, ...)

{
  "mcpServers": {
    "admillio-kantoor": {
      "url": "https://admillio.com/api/mcp",
      "headers": {
        "Authorization": "Bearer admillio_mcp_... (kantoortoken)"
      }
    }
  }
}

claude_desktop_config.json (@admillio-app/mcp-office-server)

{
  "mcpServers": {
    "admillio-kantoor": {
      "command": "npx",
      "args": ["-y", "@admillio-app/mcp-office-server@latest"],
      "env": {
        "ADMILLIO_KANTOOR_TOKEN": "admillio_mcp_..."
      }
    }
  }
}

Claude Code

claude mcp add --transport http admillio-kantoor https://admillio.com/api/mcp --header "Authorization: Bearer admillio_mcp_..."
# of lokaal via npm:
claude mcp add --transport stdio admillio-kantoor --env ADMILLIO_KANTOOR_TOKEN=admillio_mcp_... -- npx -y @admillio-app/mcp-office-server@latest

~/.codex/config.toml

[mcp_servers.admillio-kantoor]
url = "https://admillio.com/api/mcp"
bearer_token_env_var = "ADMILLIO_KANTOOR_TOKEN"

Twee pakketten: @admillio-app/mcp-server is voor één administratie (je eigen bedrijf), @admillio-app/mcp-office-server voor een kantoor. Een kantoortoken werkt niet in het eerste, een gewone sleutel niet in het tweede.

@admillio-app/mcp-office-server op npm @admillio-app/mcp-server op npm

Veiligheid

Een koppeling mag precies wat jij in Admillio mag, niet meer. Een gewone koppeling ziet alleen die ene administratie en nooit kantoorfuncties.
Een kantoorkoppeling ziet alleen klanten die aan jou zijn toegewezen, met lopende toegang. Per klant gelden de rechten van de klant en van je kantoor en een klant kan AI-koppelingen van zijn kantoor uitzetten.
De server controleert elke aanroep opnieuw. Ga je weg bij het kantoor of eindigt de samenwerking met een klant, dan werkt het meteen niet meer.
Ook het npm-pakket (lokaal) komt nooit rechtstreeks bij de database: het krijgt alleen een sleutel van een paar minuten die uitsluitend bij de server van Admillio werkt, waar elke aanroep langs dezelfde controles gaat (onderdelen, alleen lezen, die ene administratie).
Wat de AI doet, gebeurt op jouw naam. Per koppeling zie je wanneer hij het laatst is gebruikt en de aanroepen worden gelogd (welke koppeling, welke tool, welke administratie; niet de inhoud).
Plak een sleutel nooit in een chat, e-mail of gedeelde repository. Gebruik een omgevingsvariabele of het wachtwoordveld van je app.
Trek een koppeling in zodra je hem niet meer gebruikt of denkt dat de sleutel is uitgelekt en maak een nieuwe. Vervang sleutels regelmatig.

Rechten en controle

Een koppeling verleent toegang volgens de ingestelde rechten. Controleer welke acties je vraagt, vooral bij verzenden of wijzigen. Je kunt toegang intrekken.

Praktische uitleg bij deze functie

Hoe verbind je een AI-assistent met je boekhouding via MCP?MCP geeft een ondersteunde AI-client toegang tot beschikbare handelingen. Controleer de administratie, rechten en uitkomst.Lees de uitleg Wat kun je met AI in je boekhouding?Laat een assistent helpen met vragen, documenten en concepten. Controleer de administratie waarop het antwoord is gebaseerd.Lees de uitleg Eenmanszaak of bv: wat past bij jou?Een eenmanszaak is eenvoudig en vaak gunstig bij een lagere winst. Een bv scheidt risico's en wordt interessant bij een hogere, stabiele winst.Lees de uitleg

Ontdek meer van Admillio

AssistentJe boekhoudassistent werkt met je eigen cijfers.Bekijk

Samenwerken & teamJe boekhouder en collega's in één administratieBekijk

Facturen & offertesOnline facturen makenBekijk

Klaar voor meer overzicht?

30 dagen gratis, zonder creditcard. Opzeggen wanneer je wilt.

Probeer 30 dagen gratis