MCP-server

Met de MCP-server van Picqer laat je een AI-assistent werken met je Picqer-gegevens, zoals bestellingen, producten en voorraad. Je stelt eenmalig een profiel in en koppelt daarna elke AI-assistent die MCP ondersteunt.

De MCP-server is een bèta. Het is een publieke test, dus functies kunnen nog wijzigen.

Wat een assistent kan doen

Een gekoppelde assistent leest gegevens uit Picqer en beantwoordt daar vragen over, zoals bestellingen, picklijsten, producten en voorraad.

Geef je een profiel schrijfrechten, dan kan de assistent ook wijzigingen doorvoeren, zoals bestellingen pauzeren, picklijsten toewijzen en voorraad corrigeren.

Een aantal onomkeerbare acties is bewust niet beschikbaar, zoals bestellingen verwerken, picklijsten afsluiten en zendingen aanmaken. Die stappen doe je zelf in Picqer.

MCP-server instellen

De MCP-server draait op een eigen omgeving naast Picqer. Je maakt daar een account aan en koppelt je Picqer-account met een API key. Je hebt beheerdersrechten in Picqer nodig, want alleen beheerders maken API keys aan.

Ga naar mcp.picqertest.com en klik op 'Create account' om een account aan te maken met je e-mailadres.
Open 'Security' en klik op 'Enable two-factor authentication'. Tweestapsverificatie is verplicht voordat je een profiel kunt aanmaken. Bewaar de herstelcodes op een veilige plek.
Maak in Picqer een API key aan voor deze koppeling. Gebruik een aparte key, zodat je die later los kunt intrekken.
Klik op 'New profile' en vul 'Profile name', 'Picqer subdomain' en 'Picqer API key' in. Kies onder 'Safeguards' wat de assistent mag.
Kopieer de 'Connection URL' van het profiel en voeg die in je AI-assistent toe als MCP-connector. Bij het koppelen log je in op je MCP-account en geef je de assistent toestemming.

Beheerders vinden deze stappen ook terug op de MCP-pagina in Picqer.

Wat je per profiel bepaalt

Een profiel bepaalt tot welk Picqer-account en welke gegevens een assistent toegang heeft. Elk profiel heeft een eigen 'Connection URL', dus je kunt meerdere profielen naast elkaar gebruiken met verschillende rechten.

Access mode: bij 'Read only' kan de assistent alleen gegevens opvragen. Bij 'Read & write' komen ook de tools beschikbaar waarmee de assistent gegevens aanmaakt en bijwerkt.
Expose customer data (PII): staat dit uit, dan zijn de tools voor klanten, gebruikers en opmerkingen niet beschikbaar en worden persoonsgegevens uit bestellingen en picklijsten weggelaten. Zet dit alleen aan als de assistent klantgegevens echt nodig heeft.

Veiligheid

Je API key blijft op de MCP-server, wordt versleuteld opgeslagen en gaat nooit naar de AI-assistent. De assistent werkt alleen via de 'Connection URL' van het profiel.

Wil je een koppeling stoppen? Verwijder het profiel op de MCP-server en trek de bijbehorende API key in Picqer in.

Loop je ergens tegenaan of mis je iets? Laat het ons weten.