Naar de hoofdinhoud

Verbind je AI-assistent met Moss MCP

Introductie van Moss MCP: zo verbind je de data van je Moss-organisatie met de AI-assistent van je keuze.

Geschreven door Rosanna Howard

De MCP-server (Model Context Protocol) van Moss geeft AI-assistenten zoals Claude en ChatGPT toegang tot je Moss-data. Zo kun je via je AI-assistent vragen stellen over je Moss-data, rapporten maken of workflows automatiseren.

Server-URL

Omgeving

URL

Productie

De installatiestappen voor specifieke AI-assistenten vind je hieronder:

Hoe Moss MCP werkt

  • Vraag Moss wat je wilt. Bevraag je uitgavendata rechtstreeks vanuit de AI-assistenten die je team al gebruikt. Stel vragen in gewone taal over al je Moss-data, zonder handmatige exports of spreadsheets.

  • Meerdere entiteiten, direct uit de doos. Verbind één keer en bevraag alle organisaties die je beheert. Er is geen aparte installatie per entiteit nodig, dus rapportage over entiteiten heen kan vanaf de eerste vraag. Ideaal voor admins die meerdere organisaties beheren.

  • Datatoegang op jouw voorwaarden. Verbind de data van je organisatie en bevraag alleen wat je in Moss toch al mag zien. Elke vraag haalt alleen de data op die relevant is voor die vraag. Dat zorgt voor betrouwbaardere antwoorden en minimaliseert de tokenkosten.

Wat er vandaag beschikbaar is

Moss MCP bundelt data in groepen die je via je AI-assistent kunt bevragen, en voegt in de loop van de tijd nieuwe data toe. Moss MCP ondersteunt op dit moment:

  • Uitgaven. Uitgaven opzoeken van alle uitgavetypes.

  • Bijlagen. Bijlagen opzoeken die in Moss zijn opgeslagen.

  • Moss Accounts. Saldi en transacties van Moss Accounts controleren.

  • Budgetten. Budgetdata opzoeken.

  • Leveranciers. Leveranciersdata opzoeken.

Alle data is alleen-lezen. Je assistent kan data opzoeken, maar kan niets aanmaken, bewerken of verwijderen in Moss.

Belangrijk om te weten

  • Datatoegang blijft afhangen van je adminrechten in Moss. Wat jij niet kunt zien in het product, ziet je assistent ook niet.

  • We voegen in de loop van de tijd nieuwe datagroepen toe die je kunt bevragen. Mogelijk moet je je AI-assistent loskoppelen en opnieuw verbinden om de nieuwste lijst met ondersteunde data te zien.

  • De lijst hierboven laat zien welke data vandaag wordt ondersteund; er komt in de loop van de tijd meer bij. Neem contact met ons op als je data nodig hebt die hier niet staat.


Wat je met Moss MCP kunt doen

Gebruik Moss MCP voor de vragen waarvoor je normaal een export, een filter en een spreadsheet nodig hebt. De voorbeelden hieronder zijn gegroepeerd per financiële taak. Kopieer een prompt en pas de periode, entiteit of leverancier aan naar jouw situatie.

Uitgaven controleren vóór de export

Haal boekings- en btw-fouten er al in Moss uit, voordat ze in je boekhoudsysteem terechtkomen en gecorrigeerd moeten worden.

Use case

Voorbeeldprompt

Wat je krijgt

Uitgaven vinden die nog niet klaar zijn voor export

"Bij welke facturen die in de afgelopen zeven dagen zijn ingediend ontbreekt de grootboekrekening, kostenplaats of het btw-tarief?"

Een lijst met uitgaven die nog aangevuld moeten worden.

Boekingen vergelijken met eerdere boekingen

"Laat voor onze 20 meest voorkomende leveranciers de grootboekrekening en kostenplaats zien die we meestal gebruiken, en markeer recente facturen die daarvan afwijken."

Boekingen die niet overeenkomen met hoe je de leverancier eerder hebt geboekt.

Btw op kaartuitgaven controleren

"Controleer de kaartuitgaven van afgelopen kwartaal op transacties waarbij het btw-tarief niet past bij het land van de verkoper."

Transacties waarbij de voorbelasting mogelijk onjuist is.

Bonnen vergelijken met afschrijvingen

"Vind kaarttransacties van vorige maand waarbij het bedrag op de bon afwijkt van het afgeschreven bedrag."

Verschillen om te controleren vóór de export.

