Wat is het?
- De API is een technische toegangsdeur tot je gegevens in Appficient. Een eigen systeem of een externe partij kan daarmee bijvoorbeeld relaties, facturen of projecten lezen en aanmaken. Daarvoor is een API key nodig.
- MCP is een manier om AI-tools, zoals Claude of ChatGPT, veilig met Appficient te laten werken. Je vraagt dan in je AI-tool bijvoorbeeld: "Welke facturen van deze maand staan nog open?"
Waar vind je het
- API keys: in het omgevingsmenu bovenin via Mijn omgeving, tabblad API keys.
- AI-koppelingen: Instellingen → Koppelingen → Apps en integraties, kaarten Claude, ChatGPT en Andere AI-tools.
Zo werkt het: een API key aanmaken
- Open in het omgevingsmenu bovenin Mijn omgeving en ga naar het tabblad API keys.
- Klik op API key aanmaken.
- Geef de key een Label, bijvoorbeeld de naam van het systeem dat hem gaat gebruiken.
- Kies per onderdeel welke toegang de key krijgt: Lezen of Beheren. Beheren omvat lezen. Geef niet meer toegang dan nodig is.
- Klik op Aanmaken.
- Kopieer de key direct met Kopiëren en geef hem veilig door aan je ontwikkelaar. Bewaar deze key nu — hij wordt niet opnieuw getoond.
In de lijst zie je per key de toegang, wanneer hij voor het laatst is gebruikt en de status Actief of Ingetrokken. Met Bewerken pas je de toegang aan, met Dupliceren maak je een kopie, en met Intrekken zet je de key uit. Integraties die de key gebruiken, stoppen dan direct met werken.
Zo werkt het: een AI-tool koppelen
- Ga naar Instellingen → Koppelingen → Apps en integraties en open Claude, ChatGPT of Andere AI-tools.
- Kopieer de server-URL die op de pagina staat.
- Volg de stappen op de pagina. Bij Claude voeg je in Claude een eigen connector toe met die URL; bij ChatGPT maak je een connector aan met OAuth als authenticatie.
- Log in met je Appficient-account, kies de omgeving en het toegangsniveau, en klik op Toestaan.
Je kiest uit drie toegangsniveaus:
- Alleen lezen
- Lezen en schrijven
- Lezen, schrijven en versturen: de AI mag dan ook reacties op tickets en documenten zoals facturen, offertes en werkbonnen mailen, alleen naar bekende adressen.
Werkt je AI-tool niet met inloggen? Bij Andere AI-tools maak je dan een aparte sleutel aan met Sleutel aanmaken. Die sleutel werkt alleen voor AI-koppelingen.
Wie heeft toegang?
- API keys en sleutels voor AI-tools kunnen alleen de eigenaar en beheerders van de omgeving aanmaken.
- Een AI-tool koppelen via inloggen kan elke gebruiker. De AI kan dan nooit meer dan die gebruiker zelf.
- Verwijderen en definitief maken, zoals een factuur boeken, kan niet via AI.
Intrekken
- Je eigen gekoppelde AI-apps zie je bij Instellingen → Persoonlijk → Profiel, onder Gekoppelde AI-apps.
- Beheerders zien alle koppelingen in Mijn omgeving, tabblad API keys.
- Op de pagina van de AI-koppeling trek je toegang in met Koppeling intrekken of Sleutel intrekken.
Goed om te weten
- Technische details, zoals de beschikbare gegevens, rechten per onderdeel en voorbeelden, staan in de developerdocumentatie van Appficient. Geef die door aan je ontwikkelaar.
- Behandel een API key als een wachtwoord. Deel hem niet per e-mail met onbekenden en trek hem in als je denkt dat iemand anders hem heeft.
- Het tabblad API keys zie je alleen bij een actief abonnement.
- Zie je deze onderdelen niet? Dan heb je er geen rechten voor of het zit niet in jullie abonnement. Vraag het je beheerder.
Veelgestelde vragen
Ik ben mijn API key kwijt. Kan ik hem opnieuw bekijken?
Nee. Maak een nieuwe key aan en trek de oude in.
Kan Claude mijn facturen verwijderen?
Nee. Verwijderen en definitief maken kan niet via AI.
Heb ik een API key nodig om Claude of ChatGPT te koppelen?
Nee. Bij Claude en ChatGPT log je in met je Appficient-account. Een sleutel is alleen nodig voor AI-tools die niet met inloggen werken.