Amfy in je AI-assistent

Wat je kunt vragen

Met MCP (Model Context Protocol) koppel je een AI-assistent aan je eigen gegevens. Koppel je Amfy, dan kun je bijvoorbeeld vragen:

• Hoeveel kWh heb ik in september thuis geladen, en wat heb ik daarmee verdiend?
• Op welke dagen heb ik deze maand het meest geladen?
• Zet mijn laadsessies van oktober per week in een tabel.

De assistent gebruikt daarvoor twee tools: list_chargers (je laadpalen) en list_sessions (je laadsessies, met de totalen van een periode). Ze kunnen alleen lezen: de assistent kan niets aan je account of je laadpaal veranderen. De velden zijn dezelfde als in de API voor ontwikkelaars.

De server staat op https://api.amfy.nl/mcp. Een sleutel heb je niet nodig: bij het koppelen opent er een venster van Amfy, waarin je inlogt met het e-mailadres van je Amfy-account en een code die je per mail krijgt. Daarna zie je wat de assistent mag, en geef je toegang.

Claude

In Claude op het web en in de desktop-app koppel je Amfy als connector:

1. Ga naar Customize → Connectors en kies Add custom connector.
2. Vul als naam Amfy in en als URL https://api.amfy.nl/mcp. Vraagt Claude hoe je inlogt, kies dan Sign in now; de rest laat je staan. Kies Add.
3. Kies Connect. Er opent een venster van Amfy: log in met je e-mailadres en de code uit de mail, en kies Toegang geven.
4. Stel je vraag in een nieuw gesprek.

Heb je Claude via je werk (Team of Enterprise)? Dan voegt een beheerder de connector toe onder Organization settings → Connectors, en kies jij bij Amfy onder Customize → Connectors voor Connect.

Claude Code

Voeg de server toe in je terminal:

claude mcp add --transport http amfy https://api.amfy.nl/mcp

Typ daarna in Claude Code /mcp, kies amfy en log in. Je browser opent het venster van Amfy; na Toegang geven kun je je vraag stellen. Gebruik je Claude Code op meer computers, dan werkt de koppeling op de computer waar je het laatst inlogde.

Andere apps

Andere assistenten en editors die MCP met inloggen ondersteunen, zoals ChatGPT, Cursor en Visual Studio Code, vragen alleen om de URL https://api.amfy.nl/mcp. Bij het koppelen opent het venster van Amfy om in te loggen. Apps die MCP-servers in een configuratiebestand zetten, gebruiken meestal deze vorm:

{
  "mcpServers": {
    "amfy": {
      "url": "https://api.amfy.nl/mcp"
    }
  }
}

De precieze stappen verschillen per app; kijk in de handleiding van de app naar een server via HTTP, met OAuth.

Toegang intrekken

In de Amfy-app zie je onder Profiel → Gekoppelde apps welke apps toegang hebben, wanneer je ze koppelde en wanneer ze voor het laatst iets ophaalden. Kies Intrekken en de app kan meteen niet meer bij je gegevens; ook een token dat hij al had, werkt dan niet meer.

Wil je de app later weer gebruiken, koppel hem dan opnieuw vanuit de app zelf. Een app die 90 dagen niets bij ons ophaalt, moet je ook opnieuw koppelen.

Veiligheid en privacy

• Een gekoppelde app leest alleen je laadpalen en laadsessies. Je profiel, je rekeningnummer en je uitbetalingen zitten er niet in, en veranderen kan niet.
• Je logt altijd in bij Amfy zelf, op api.amfy.nl. De app die je koppelt, ziet je e-mailadres en je code niet.
• Voordat je toegang geeft, zie je welke app het is en waar je daarna naartoe gaat. Herken je de app niet, kies dan Annuleren.
• Wij bewaren de tokens van een app niet zelf, alleen een onleesbare afgeleide (hash). Trek je de toegang in, dan werken ze meteen nergens meer.
• Wat een andere app of assistent met je gegevens doet, valt onder het privacybeleid van die app. Hoe wij met je gegevens omgaan, lees je in de privacyverklaring.

Vragen over de API? Mail ons via [email protected].