Naar de hoofdinhoud

Verbind je AI-assistent met Moss MCP

Introductie van de Moss MCP, met uitleg over hoe je de gegevens van je Moss-organisatie kunt koppelen aan je AI-assistent.

Geschreven door Rosanna Howard

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

Server-URL

Omgeving

URL

Productie

De installatiestappen voor specifieke AI-assistenten vind je hieronder:

Zo werkt Moss MCP

  • Vraag Moss wat je wilt. Vraag je uitgavengegevens rechtstreeks op via de AI-assistenten die je team al gebruikt. Stel vragen in gewone taal over al je Moss-gegevens. Zonder handmatige exports of spreadsheets.

  • Beheer makkelijker meerdere entiteiten. Maak één keer verbinding en voer zoekopdrachten uit in alle organisaties die je beheert. Je hoeft niet per entiteit iets in te stellen, dus je kunt vanaf de eerste zoekopdracht al rapportages maken die meerdere entiteiten omvatten. Ideaal voor admins die meerdere organisaties beheren.

  • Datatoegang op jouw voorwaarden. Maak verbinding met de gegevens van je organisatie en vraag alleen op wat je al mag zien in Moss. Voor elke vraag worden alleen de relevante gegevens opgehaald. Dat zorgt voor een betrouwbaarder antwoord en houdt tokenkosten laag.

Wat nu al beschikbaar is

Moss MCP bundelt gegevens zodat je er via je AI-assistent vragen over kunt stellen. Er worden in de loop van de tijd steeds nieuwe gegevens toegevoegd. Moss MCP ondersteunt momenteel:

  • Uitgaven. Bekijk alle uitgaventypes.

  • Bijlagen. Bekijk bijlagen die in Moss zijn opgeslagen.

  • Moss-rekeningen. Bekijk de saldi en transacties van Moss-rekeningen.

  • Budgets. Bekijk budgetgegevens.

  • Leveranciers. Bekijk leveranciersgegevens.

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. Mogelijk moet je je AI-assistent loskoppelen en opnieuw verbinden om de nieuwste ondersteunde data te zien.

  • De lijst hierboven geeft weer welke gegevens momenteel worden ondersteund; in de loop van de tijd zullen er meer beschikbaar komen. Neem contact met ons op als je gegevens nodig hebt die hier niet staan vermeld


Wat je met Moss MCP kunt doen

Je kunt Moss MCP gebruiken voor vragen waarvoor je normaal gesproken zou moeten exporteren, filteren en een spreadsheet gebruiken. De voorbeelden hieronder zijn gegroepeerd op basis van de taak waarvoor ze bedoeld zijn. Kopieer een prompt en pas vervolgens de periode, entiteit of leverancier aan, zodat hij bij jouw situatie past.

Uitgaven vóór export controleren

Spot fouten in de codering en btw in Moss, voordat ze in je boekhoudsysteem terechtkomen en je ze moet corrigeren.

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 een grootboekrekening, een kostenplaats of een btw-tarief?”

Een lijst met uitgaven die nog aangevuld moeten worden.

Boekingen vergelijken met eerdere boekingen

"Laat voor onze 20 vaakst 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 niet klopt.

Crediteurenbeheer

Plan betalingsruns, zorg dat facturen worden verwerkt en beantwoord vragen van leveranciers.

Use case

Voorbeeldprompt

Resultaat

Een betalingsrun voorbereiden

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

De facturen voor je volgende betalingsrun.

Achterstallige facturen navragen

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

Een overzicht van wat te laat is.

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.

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 onkosten van medewerkers

Houd de kaarttransacties bij en spoor uitgaven op die er niet zouden moeten zijn.

Use case

Voorbeeldprompt

Resultaat

Ontbrekende betaalbewijzen opvragen

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

Wie je aan welke transacties moet herinneren.

Dubbele abonnementen vinden

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

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.

Kasbeheer

Zie in één oogopslag hoeveel geld je bij alle entiteiten hebt zonder dat je bij elke entiteit apart hoeft in te loggen.

Use case

Voorbeeldprompt

Resultaat

Saldi controleren bij alle entiteiten