Crediteurenadministratie

Betaalruns plannen, facturen in beweging houden en vragen van leveranciers beantwoorden.

Use case

Voorbeeldprompt

Wat je krijgt

Een betaalrun voorbereiden

"Laat onbetaalde leveranciersfacturen zien die de komende 14 dagen vervallen, gegroepeerd per entiteit en leverancier."

De facturen voor je volgende betaalrun.

Achterstallige facturen opvolgen

"Welke leveranciersfacturen zijn achterstallig? Sorteer ze op aantal dagen te laat."

Een ouderdomsoverzicht van wat te laat is.

Facturen vinden die vastzitten in de goedkeuring

"Welke facturen wachten al meer dan vijf dagen op goedkeuring?"

Facturen om achteraan te gaan.

Een betaling koppelen aan de factuur

"Bij welke factuur hoort de uitgaande Moss Account-betaling van EUR 1.200 op 3 oktober?"

De bijbehorende factuur en leverancier.

Een factuur uitlezen

"Vind de pdf van onze meest recente factuur voor de kantoorhuur en laat me het nettobedrag, de btw en de leveringsperiode zien."

Cijfers die rechtstreeks uit het bijgevoegde document zijn gelezen.

Kaarten en personeelsuitgaven

Houd kaartuitgaven gedocumenteerd en spoor uitgaven op die er niet horen te zijn.

Use case

Voorbeeldprompt

Wat je krijgt

Ontbrekende bonnen opvragen

"Geef een lijst van kaarttransacties ouder dan 14 dagen die nog geen bon hebben, gegroepeerd per medewerker."

Wie je moet herinneren, en voor welke transacties.

Dubbele abonnementen vinden

"Betalen we voor dezelfde softwaretool met meer dan één kaart?"

Dubbele tools en de kaarten waarmee ze worden betaald.

Reiskosten samenvatten

"Vat de reiskosten van vorige maand samen per team, met bonstatus."

Een overzicht van reis- en onkosten dat je kunt delen.

Cashmanagement

Weet hoeveel geld je beschikbaar hebt over al je entiteiten, zonder bij elke entiteit apart in te loggen.

Use case

Voorbeeldprompt

Wat je krijgt

Saldi controleren over entiteiten heen

"Wat is het huidige saldo van elk Moss Account? Markeer alles onder EUR 2.500."

Saldi per entiteit en valuta, met lage saldi gemarkeerd.

Een dagelijks cashoverzicht maken

"Maak een dagelijks overzicht met het saldo van elk Moss Account en de kaartuitgaven van gisteren."

Een overzicht dat je assistent op verzoek kan verversen.

Uitgavenanalyse en budgetten

Beantwoord vragen van het management en budgethouders over waar het geld naartoe gaat.

Use case

Voorbeeldprompt

Wat je krijgt

Uitgaven bij een leverancier in kaart brengen

"Hoeveel hebben we dit jaar uitgegeven bij onze cloudhostingproviders, per maand en entiteit?"

Totalen over alle leveranciersaccounts van dezelfde leverancier.

Leveranciers rangschikken op uitgaven

"Laat de top 10 leveranciers zien op netto-uitgaven van afgelopen kwartaal, over alle entiteiten."

Een ranglijst voor leveranciersreviews of onderhandelingen.

Periodes vergelijken

"Vergelijk de marketinguitgaven van dit kwartaal met hetzelfde kwartaal vorig jaar, per kostenplaats."

De verandering per kostenplaats en wat die veroorzaakte.

Budgetgebruik volgen

"Laat de verbruikte en beschikbare bedragen zien van elk budget deze maand."

Budget versus werkelijk per budget.

Zien wat een budget gebruikt

"Welke uitgaven tellen tot nu toe mee voor het budget van de team-offsite?"

De facturen en kaarttransacties achter het verbruikte bedrag.

Audit en interne controles

Beantwoord verzoeken van auditors en controleer je interne controles zonder exports te draaien.

Use case

Voorbeeldprompt

Wat je krijgt

Goedkeuringen controleren

"Wie heeft afgelopen kwartaal facturen boven EUR 10.000 goedgekeurd?"

Elke grote factuur met de goedkeurder.

Bankgegevens van leveranciers verifiëren

"Komt bij facturen van leveranciers die dit kwartaal zijn toegevoegd de IBAN op de bijgevoegde factuur overeen met de bankgegevens die in Moss zijn opgeslagen?"

