SnelStart MCP instellen
Met de SnelStart-add-on vraag je Claude naar facturen, relaties en het grootboek in je SnelStart-administratie. Je hebt twee sleutels nodig: een subscription key en een koppelingssleutel. Op deze pagina zie je waar je ze vindt.
Wat je nodig hebt
- Een SnelStart-administratie waar je met SnelStart Web op inlogt.
- Een account op het SnelStart developer portal met een abonnement op de B2B API.
- Ongeveer tien minuten.
- Een seat op MCP Hosted, of MCP Self-hosted, met de SnelStart-add-on.
Waar je het vindt
Je subscription key
De subscription key geeft toegang tot de SnelStart B2B API zelf. Je haalt hem uit het developer portal, niet uit SnelStart Web.
- Log in op b2bapi-developer.snelstart.nl.
- Open Producten en kies het B2B API-product waarop je geabonneerd bent.
- Kopieer de primaire sleutel van je abonnement.
Je koppelingssleutel
De koppelingssleutel koppelt één SnelStart-administratie. Wie hem heeft, kan via de API bij die administratie, dus behandel hem als een wachtwoord.
- Log in op SnelStart Web met de administratie waarin Claude moet werken.
- Maak in de koppelingsinstellingen van die administratie een koppelingssleutel voor je app.
- Kopieer de sleutel. Werk je voor meerdere klanten? Elke administratie heeft een eigen sleutel.
Je API-adres
Laat dit leeg. AddoCore gebruikt https://b2bapi.snelstart.nl/v2. Vul het alleen in als SnelStart je een ander adres gaf.
Je token-adres
Laat ook dit leeg. De standaard is https://auth.snelstart.nl/b2b/token, het adres uit de documentatie van SnelStart zelf.
Plak het in AddoCore
- Open in Mijn account MCP Hosted en kies je seat. Bij MCP Self-hosted open je je licentie.
- Ga naar Tools en kies Instellen op de kaart SnelStart.
- Kies onder Accounts voor Account toevoegen en vul Korte naam, Subscription key en Koppelingssleutel in.
- Kies Inloggegevens opslaan en daarna Verbinding testen. Een groene uitslag betekent dat het werkt.
Eén seat kan meerdere administraties gebruiken, handig voor een boekhouder. Voeg elke administratie toe met een eigen koppelingssleutel. We slaan je inloggegevens versleuteld op.
Vraag Claude daarna iets wat alleen je eigen administratie kan beantwoorden, bijvoorbeeld: Welke verkoopfacturen van dit kwartaal staan nog open?
Over de SnelStart add-on · Alle installatiehandleidingen
Zelf draaien
Alleen voor MCP Self-hosted als je instellingen in het .env-bestand zet in plaats van in Mijn account. Met de stappen hierboven heb je dit niet nodig.
Toon de technische uitleg
mcp-core haalt een token op bij https://auth.snelstart.nl/b2b/token met grant_type=clientkey en de koppelingssleutel in de body van het verzoek. Elke API-aanroep stuurt daarna dat token mee, plus de subscription key in de header Ocp-Apim-Subscription-Key.
Eén administratie:
SNELSTART_SUBSCRIPTION_KEY=your-subscription-key
SNELSTART_CLIENT_KEY=your-koppelingssleutelMeerdere administraties: één JSON-lijst. De AI kiest er een met de parameter account, op basis van de id.
SNELSTART_CONNECTIONS=[{"id":"client-a","label":"Client A","subscriptionKey":"...","clientKey":"..."},{"id":"client-b","subscriptionKey":"...","clientKey":"..."}]SNELSTART_BASE_URL en SNELSTART_AUTH_URL zijn optioneel en alleen nodig bij een ander adres van SnelStart.
Verbinding testen mislukt? “The subscription key was rejected” betekent dat de sleutel uit het developer portal niet klopt of dat het abonnement niet actief is. “SnelStart rejected the koppelingssleutel” betekent dat de sleutel niet klopt of in SnelStart Web is ingetrokken.
Klaar om het te proberen?