"Wat is het huidige saldo van elke Moss-rekening? Markeer alles onder EUR 2.500."

Saldi per entiteit en valuta, waarbij lage saldi zijn gemarkeerd.

Een dagelijks cashoverzicht maken

“Maak een dagelijks overzicht met het saldo van elke Moss-rekening en de kaartuitgaven van gisteren.”

Een overzicht dat je assistent op verzoek kan bijwerken.

Uitgavenanalyse en budgetten

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

Use case

Voorbeeldprompt

Resultaat

Uitgaven bij een leverancier in kaart brengen

“Hoeveel hebben we dit jaar uitgegeven aan onze cloudhostingproviders, per maand en per entiteit?”

Totalen van alle leveranciersrekeningen van dezelfde leverancier.

Leveranciers rangschikken op basis van uitgaven

“Laat de top 10 van leveranciers zien op basis van de netto-uitgaven van het afgelopen kwartaal, voor alle entiteiten.”

Een ranglijst voor beoordelingen van leveranciers 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 traceren

“Toon de opgebruikte en beschikbare bedragen voor elk budget deze maand.”

Budget versus werkelijke cijfers per budget.

Zien waar het budget aan wordt besteed

“Welke uitgaven tellen tot nu toe mee voor het budget van het teamuitje?”

De facturen en kaarttransacties voor het uitgegeven bedrag.

Audit en interne controles

Reageer op verzoeken van auditors en check je controles zonder exports uit te hoeven draaien.

Use case

Voorbeeldprompt

Resultaat

Goedkeuringen controleren

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

Elke grote factuur en degene die hem goedgekeurd heeft.

Bankgegevens van leveranciers verifiëren

“Voor facturen van leveranciers die dit kwartaal zijn toegevoegd: komt het IBAN-nummer op de bijgevoegde factuur overeen met de bankgegevens die in Moss zijn opgeslagen?”

Afwijkingen die je moet controleren voordat je betaalt: een veelvoorkomend teken van factuurfraude.

Ondersteunende documenten opvragen

“Zoek alle facturen van onze juristen van vorig jaar op en tel de honoraria per entiteit bij elkaar op.”

De documenten en een totaal per entiteit.

Om bestanden te openen of te downloaden, heeft je assistent mogelijk extra netwerktoegang nodig. Kijk bij ‘Mogelijke fouten’ als een download mislukt.

Terugkerende controles

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

Use case

Voorbeeldprompt

Resultaat

Wekelijkse controle vóór de export

“Maak elke maandag een lijst van nieuwe facturen waarbij de codering ontbreekt.”

Een terugkerende check, als je assistent geplande taken ondersteunt.

Tips voor betere resultaten

  • Benoem de periode, entiteit en valuta. Bijvoorbeeld: ‘september 2026, Britse entiteit, in EUR’.

  • Geef aan of je netto- of brutobedragen wilt.

  • Vraag om totalen op factuur- of transactieniveau. Gesplitste uitgaven bestaan uit meerdere regels, en als je elke regel bij elkaar optelt, kan dat tot dubbeltellingen leiden.

  • Bij grote opdrachten: vraag eerst om een overzicht en duik daarna pas in de details.

  • Als een bedrag niet klopt, vraag je assistent dan welke filters er zijn gebruikt.

  • Controleer de antwoorden van de AI voordat je op basis ervan 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 installatie-instructies gelden voor individuele Claude-abonnementen. Volg voor beheerde Claude-abonnementen de onderstaande instructies voor Claude for Teams of Enterprise.

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 ‘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’-foutmelding

Dit is geen fout van Moss. Claude kan je uitgave- en bijlagegegevens altijd opzoeken via de Moss MCP. Maar om het bestand zelf te openen of op te slaan, moet Claude vanuit een aparte, streng beveiligde omgeving verbinding maken met het internet. Standaard heeft die omgeving alleen toegang tot een korte lijst met goedgekeurde websites. Als mcp.getmoss.com niet op die lijst staat, mislukt het downloaden met deze foutmelding.

Dit moet worden opgelost door je Claude-admin. Dit is wat hij/zij kan doen:

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

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

  3. Controleer de dropdown ‘Domain allow list’ en zet die op ‘Package managers only’. (Als die al op ‘All domains’ staat, dan hoef je verder niets te wijzigen.)