Verschillen om te controleren voordat je betaalt, een veelvoorkomend teken van factuurfraude.

Onderbouwende documenten opvragen

"Haal alle facturen van onze juridisch adviseurs van vorig jaar op en tel de kosten per entiteit op."

De documenten en een totaal per entiteit.

Om bestanden te openen of te downloaden heeft je assistent mogelijk extra netwerktoegang nodig. Zie "Mogelijke fouten" als een download mislukt.

Maandafsluiting

Maak de periode klaar om af te sluiten: vind wat nog niet is geboekt en zorg dat kosten in de juiste maand terechtkomen.

Use case

Voorbeeldprompt

Wat je krijgt

Overlopende posten voorbereiden

"Welke leveranciersfacturen met een leverdatum in de vorige maand zijn nog niet geëxporteerd? Laat de nettobedragen per entiteit zien."

Een lijst met kosten die bij de periode horen maar nog niet zijn geboekt.

Leveringsperiodes bevestigen voor de cut-off

"Open de bijgevoegde pdf's van de softwarefacturen die we deze maand hebben ontvangen en vertel me welke periode elke factuur dekt."

De leveringsperiode uit elk document, zodat je kosten aan de juiste maand kunt toewijzen.

Niet-geëxporteerde items vinden

"Laat facturen, kaarttransacties en vergoedingen zien die ouder zijn dan 60 dagen en nog niet zijn geëxporteerd."

Items die anders in een afgesloten periode zouden belanden.

Terugkerende controles

Voer een controle één keer uit en vraag je assistent daarna om die te herhalen.

Use case

Voorbeeldprompt

Wat je krijgt

Wekelijkse controle vóór de export

"Geef elke maandag een lijst van nieuwe facturen met ontbrekende boekingsgegevens."

Een terugkerende controle, als je assistent geplande taken ondersteunt.

Tips voor betere resultaten

  • Noem de periode, entiteit en valuta. Bijvoorbeeld "september 2026, UK-entiteit, in EUR".

  • Geef aan of je netto- of brutobedragen wilt.

  • Vraag om totalen op factuur- of transactieniveau. Gesplitste uitgaven hebben meerdere regels, en wie elke regel optelt, telt mogelijk dubbel.

  • Vraag bij grote verzoeken eerst om een samenvatting en ga daarna de details in.

  • Als een cijfer niet klopt, vraag je assistent dan welke filters hij heeft gebruikt.

  • Controleer AI-antwoorden voordat je op basis daarvan iets boekt of betaalt.


Voordat je begint

Je hebt nodig:

  • Een Moss-adminaccount. MCP-toegang is beperkt tot admins.

  • Een AI-assistent die MCP ondersteunt.

Verbinden met Claude

Deze installatiestappen gelden voor individuele Claude-abonnementen. Voor beheerde Claude-abonnementen volg je de instructies voor Claude for Teams of Enterprise hieronder.

Claude Desktop of claude.ai

  1. Ga naar Settings > Connectors.

  2. Selecteer Add custom connector.

  3. Voer de server-URL in: https://mcp.getmoss.com/mcp.

  4. Selecteer Add, log in bij Moss wanneer daarom wordt gevraagd en kies welke organisatie(s) je met je assistent wilt delen.

Claude Code

Voer dit uit in je terminal:

claude mcp add --transport http moss-server https://mcp.getmoss.com/mcp

Start daarna een Claude Code-sessie en voer /mcp uit om het inloggen af te ronden.

Claude for Team of Enterprise

Bij beheerde Claude-abonnementen voegt een Owner of Primary Owner eerst de connector toe voor de organisatie. Daarna verbindt elke admin zijn of haar eigen account.

Installatiestappen voor de owner (eenmalig):

  1. Ga naar Organisation settings > Connectors.

  2. Selecteer Add, beweeg je muis over Custom en selecteer dan Web.

  3. Voer de server-URL in: https://mcp.getmoss.com/mcp.

  4. Selecteer Add om af te ronden.

Installatiestappen voor elke Moss-admin:

  1. Ga naar Customize > Connectors.

  2. Zoek de Moss-connector met het label Custom.

  3. Selecteer Connect, log in bij Moss en kies welke organisatie(s) je wilt delen.

Mogelijke fouten

Het downloaden van een bijlage mislukt met een "sandbox network proxy"-fout

