Uitleg en tools

Deze server is een brug tussen Claude en AFAS Profit. Claude weet niet vooraf wat er in jullie omgeving staat: hij ontdekt dat zelf via de tools hieronder en stelt daarmee de juiste vraag aan AFAS. Jij hoeft geen veldnamen of connectors te kennen.

Verbinden in Claude

Open de connector-instellingenIn Claude bij Settings, onder Connectors, kies je een aangepaste connector toevoegen.
Vul deze server-URL inHet adres van deze pagina, met /mcp erachter.
Log inVul je e-mailadres in en daarna de eenmalige code die je per mail ontvangt; er is geen wachtwoord. Daarna verschijnt de connector als Vpact AFAS Connector.
Test met een simpele vraag“Welke AFAS-datasets kun je zien?” bewijst in één keer dat de hele keten werkt.

Voorbeeldvragen

Welke gegevenssets kun je uit AFAS ophalen?

Haal alle inkoopfacturen op van project [projectnaam] en tel ze op per leverancier.

Welke taken staan open per afdeling, en welke zijn over hun deadline?

Laat de verkoopfacturen van deze maand zien, gesorteerd op bedrag.

Vraag bij een verrassend antwoord om de onderbouwing: welke dataset is gebruikt, welk filter en hoeveel records. De server logt dat ook, maar in het gesprek is het het snelst.

Beschikbare tools

Deze 8 tools kan Claude aanroepen. Je hoeft ze niet zelf te kiezen; het is wel handig te weten wat er kan, en wat niet.

Ontdekken

Connector- en veldnamen verschillen per AFAS-omgeving. Claude begint hier, zodat hij met de echte namen werkt in plaats van met een gok.

afas_list_connectors

Laat zien welke datasets deze AFAS-omgeving vrijgeeft. Ook de snelste manier om te zien of de verbinding staat.

afas_describe_connector

Toont de velden van één dataset: technische naam, label, type, lengte en, waar een codetabel hangt, de toegestane waarden.

afas_version

Geeft de actieve Profit-versie. Bewijst in één aanroep dat token, omgevingsnummer en AppConnector samen werken.

Lezen

Het werkpaard: records ophalen met filters, sortering en paginering.

afas_query

Leest records met filters, sortering en paginering. Filters kunnen gecombineerd worden met en/of, en desgewenst loopt hij alle pagina’s door.

Bestanden

Bijlagen, afbeeldingen en rapporten die als bestand uit Profit komen.

afas_get_file

Haalt een bestand op via de FileConnector, op basis van de GUID en de originele bestandsnaam.

afas_get_attachment

Haalt een bijlage van een dossieritem op via de SubjectConnector.

afas_get_image

Haalt een afbeelding op via de ImageConnector, bijvoorbeeld een pasfoto of een artikelfoto.

afas_run_report

Genereert een Profit-rapport via de ReportConnector op basis van de rapport-GUID.

Waar de grenzen liggen

Alleen lezen. Er is geen enkele tool die iets aanmaakt, wijzigt of verwijdert in AFAS.
Alleen de datasets die in AFAS zijn vrijgegeven aan de AppConnector. Mist er iets, dan moet die connector daar eerst worden toegevoegd.
Grote uitvragen worden begrensd. Bij een heel brede vraag komt er een deel terug met de melding dat je scherper moet filteren.
Geen realtime meldingen. Claude kijkt op het moment dat je iets vraagt; hij houdt AFAS niet in de gaten.
AFAS hanteert een fair-use beleid. Steeds opnieuw hele datasets ophalen valt daar op.

Voor de beheerder

De AFAS-koppeling (omgevingsnummer en AppConnector-token) beheer je op /instellingen. Inloggen gaat met je e-mailadres en een eenmalige code; na het opslaan test de server de verbinding direct.

Veiligheid

De verbinding loopt over HTTPS en vereist een geldige login; zonder token komt er niets uit deze server. Het AFAS-token zelf staat alleen op de server en verlaat die nooit, ook niet richting Claude. Van elke aanroep wordt vastgelegd wie hem deed, welke tool het was en hoeveel gegevens eruit kwamen. Filterwaarden worden in die logs weggelaten, omdat daar bedrijfsgegevens in kunnen zitten.

Gebouwd en beheerd door Vpact.