MCP koppelen
Gebruik https://mcp.vesta.services/mcp om een MCP-client te koppelen aan Vesta, ook voor gegevens uit Vesta Time. Je meldt je aan met je Vesta-account en geeft OAuth-toestemming in je browser. Alle werkgevers gebruiken dezelfde server; je selecteert de werkgever tijdens het toestaan van toegang.
ChatGPT en Claude
Section titled “ChatGPT en Claude”Open in ChatGPT Plugins > + > Add custom MCP server, vul de Vesta-URL in en kies OAuth. Maak de plugin aan, installeer hem vanuit je persoonlijke plugins en roep hem met @ aan in een chat. Werkruimtebeperkingen gelden. Zie de koppelhandleiding van OpenAI.
Open in Claude Customize > Connectors > + Add > Add custom connector. Vul de Vesta-URL in, kies aanmelden en automatische OAuth-registratie, en koppel. In een beheerde werkruimte moet de eigenaar de connector mogelijk eerst toevoegen. Zie de koppelhandleiding van Claude.
Dit zijn eigen koppelingen. Een publieke vermelding vereist een aparte beoordeling en publicatie door de uitgever; deze handleiding bevestigt niet dat Vesta al in de catalogus staat.
Koppelen met alleen leestoegang
Section titled “Koppelen met alleen leestoegang”- Activeer Vesta AI voor de werkgever en je account, en controleer of je rol de nodige gegevens mag lezen.
- Voeg in je client een externe HTTP-MCP-server toe met de bovenstaande URL. De client moet MCP OAuth-discovery en browseraanmelding ondersteunen.
- Meld je aan op de autorisatiepagina van Vesta. Plak je Vesta-wachtwoord nooit in de client of een chat.
- Selecteer alleen de werkgever die je wilt delen. Opnieuw toestemming geven aan dezelfde OAuth-client vervangt de werkgeversselectie. Gelijktijdige afzonderlijke koppelingen vereisen verschillende OAuth-clientregistraties, als je client dat ondersteunt; gebruik aparte klanten-API-integraties voor automatische toegang per werkgever.
- Elke geselecteerde werkgever begint met alleen leestoegang. Kies Rechten aanpassen bij die werkgever om zijn machtigingen afzonderlijk in te stellen. Selecteer alleen leesmachtigingen: Medewerkers om werknemers op te zoeken, Planning voor shifts en beschikbaarheden, Gewerkte uren voor gewerkte tijd en Loonkost voor loonrapportering. Selecteer geen schrijfmachtigingen.
- Bevestig de toestemming en vernieuw de toollijst van de client.
Je rol, de actieve modules van de werkgever en je toestemming begrenzen samen de toegang. Toestemming kan geen rechten geven die je Vesta-account niet heeft. Geaggregeerde werkgeverskosten lezen vereist naast de toestemming voor Loonkost ook het recht om werkgeverskosten te lezen (laborcost.read). Individuele loontarieven blijven ontoegankelijk via MCP. Een bestaande koppeling krijgt nieuwe scopes niet automatisch: geef opnieuw toestemming om Loonkost toe te voegen.
Machtigingen worden afzonderlijk per werkgever gecontroleerd. Schrijftoegang voor één werkgever geeft nooit wijzigingsrecht bij een andere. De client kan een tool tonen die voor een andere geselecteerde werkgever beschikbaar is; bij elke aanroep worden de rechten voor de opgegeven werkgever gecontroleerd.
Een koppeling met alleen leestoegang kan geen gegevens aanmaken, wijzigen of verwijderen. Met schrijfmachtigingen kunnen omkeerbare acties, zoals conceptshifts bewerken, onmiddellijk uitgevoerd worden. Acties met gevolgen voor anderen, zoals planning publiceren, vereisen een aparte bevestiging in Vesta.
Rapportgegevens lezen
Section titled “Rapportgegevens lezen”| Vraag | Tool | Leestoestemming |
|---|---|---|
| Shifts per werknemer en dag | get_planning | Planning |
| Beschikbaarheid per werknemer en dag | get_availability | Planning |
| Gewerkte tijd per werknemer en dag | list_time_entries | Gewerkte uren |
| Geplande en werkelijke kost per statuut, team of taak, per dag of maand | get_labor_cost_report | Loonkost |
Geef elke tool employerUniqueCode, from en to mee. Kostenrapportering aanvaardt ook groupBy
(Statute, Team, Task) en granularity (Day, Month), voor maximaal 93 inclusieve dagen.
Vraag expliciet een volledige kalendermaand als je maandtotalen nodig hebt.
Beschikbaarheden gebruiken offset en limit (1 tot 100, standaard 100); volg de teruggegeven
volgende offset. De periode is maximaal 42 inclusieve dagen. Ontbrekende beschikbaarheid is onbekend,
geen weigering om te werken. Tijdsregistraties gebruiken offset en limit (standaard 50, maximaal
100); haal elke pagina op voordat je voltooide registraties optelt. Planning bevat Concept- en Published-shifts over maximaal 42 inclusieve dagen. Het planningsoverzicht is
begrensd; beperk tot een werknemer of vestiging bij gedeeltelijke uitvoer, of gebruik de gepagineerde
klanten-API voor een volledige export van gepubliceerde shifts.
De rapporthandleiding van de klanten-API beschrijft
het gedeelde kostenantwoord: conceptplanning telt mee, lopende werkelijke cijfers gelden op asOf,
afwezigheden ontbreken en onbekende of geschatte kosten moeten zichtbaar blijven. Het gaat om
operationele kost, niet de definitieve loonafrekening.
MCP en de klanten-API
Section titled “MCP en de klanten-API”MCP gebruikt een persoonlijke OAuth-koppeling. Gebruik de klanten-API voor automatische rapportering vanuit je server: de clientgegevens horen bij precies één werkgever en de scopes geven alleen leestoegang. Tokens voor de klanten-API en MCP zijn afzonderlijk en kunnen niet tussen beide diensten worden uitgewisseld of hergebruikt.
Toegang beheren
Section titled “Toegang beheren”Open Instellingen > Account > Koppelingen in Vesta om de machtigingen en werkgevers van een koppeling te bekijken of de toegang in te trekken. Intrekking wordt bij volgende aanvragen gecontroleerd. Wordt de koppeling geweigerd, controleer dan je rol, de geselecteerde werkgever, de productmodules en de instellingen van Vesta AI voor je opnieuw koppelt.
Verbinding controleren
Section titled “Verbinding controleren”De MCP-host biedt OAuth-discovery via https://mcp.vesta.services/.well-known/oauth-authorization-server en metadata over de beveiligde resource via https://mcp.vesta.services/.well-known/oauth-protected-resource/mcp.
Op 13 oktober 2026 antwoordden beide discovery-endpoints succesvol. Het MCP-endpoint gaf aan POST te ondersteunen; /mcp rechtstreeks openen in een browser kan 405 Method Not Allowed opleveren. Een initialisatie-POST zonder aanmelding gaf 401 met OAuth-discovery in WWW-Authenticate. Dit bevestigt de publieke bereikbaarheid en authenticatievereiste, geen geauthenticeerde werkgeverssessie. Controleer je koppeling door toestemming te geven, de client tools te laten oplijsten en een kleine periode voor je werkgever op te vragen.
Ontbreken tools, controleer dan de leesmachtigingen van de koppeling en je actuele rechten in Vesta. Koppel opnieuw als de toestemming ingetrokken of verlopen is. Stuur nooit toegangstokens of clientgeheimen naar support; deel de foutmelding en aanvraag-ID.