Dit is geen probleem van Moss. Claude kan je uitgaven- en bijlagedata altijd opzoeken via Moss MCP. Maar om het bestand zelf te openen of op te slaan, moet Claude internet bereiken vanuit een aparte, afgeschermde omgeving, en die omgeving kan standaard alleen een korte lijst met goedgekeurde websites bereiken. Staat mcp.getmoss.com niet op die lijst, dan mislukt de download met deze fout.

Dit wordt opgelost door je Claude-admin. Vraag hem of haar om:

  1. Ga naar Organization settings > Capabilities > Code execution.

  2. Voeg onder Additional allowed domains mcp.getmoss.com toe.

  3. Controleer de dropdown Domain allowlist en zet die op Package managers only. (Staat die al op All domains, dan hoef je verder niets te wijzigen.)

Zodra dat is opgeslagen, vraag je Claude om de download opnieuw te proberen. Je hoeft Moss MCP niet opnieuw te verbinden of te autoriseren.

Meer over waarom Claude "data opzoeken" en "bestanden downloaden" op deze manier scheidt, lees je in het Anthropic-artikel: https://support.claude.com/en/articles/13455879-use-claude-cowork-on-team-and-enterprise-plans

Verbinden met ChatGPT

ChatGPT verbindt met aangepaste MCP-servers via een bètafunctie die Developer mode heet. OpenAI wijzigt dit menu vrij regelmatig. Als deze stappen niet helemaal overeenkomen met wat je ziet, kijk dan in het helpcenter van OpenAI voor het actuele pad.

  1. Open ChatGPT en ga naar Instellingen > Apps.

  2. Zet onder de geavanceerde instellingen Ontwikkelaarsmodus (Developer mode) aan.

  3. Open Plugins, selecteer de knop + en voeg een nieuwe verbinding toe.

  4. Voer de server-URL in, inclusief het pad: https://mcp.getmoss.com/mcp.

  5. Rond het inloggen af om je Moss-account te verbinden en kies welke organisatie(s) je wilt delen.

In Business-, Enterprise- of Edu-workspaces moet een workspace-admin eerst Developer mode en aangepaste apps inschakelen voor de workspace, via Werkruimte-instellingen > Apps, voordat leden de Moss-connector zelf kunnen toevoegen.

Verbinden met Codex

Voer in je terminal uit:

codex mcp add moss-server --url https://mcp.getmoss.com/mcp

Voer codex mcp login moss-server uit om je browser te openen, in te loggen bij Moss en de OAuth-flow af te ronden.

Codex registreert zichzelf automatisch bij Moss, dus je hebt geen Client ID nodig.

Verbinden met Microsoft Copilot Studio

Copilot Studio verbindt met Moss MCP via zijn MCP-onboardingwizard. De MCP-server van Moss vereist handmatige OAuth 2.0-configuratie (geen dynamische clientregistratie), dus gebruik de authenticatieoptie Handmatig.

  1. Ga in Moss naar Instellingen > MCP en klik op Microsoft Copilot Studio.

  2. Ga in Copilot Studio naar de pagina Tools van je agent en selecteer Een tool toevoegen > Nieuwe tool> Model Context Protocol.

  3. Voer een Servernaam en Serverbeschrijving in en zet Server-URL op https://mcp.getmoss.com.

  4. Selecteer bij het authenticatietype OAuth 2.0 en daarna Handmatig.

  5. Vul de velden in met de waarden van de MCP-instellingenpagina in Moss: Client- ID, Clientgeheim, Autorisatie-URL, Token-URL-sjabloon, Vernieuwings-URL, Bereiken (optioneel).

  6. Selecteer Maken. Copilot Studio genereert een Callback-URL.

  7. Kopieer die callback-URL en voeg die toe op de MCP-instellingenpagina in Moss, zodat de identity provider van Moss de redirect van Copilot Studio herkent.

  8. Selecteer Verbinden

  9. Selecteer Volgende, kies Een nieuwe verbinding maken (of een bestaande) en daarna Toevoegen aan agent om af te ronden.

Meer over verbinden met Microsoft Copilot Studio lees je in het helpcenter van Microsoft: https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-add-existing-server-to-agent

