API en AI-koppeling

Count-IT API en AI-koppeling via MCP

Koppel je eigen software of website via de REST API, of geef een AI-assistent via de MCP-server toegang tot je gegevens. Altijd binnen de rechten die jij toekent, en op elk moment in te trekken.

In het kort

Count-IT heeft een REST API met OAuth2 voor eigen software en websites, en een MCP-server waarmee een AI-assistent je gegevens kan lezen en, als je dat toestaat, bijvoorbeeld producten en webpagina's kan bewerken. Een API-app of MCP-token krijgt nooit meer rechten dan de gebruiker die hem goedkeurt of maakt.

  • REST API met OAuth2: toegang per bedrijf en per onderdeel, bekijken of wijzigen
  • MCP-token met toegangsniveau: alleen lezen (standaard), toevoegen en bewerken, of ook verwijderen
  • Mis je gegevens? Op basis van jouw behoefte maken we (nagenoeg) alles beschikbaar via de API en MCP

Wat zijn de Count-IT API en de MCP-server?

Een API (application programming interface) is een vaste manier waarop software met elkaar praat. Via de Count-IT API kan je eigen software, je website of een maatwerkkoppeling gegevens uit Count-IT ophalen en, waar dat mag, wijzigen. Het is een REST API met OAuth2: je software vraagt toestemming, jij keurt die goed in Count-IT en kiest welke gegevens de app mag gebruiken. Kant-en-klare koppelingen met boekhouding, webshops en vervoerders vind je bij koppelingen; de API is er voor alles wat je zelf wilt bouwen.

MCP (Model Context Protocol) is een open standaard waarmee AI-assistenten verbinding maken met andere systemen. Met de MCP-server van Count-IT kan een AI-assistent die MCP ondersteunt, bijvoorbeeld ChatGPT of Claude, je gegevens raadplegen. Je schakelt AI-gegevenstoegang per administratie in en maakt een persoonlijk MCP-token. Daarmee werkt de assistent binnen de rechten van jou als maker van het token.

Zo kun je een assistent in gewone taal vragen stellen over je gegevens, of hem producten, vertalingen en webpagina's laten bijwerken als je dat toestaat. Jij bepaalt het toegangsniveau en controleert wat de assistent wijzigt. Heb je gegevens of functies nodig die er nu nog niet bij zitten? Op basis van jouw behoefte maken we (nagenoeg) alles beschikbaar via de API en MCP. Neem contact op en vertel wat je nodig hebt.

Mogelijkheden

Wat je met de API en MCP kunt

Beide werken binnen de gebruikersrechten die je in Count-IT al hebt ingericht.

Eigen software koppelen

Maak een API-app aan voor je eigen integratie. Je krijgt een clientidentiteit en geheim en vult een redirect-URI in: het adres waarop je software na goedkeuring terugkomt.

Toegang per bedrijf en onderdeel

Bij het goedkeuren kies je de bedrijven en per onderdeel, zoals producten of relaties, of de app mag bekijken en of de app mag wijzigen. Op het tabblad Gekoppelde apps pas je dat later aan of trek je de toegang in.

Producten, relaties, voorraad en meer

Via de API werk je nu onder meer met producten, prijzen, productgroepen, scancodes, afbeeldingen en productinfovelden, klanten, leveranciers en contactpersonen, voorraad en magazijnen, verkooporders en btw-codes. Meer nodig? Dat maken we op basis van jouw behoefte beschikbaar.

Je eigen website op Count-IT

Lees bijvoorbeeld webpagina's, fotoalbums en reviews uit het CMS, met afbeeldingen als openbare link. Voor een webshop is er een kant-en-klare catalogus met categorieën, actieve producten, prijs excl. btw, afbeeldingen en productinfovelden.

AI-assistent via MCP

Met een persoonlijk MCP-token kan een AI-assistent je gegevens lezen, bijvoorbeeld om vragen over verkoop of voorraad te beantwoorden. Alleen lezen is de standaard.

Teksten laten schrijven en vertalen

Met het toegangsniveau lezen, toevoegen en bewerken kan de assistent onder meer producten, productgroepen, webshopcategorieën en webshopproducten aanmaken en wijzigen, en hun vertalingen en die van productinfovelden bijwerken.

Webpagina's beheren

De assistent kan ook webpagina's van je website en webshops beheren, zoals een privacyverklaring: titel, inhoud, adres, metabeschrijving, zichtbaarheid, plaats in het menu en vertalingen. Daarvoor heeft de maker de rechten voor webpagina's nodig.

Veilig en intrekbaar

