Technische-documentatie-MCP

De Shine MCP-server verbindt je AI-assistent rechtstreeks met je Shine-facturatie- en boekhoudgegevens, zodat je facturen kunt opzoeken, kunt zien wat klanten je verschuldigd zijn en nieuwe facturen en offertes kunt opstellen zonder het gesprek te verlaten.

​Kerngegevens

De Shine MCP-server werkt met elke MCP-compatibele AI-assistent. Claude is de client waartegen we testen en die we aanbevelen: de installatie verloopt het soepelst en ons supportteam kan je ermee helpen.

Voor de verbinding heb je twee dingen nodig: de server-URL en het inloggen in je browser.

Bij het eerste gebruik opent je client een Shine-inlogpagina. Je logt in en keurt de verbinding goed. Je client is nu verbonden en klaar voor gebruik. De verbinding verloopt na 30 dagen, daarna moet je opnieuw inloggen.

Schakel eerst de ontwikkelaarsmodus in:

Voeg daarna de aangepaste connector toe:

Probeer na het verbinden bijvoorbeeld:

Of echte vragen zoals:

De verbinding gebruikt OAuth 2.1 met PKCE. Je logt in met je bestaande Shine-account: er is geen API-sleutel of wachtwoord dat je ergens hoeft te kopiëren, plakken of op te slaan.

De assistent werkt als jij, niet als beheerder of serviceaccount. Hij erft exact jouw Shine-rechten:

Iedereen met toegang tot jouw Shine-organisatie kan zelf de MCP-server verbinden. Wat diegene ermee kan doen, wordt begrensd door het eigen rechtenniveau, net zoals overal in Shine.

In de praktijk raden we aan dat de bedrijfseigenaar als eerste verbindt. De meeste AI-clients, Claude inbegrepen, ondersteunen maar één actieve MCP-verbinding tegelijk, en die moet worden geautoriseerd door de persoon die hem instelt. Als de eigenaar eerst verbindt, voorkom je verwarring wanneer meerdere teamleden de MCP willen gebruiken.

Je hoeft niet alles in één keer toe te staan. In Claude heeft de Shine-connector bijvoorbeeld een eigen instellingenpagina waar je afzonderlijke tools kunt in- of uitschakelen. Als je liever hebt dat de assistent alleen je gegevens leest en nooit concepten maakt, kun je de tools voor het opstellen daar uitzetten.

Je kunt de verbinding op elk moment verbreken vanuit je AI-client, door de Shine-connector te verwijderen in de instellingen. Dat is momenteel de enige manier om de toegang in te trekken: we bieden nog geen manier om de verbinding te verbreken vanuit de instellingen van Shine zelf.

Als je de toegang intrekt, wordt de assistent meteen losgekoppeld. Dit heeft geen invloed op je Shine-gegevens.

De MCP-server is alleen beschikbaar voor klanten met een van onze betaalde abonnementen: Smart, Plus en Complete.

Een AI-assistent koppelen aan je boekhoudgegevens is echt nuttig, maar brengt afwegingen met zich mee. Lees dit goed door voordat je de verbinding autoriseert.

1. Je koppelt een dienst van een derde partij. De Shine MCP-server is gebouwd en gehost door Shine en fungeert als een gecontroleerde toegangspoort tussen je assistent en je Shine-account. De assistent zelf, Claude, ChatGPT of een andere, wordt beheerd door een ander bedrijf. Het gebruik ervan valt onder de voorwaarden en het privacybeleid van dat bedrijf, niet onder die van ons.

2. Je gegevens worden gedeeld met dat bedrijf. Als je je assistent iets vraagt over je Shine-account, sturen wij de gegevens die nodig zijn voor het antwoord via de verbinding door. Die gegevens, waaronder klantgegevens, factuurbedragen en financiële cijfers, worden vervolgens verwerkt door de AI-aanbieder van je keuze.

3. Dat bedrijf kan je gegevens voor eigen doeleinden gebruiken. Zodra de gegevens bij je AI-aanbieder zijn aangekomen, heeft die de controle, niet wij. Lees de voorwaarden en het privacybeleid van de aanbieder voordat je verbindt en controleer hoe de aanbieder omgaat met bewaartermijnen, opslaglocatie en toegang. In de meeste gevallen kun je ervoor kiezen dat het bedrijf je gegevens niet gebruikt voor training.