Verbinden met Langdock

  1. Ga in Moss naar Instellingen > MCP en klik op Langdock.

  2. Voeg in Langdock een nieuwe MCP-integratie toe en voer de server-URL in: https://mcp.getmoss.com/mcp.

  3. Selecteer OAuth 2.0 Manual (Authorization Code + PKCE) als authenticatiemethode.

  4. Kopieer de OAuth redirect URL die Langdock laat zien en voeg die toe op de MCP-instellingenpagina in Moss.

  5. Voer de Client ID en Client Secret uit Moss in bij Langdock.

  6. Voeg de Authorization URL en Token URL uit Moss toe.

  7. Voer de Scopes van de instellingenpagina van Moss in (gescheiden door spaties of komma's).

  8. Laat Send resource parameter ingeschakeld.

  9. Klik in Moss op Verbinden.

  10. Selecteer Test connection om de toegang te bevestigen en de beschikbare tools te zien, en daarna Save.


Toegang autoriseren

De eerste keer dat je verbindt, vraagt Moss je om in te loggen en te kiezen welke organisatie(s) je assistent mag zien. Alleen organisaties waarvan je admin bent staan in die lijst, en alleen de organisaties die je selecteert worden zichtbaar. Niets anders in je Moss-account wordt standaard gedeeld.

Je kunt toegang geven tot meer dan één organisatie en ze allemaal tegelijk bevragen, zonder extra installatie per entiteit. Wil je de toegang later intrekken, ga dan naar de MCP-instellingenpagina in je Moss-instellingen en trek de toegang daar in.

De toegang verloopt automatisch 30 dagen nadat je hebt verbonden, ongeacht hoe vaak je die gebruikt. Dit is een beveiligingsmaatregel. Zodra de toegang verloopt, verliest je assistent de toegang tot je Moss-data en moet je opnieuw verbinden en inloggen om die te vernieuwen.

Data en beveiliging

  • De toegang is alleen-lezen. Je assistent kan data opzoeken, maar geen wijzigingen aanbrengen in Moss.

  • De toegang is beperkt tot admins en tot de organisatie(s) die je autoriseert. Je assistent kan geen data zien van organisaties waarvoor je geen toegang hebt gegeven.

  • De toegang volgt je bestaande Moss-rechten. Je ziet alleen wat je in het product toch al mag zien, niets meer.

  • Elke verbonden AI-assistent staat op de MCP-instellingenpagina in je Moss-instellingen, zodat je op elk moment kunt zien en beheren wat er is verbonden.

  • Inloggen gaat via een veilige OAuth-flow. Bij ondersteunde clients zoals Claude hoef je nooit zelf een toegangstoken te beheren of te plakken.


Problemen oplossen

  • Je assistent zegt dat hij geen toegang heeft, of geeft lege resultaten

    • Verbind opnieuw en controleer of je tijdens het inloggen de juiste organisatie(s) hebt geselecteerd.

    • MCP-toegang verloopt automatisch 30 dagen nadat je hebt verbonden, ook als je die in die periode regelmatig hebt gebruikt. Is het ongeveer een maand geleden dat je voor het laatst hebt ingelogd (niet: gebruikt), dan is dit de waarschijnlijke oorzaak. Verbind opnieuw om de toegang te vernieuwen.

  • De verbinding mislukt of valt weg. Koppel de connector los en verbind opnieuw in de instellingen van je assistent. Sommige clients bewaren een oude sessie.

  • Je client staat hier niet bij. Gebruik de server-URL (https://mcp.getmoss.com/mcp) of het JSON-fragment hierboven met elke MCP-client die externe HTTP-servers en OAuth 2.1 ondersteunt.

FAQ

Is dit alleen-lezen? Ja. Je assistent kan data opzoeken in Moss, maar kan niets aanmaken, bewerken of verwijderen.

Moet ik admin zijn? Ja. MCP-toegang in Moss is beperkt tot admins.

Kan ik meer dan één organisatie verbinden? Ja, je kiest tijdens het autoriseren welke, en je assistent kan ze allemaal bevragen zonder aparte installatie per entiteit.

Heb ik een developer nodig om dit in te stellen? Nee. Plak de URL (of het JSON-fragment) in de connectorinstellingen van je AI-assistent en log in.

Waar zie ik wat er is verbonden? De MCP-instellingenpagina in je Moss-instellingen toont elke verbonden AI-assistent.

Verloopt mijn toegang? Ja. Om veiligheidsredenen verloopt MCP-toegang 30 dagen nadat je hebt verbonden, ongeacht het gebruik. Log opnieuw in via de connectorinstellingen van je assistent om opnieuw te verbinden.

Was dit een antwoord op uw vraag?