Introductie
Met de MCP-koppeling kan je een MCP-client, zoals Claude of ChatGPT, verbinden met Zenvoices. Elke gebruiker koppelt de eigen MCP-client en logt in met het eigen Zenvoices-account. De MCP-client heeft alleen toegang tot gegevens die de gebruiker in Zenvoices al kan zien. Dit artikel is bedoeld voor gebruikers die een MCP-client willen koppelen en voor beheerders die de koppeling beschikbaar maken.
Voordat je begint
Niemand heeft standaard rechten voor de MCP-koppeling. Een beheerder kent daarom eerst de rechten toe aan de rollen of gebruikers die een MCP-client mogen koppelen. Zie het kopje 'Gebruikersrechten' voor alle rechten die bij de MCP-koppeling horen.
Verbinding maken met de MCP-koppeling
Je maakt als volgt verbinding:
Vraag aan je beheerder om het MCP-koppeladres, of kopieer het zelf via Beheer / Omgeving / MCP als je daar toegang toe hebt.
Open je MCP-client en voeg een nieuwe MCP-server of connector toe.
Plak het MCP-koppeladres in je MCP-client.
Log op de inlogpagina van Zenvoices in met je eigen account, zoals in onderstaande afbeelding.
Controleer de gevraagde toestemmingen en keur deze goed als je akkoord bent.
De koppeling blijft 90 dagen actief. Daarna moet je de koppeling opnieuw goedkeuren.
Beschikbare tools
Na het koppelen kan je MCP-client de volgende tools gebruiken, afhankelijk van de rechten die je hebt. Achter elke tool staat de technische naam waaronder de tool in je MCP-client verschijnt.
Account en rechten bekijken (
whoami): bekijk met welk account de koppeling werkt, welke administratie geselecteerd is en welke rechten je hebt.Administraties ophalen (
companies_get): bekijk de administraties waar je toegang toe hebt. Je kan ook zoeken op naam of code van een administratie.Administratie kiezen (
select_company): kies de administratie waarin je wilt werken. Deze keuze blijft bewaard tot je een andere administratie kiest.Boekingen doorzoeken (
archive_transactions_search): zoek in het boekingenarchief, bijvoorbeeld op leverancier, factuurnummer, bedrag, datum of boekjaar. Dit omvat inkoopfacturen, memoriaalboekingen en archiefboekingen.Documenten doorzoeken (
archive_documents_search): zoek in het document management archief, bijvoorbeeld naar contracten en andere opgeslagen documenten. Dit werkt alleen in administraties waarin de module document management is ingeschakeld.Boekingsdetails raadplegen (
transaction_get): bekijk de details van één boeking, waaronder boekingsregels, btw, bijlagen, betalingen, autorisatiehistorie en opmerkingen. Je ziet ook welke automatiseringsregels zijn toegepast, hoe het boekingsvoorstel tot stand kwam en of de boeking al is geëxporteerd.Te autoriseren boekingen ophalen (
transactions_for_authorisation_get): haal de boekingen op die momenteel op jouw autorisatie wachten.
Let op: je MCP-client toont alleen de tools waarvoor jij het gebruikersrecht hebt. Ontbreekt een tool, vraag dan aan je beheerder of jouw rol het bijbehorende recht heeft.
Binnenkort beschikbaar
We werken aan een volgende versie van de MCP-koppeling. Daarin komen de volgende tools beschikbaar:
Automatiseringsregels en boekingsregels beheren
Details ophalen van documenten uit document management
Documenten aanleveren voor uploaden & inlezen
Relatie (crediteur/debiteur) gegevens ophalen
Document herkenning uitvoeren
Goedgekeurde verbindingen bekijken
Beheerders zien de goedgekeurde verbindingen via Beheer / Omgeving / MCP, bij 'MCP-clients'.
MCP-koppeladres beheren
Beheerders vinden het MCP-koppeladres via Beheer / Omgeving / MCP. Hier kan je het adres kopiëren en delen met de gebruikers die het nodig hebben. Je kan hier ook een nieuw MCP-koppeladres genereren.
Gebruikersrechten
Voor de MCP-koppeling gelden twee soorten rechten. Het recht 'MCP-koppeling' geeft toegang tot de MCP-koppeling. Daarnaast geeft een beheerder toegang tot specifieke tools via de rechten hieronder. Een gebruiker kan alleen de tools gebruiken waarvoor het bijbehorende recht is toegekend.
Rechten voor gebruikers
MCP-koppeling: toegang tot de MCP-koppeling.
MCP-koppeling | Archief | Zoeken in boekingen: gebruik de tool 'Boekingen doorzoeken'.
MCP-koppeling | Archief | Zoeken in documenten: gebruik de tool 'Documenten doorzoeken'.
MCP-koppeling | Boekingen | Boekingsdetails: gebruik de tool 'Boekingsdetails raadplegen'.
MCP-koppeling | Boekingen | Te autoriseren boekingen: gebruik de tool 'Te autoriseren boekingen ophalen'.
Rechten voor beheerders
Pagina's | Beheer | Omgeving | MCP: toegang tot de pagina voor de MCP-koppeling.
Pagina's | Beheer | Omgeving | MCP | MCP-clients: de goedgekeurde verbindingen bekijken.
Pagina's | Beheer | Omgeving | MCP | MCP-koppeling: toegang tot het MCP-koppeladres.
Pagina's | Beheer | Omgeving | MCP | MCP-koppeling | Nieuw MCP-koppeladres genereren: een nieuw MCP-koppeladres genereren.
Aandachtspunten
Het MCP-koppeladres geldt voor alle gebruikers in de omgeving.
Genereer je een nieuw MCP-koppeladres, dan moeten alle gebruikers in de omgeving de MCP-koppeling opnieuw autoriseren.
De koppeling blijft 90 dagen actief. Daarna moet elke gebruiker de koppeling opnieuw goedkeuren.
Een MCP-client komt alleen bij gegevens die de gebruiker zelf in Zenvoices kan zien.
Toegang tot de MCP-koppeling geeft niet automatisch toegang tot alle tools. Per tool moet het bijbehorende recht worden toegekend.
Veelgestelde vragen
Waarom kan ik geen verbinding maken met de MCP-koppeling?
Je kan geen verbinding maken met de MCP-koppeling als een beheerder je nog geen rechten voor de MCP-koppeling heeft gegeven. Niemand heeft deze rechten standaard. Vraag aan je beheerder om de rechten aan jouw rol of account toe te kennen.
Welke gegevens kan mijn MCP-client zien via de MCP-koppeling?
Je MCP-client kan via de MCP-koppeling alleen gegevens zien die jij in Zenvoices al kan zien. Welke tools beschikbaar zijn, hangt af van jouw gebruikersrechten.
Komen er nog meer mogelijkheden bij de MCP-koppeling?
Ja, de MCP-koppeling krijgt nog meer mogelijkheden. De tools die in de volgende versie beschikbaar komen, staan bij het kopje ‘Binnenkort beschikbaar’. Ook daarna blijven we de MCP-koppeling verder ontwikkelen.
Hoe kan ik een wens voor de MCP-koppeling doorgeven?
Een wens voor de MCP-koppeling geef je door via de feedbackpagina in Zenvoices. Klik in je omgeving rechtsboven op je gebruikersnaam en kies ‘Feedback geven’. Je kan ook een mail sturen naar support@zenvoices.com. Zo nemen we jouw wens mee in de verdere ontwikkeling.
Trefwoorden: MCP, MCP-koppeling, MCP-client, MCP-koppeladres, connector, AI-assistent, LLM