4. Wij bepalen en beperken wat de verbinding kan doen. Wij bepalen welke acties via deze verbinding beschikbaar zijn en we kunnen die op elk moment beperken of intrekken. Gevoelige acties, zoals documenten versturen, boekingen goedkeuren, geld verplaatsen en aangiftes indienen, zijn bewust niet beschikbaar. Zie hoofdstuk 7.

5. AI-assistenten maken fouten. Ook als wij de juiste gegevens teruggeven, kan je assistent ze verkeerd lezen, onjuist samenvatten of een antwoord geven dat overtuigend klinkt maar fout is. Antwoorden worden onafhankelijk door je AI-aanbieder gegenereerd en niet door ons gecontroleerd. Controleer alles wat belangrijk is rechtstreeks in Shine voordat je erop handelt.

6. Jij bent verantwoordelijk voor het controleren van alles wat de assistent opstelt. Concepten die hij maakt zijn echte gegevens in je Shine-account. Controleer ze voordat je ze goedkeurt of verstuurt.

7. De beveiliging hangt deels af van je AI-account. Als iemand toegang krijgt tot je AI-assistentaccount, of je AI-aanbieder te maken krijgt met een datalek, kan diegene bij de Shine-gegevens komen die via de assistent zijn gedeeld. Gebruik een assistentaccount dat je vertrouwt en controleer de beveiligingsinstellingen ervan voordat je verbindt.

8. Wees voorzichtig met wat je verder koppelt. Als je de Shine-verbinding gebruikt naast andere MCP-servers of tools die je niet vertrouwt, kan een kwaadaardige in dezelfde sessie mogelijk de gegevens lezen die door onze server worden teruggegeven. Koppel alleen tools van bronnen die je vertrouwt.

9. Dit is geen financieel, boekhoudkundig, fiscaal of juridisch advies. Informatie die je via deze verbinding krijgt, is geen advies of aanbeveling van Shine en vervangt geen controle door een gekwalificeerde professional. Je hebt zelf onafhankelijk voor je assistent gekozen en beslissingen op basis van zijn antwoorden zijn van jou.

10. Jij bent verantwoordelijk voor hoe de verbinding wordt gebruikt. Dat omvat het kiezen van de assistent, de beslissing of je wel of niet verbindt en ervoor zorgen dat iedereen die de verbinding namens jouw organisatie gebruikt, bevoegd is om de betrokken gegevens te zien.

Hieronder staat alles wat de assistent vandaag kan.

Deze eerste bètaversie ondersteunt geen van de onderstaande dingen. We werken aan extra mogelijkheden waarmee sommige ervan mogelijk worden, mocht je meer automatisering willen verkennen.

De connector kan niet worden toegevoegd, of ik krijg “couldn’t connect to server”?

De inlogpagina opent, maar de toegang wordt geweigerd of de verbinding mislukt?

Hij is met het verkeerde bedrijf of de verkeerde gebruiker verbonden?

Mijn client meldt dat er al een andere MCP-verbinding actief is?

Er staat dat de authenticatie is verlopen, of tools falen ineens?

Het werkt niet meer nadat mijn proefperiode is afgelopen of ik naar het gratis abonnement ben overgestapt?

Ik krijg rechtenfouten nadat mijn Shine-abonnement of mijn rechten zijn gewijzigd?

Er zijn nieuwe tools uitgebracht, maar ik zie ze niet?

Ik zie sommige aangekondigde tools niet, hoe komt dat?

De assistent gebruikt Shine niet, of gebruikt een andere connector?

Lezen werkt, maar opstellen niet (of andersom)?

De assistent zegt dat hij iets niet kan versturen, goedkeuren, als betaald markeren of annuleren?

De tool gaf een deel van mijn gegevens niet terug (facturen, offertes, klanten, artikelen…)?

Ik krijg lege resultaten?

De bedragen komen niet overeen met wat ik in Shine zie?

Ik kan het concept dat de assistent heeft gemaakt niet vinden?

Het uploaden van een bewijsstuk mislukt?

Neem contact op met de Shine-support en vermeld daarbij: je AI-client en versie, de exacte foutmelding, het ongeveer tijdstip waarop het gebeurde en je Shine-organisatie. Stuur geen schermafbeeldingen met gevoelige klant- of financiële gegevens.