Eenmaal opgeslagen, kun je Claude vragen om de download nog eens te proberen. Je hoeft de Moss MCP niet opnieuw te verbinden of te autoriseren.

Als je meer wilt weten over waarom Claude ‘gegevens opzoeken’ en ‘bestanden downloaden’ op deze manier van elkaar scheidt, kun je dit Anthropic-artikel lezen:https://support.claude.com/en/articles/13455879-use-claude-cowork-on-team-and-enterprise-plans

Verbinden met ChatGPT

ChatGPT maakt verbinding met aangepaste MCP-servers via een bètafunctie die ‘Developer mode’ heet. OpenAI past dit menu vrij vaak aan, dus als deze stappen niet helemaal overeenkomen met wat je ziet, kijk dan even in het helpcentrum van OpenAI voor de actuele stappen.

  1. Open ChatGPT en ga naar ‘Instellingen’ -> ‘Apps’.

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

  3. Open ‘Plugins’, selecteer ‘+’ en voeg een nieuwe verbinding toe.

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

  5. Vul de inloggegevens in om je Moss-account te koppelen en kies met welke organisatie(s) je gegevens 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 het volgende 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 maakt verbinding met Moss MCP via de MCP-onboardingwizard. De MCP-server van Moss vereist een 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 de ‘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 nu 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. Klik op ‘Verbinden’. Sla dit niet over.

  9. Kies ‘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 verbinding maakt, vraagt Moss je om in te loggen en te kiezen welke organisatie(s) je assistent mag zien. Alleen organisaties waarvan jij admin bent, verschijnen in die lijst en alleen de organisaties die je selecteert, worden zichtbaar. De rest van je Moss-account is standaard niet zichtbaar.

Je kunt toegang verlenen aan meer dan een organisatie en in al die organisaties tegelijk zoeken, zonder dat je per entiteit iets extra's hoeft in te stellen. Als je de toegang later wilt intrekken, ga je naar de MCP-instellingenpagina in je Moss-instellingen en trek je de toegang daar in.

De toegang verloopt automatisch 30 dagen nadat je verbinding hebt gemaakt, ongeacht hoe vaak je er gebruik van maakt. Dit is een veiligheidsmaatregel. Als de toegang verloopt, verliest je assistent de toegang tot je Moss-gegevens en moet hij of zij opnieuw verbinding maken en inloggen om de gegevens te vernieuwen.

Gegevens en beveiliging

  • Toegang is alleen-lezen. Je assistent kan gegevens opzoeken, maar kan geen wijzigingen doorvoeren in Moss.

  • Toegang is beperkt tot admins en geldt alleen voor de organisatie(s) die je autoriseert. Je assistent kan geen gegevens zien van organisaties waarvoor je geen toegang hebt verleend.

  • Toegang volgt je bestaande Moss-machtigingen. Je ziet alleen wat je al mag zien in het product, meer niet.

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

  • Het inloggen verloopt via een beveiligde OAuth-procedure. Voor 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

    • Maak opnieuw verbinding en controleer of je bij het inloggen de juiste organisatie(s) hebt geselecteerd.

    • De toegang tot MCP verloopt automatisch 30 dagen nadat je verbinding hebt gemaakt, zelfs als je het in die periode regelmatig hebt gebruikt. Als het ongeveer een maand geleden is dat je voor het laatst hebt ingelogd, is dit waarschijnlijk de oorzaak. Maak opnieuw verbinding 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 assistenten bewaren een oude sessie.

  • Je client staat hier niet bij. Gebruik de server-URL (https://mcp.getmoss.com/mcp) 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 verbinding maken met meer dan één organisatie? Ja, je kiest zelf welke tijdens de autorisatie. Je assistent kan bij al die organisaties informatie opvragen zonder dat je per organisatie iets hoeft in te stellen.

Heb ik een ontwikkelaar 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 kan ik zien wat er is gekoppeld? Op de MCP-instellingenpagina in je Moss-instellingen staan alle gekoppelde AI-assistenten vermeld.

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

Was dit een antwoord op uw vraag?