Een app of token kan nooit meer dan de rechten van de gebruiker. Een wijziging van het toegangsniveau geldt direct, en een ingetrokken app of token werkt niet meer.

Zo werkt het

Van eerste koppeling tot beheer

  1. API-app aanmaken

    Maak een API-app aan en vul de redirect-URI in. Die moet exact overeenkomen met het adres dat je software meestuurt.

  2. Goedkeuren

    Keur de app goed en kies de bedrijven en per onderdeel bekijken of wijzigen. Zet uit wat de app niet nodig heeft.

  3. Bouwen met de documentatie

    De technische documentatie beschrijft authenticatie, endpoints, velden, filteren, sorteren en paginering. Importeer de OpenAPI-specificatie bijvoorbeeld in Postman.

  4. Of: AI koppelen via MCP

    Schakel AI-gegevenstoegang in, maak onder App connector een MCP-token met een herkenbare naam, een einddatum en het juiste toegangsniveau.

  5. Beheren en intrekken

    Trek een token in als het niet meer nodig is of mogelijk is gelekt. Een app die 90 dagen niet is gebruikt, keur je opnieuw goed.

Eerlijk is eerlijk

Goed om te weten

Zo weet je vooraf wat je kunt verwachten.

  • De technische API-documentatie is alleen in het Engels beschikbaar.
  • Count-IT levert de API en de MCP-server, niet de AI-assistent zelf. Die kies en regel je apart.
Veelgestelde vragen

Vragen over de API en AI-koppeling

Heeft Count-IT een API?

Ja. Count-IT heeft een REST API met OAuth2. Je maakt een API-app aan, keurt die goed en kiest per bedrijf en per onderdeel of de app gegevens mag bekijken en wijzigen. De app kan nooit meer dan jouw eigen gebruikersrechten.

Welke gegevens zijn beschikbaar via de API en MCP?

Nu onder meer producten, prijzen, productgroepen, productinfovelden, relaties, voorraad, verkooporders, btw-codes, webshops en de webpagina's, fotoalbums en reviews van het CMS. Mis je iets? Op basis van jouw behoefte maken we (nagenoeg) alles beschikbaar via de API en MCP. Neem contact op en vertel wat je nodig hebt.

Waar vind ik de API-documentatie?

De technische documentatie (Engelstalig) staat op start.count-it.eu/api/docs; inloggen is niet nodig. Je opent hem ook via de knop API-documentatie bij je API-apps. De specificatie is als OpenAPI-bestand te downloaden, bijvoorbeeld voor Postman.

Hoe koppel ik een AI-assistent aan Count-IT?

Schakel AI-gegevenstoegang in voor je administratie en maak onder App connector een persoonlijk MCP-token met een herkenbare naam en einddatum. Dat token gebruik je in een AI-assistent die MCP ondersteunt. Kies bij Toegangsniveau of de assistent alleen mag lezen of ook mag wijzigen.

Kan een AI-assistent gegevens in Count-IT wijzigen?

Alleen als je dat toestaat. Alleen lezen is de standaard. Met lezen, toevoegen en bewerken kan de assistent onder meer producten, productgroepen, webshopcategorieën en -producten, vertalingen, productinfovelden en webpagina's wijzigen; met het hoogste niveau ook verwijderen. Ook dan gelden de rechten van de maker van het token.

Is de AI-koppeling veilig?

Het token heeft nooit meer rechten dan de gebruiker die het maakt. Gebruik daarom een gebruiker met zo weinig mogelijk rechten, geef het token een einddatum, deel het nooit via e-mail of chat en trek het in bij verlies. Geef schrijfrechten alleen als het echt nodig is en controleer wijzigingen van de assistent.

Kan ik mijn eigen website bouwen op Count-IT?

Ja. Via de API lees je webpagina's, fotoalbums en reviews uit het CMS, en er is een kant-en-klare catalogus van een webshop met categorieën, actieve producten, prijzen excl. btw, afbeeldingen en productinfovelden. Liever geen eigen bouw? Kijk dan naar de website en webshop van Count-IT.

Wat doe ik als de MCP- of API-toegang niet werkt?

Controleer of de functie is ingeschakeld, het token of geheim nog geldig is, de einddatum niet is verstreken en de maker voldoende rechten heeft. Bij een API-app moet de redirect-URI exact overeenkomen, en na 90 dagen zonder gebruik keur je de app opnieuw goed. Meer staat in de kennisbank over koppelingen.

Bespreek je koppeling met ons

In een demo laten we zien hoe de API en de AI-koppeling werken, en denken we mee over welke gegevens jij nodig hebt.