Met de MCP-koppeling (Model Context Protocol) laat je een AI-assistent zoals ChatGPT of Claude rechtstreeks gegevens opzoeken in je EenvoudigFactureren-account. Je stelt je vraag in gewone taal, de assistent haalt het antwoord uit je eigen klanten, verkoopfacturen, aankoopfacturen en leveranciers.

De koppeling is momenteel alleen-lezen: je assistent kan je klanten, verkoopfacturen, aankoopfacturen en leveranciers raadplegen, maar niets aanmaken, wijzigen of verwijderen.

Wat je nodig hebt

  • Een API-sleutel van EenvoudigFactureren. Die maak je aan via Toegangsbeheer > API-sleutel toevoegen; geef ze een herkenbare naam, bijvoorbeeld ChatGPT of Claude. Hoe dat precies werkt, lees je in API-toegang instellen.
  • Het adres van de MCP-server: https://mcp.eenvoudigfactureren.be/mcp

De server verwacht je API-sleutel als HTTP-header X-API-Key. Gebruik dus geen Bearer-authenticatie.

Koppelen met ChatGPT

1. Ontwikkelaarsmodus activeren

Om een eigen MCP-server toe te voegen, moet in ChatGPT eerst de ontwikkelaarsmodus aanstaan. Ga naar de instellingen van ChatGPT, open Apps en activeer bij de geavanceerde instellingen Developer mode / Ontwikkelaarsmodus.

Of deze optie beschikbaar is, hangt af van je ChatGPT-abonnement en de instellingen van je workspace. In een teamworkspace kan enkel de beheerder of eigenaar ze aanzetten.

2. EenvoudigFactureren toevoegen

  1. Ga naar Instellingen > Plug-ins > Maken en voeg een nieuwe MCP-koppeling toe.
  2. Vul in:
    • Naam: EenvoudigFactureren
    • Beschrijving: Read-only customer, supplier, sales and purchase invoice lookup for EF
    • URL van server: https://mcp.eenvoudigfactureren.be/mcp
    • Authenticatie: Access token / API-sleutel
  3. Bij Schema voor header open je de keuzelijst die standaard op Bearer staat en kies je X-API-Key. Moet je een aangepaste header opgeven, vul dan exact X-API-Key in.
  4. Vul je EenvoudigFactureren API-sleutel in het sleutelveld in.
  5. Laat ChatGPT de beschikbare tools ophalen en maak de koppeling aan.

3. EenvoudigFactureren gebruiken

Start een nieuwe chat en activeer EenvoudigFactureren bij de beschikbare apps of tools, of verwijs er rechtstreeks naar in je vraag. ChatGPT gebruikt dan de gegevens uit je account.

Koppelen met Claude Desktop

Claude Desktop maakt verbinding met de MCP-server via mcp-remote. Daarvoor moet Node.js op je computer geïnstalleerd zijn.

  1. Open in Claude Desktop de MCP-configuratie: Instellingen > Developer > Edit Config. Dit opent het bestand claude_desktop_config.json.
  2. Voeg onderstaande configuratie toe en vervang JOUW_API_KEY door je EenvoudigFactureren API-sleutel:
{
  "mcpServers": {
    "eenvoudigfactureren": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.eenvoudigfactureren.be/mcp",
        "--header",
        "X-API-Key:JOUW_API_KEY"
      ]
    }
  }
}
  1. Sla het bestand op en herstart Claude Desktop.

EenvoudigFactureren staat daarna tussen je MCP-servers en Claude kan de beschikbare tools gebruiken.

Koppelen met Claude Code

Gebruik je Claude Code, dan voeg je de MCP-server rechtstreeks toe via de command line. Vervang JOUW_API_KEY door je API-sleutel:

claude mcp add --transport http --header "X-API-Key: JOUW_API_KEY" EenvoudigFactureren https://mcp.eenvoudigfactureren.be/mcp

Controleer de verbinding met:

claude mcp list

Binnen Claude Code toont /mcp de status van de verbinding en de beschikbare tools.

Goed om te weten: in de webversie van Claude (claude.ai) kan je de koppeling momenteel nog niet zelf toevoegen, omdat je daar geen eigen API-sleutel als header kan instellen. Gebruik Claude Desktop of Claude Code.

Wat je kan vragen

Enkele voorbeelden om mee te starten:

  • Hoeveel facturen heb ik deze maand aangemaakt?
  • Wat is mijn omzet van deze maand?
  • Welke klant heeft deze maand de hoogste omzet?
  • Zoek klant Janssens.
  • Welke facturen heb ik voor klant Janssens?
  • Welke aankoopfacturen staan nog open?
  • Hoeveel betaalde ik dit kwartaal aan leverancier Proximus?

Controleer bij je eerste vragen of de assistent effectief de EenvoudigFactureren-tool gebruikt (dat zie je in de chat) en het antwoord niet zelf verzint.

Beveiliging

Je API-sleutel geeft toegang tot de gegevens van je account. Behandel ze daarom zoals een wachtwoord:

  • deel je API-sleutel niet met anderen;
  • zet de sleutel niet in openbare configuratiebestanden of repositories;
  • verwijder of vervang de sleutel via Toegangsbeheer wanneer je vermoedt dat ze ongewenst werd gedeeld.

De MCP-koppeling is alleen-lezen: via ChatGPT of Claude kunnen geen gegevens in EenvoudigFactureren gewijzigd worden.