Met de Milo MCP-koppeling werk je vanuit Claude Desktop rechtstreeks in je Milo-administratie. Je vraagt in gewone taal welke facturen er openstaan, laat Claude een conceptfactuur klaarzetten of uren boeken, en Claude gebruikt daarvoor jouw eigen Milo-gegevens.

Wat je nodig hebt

  • Een Milo-account met beheerdersrechten: alleen beheerders kunnen API-tokens aanmaken.
  • Claude Desktop op je computer.
  • Node.js (LTS-versie) van nodejs.org. De koppeling gebruikt dit om verbinding te maken.

Stap 1: maak een API-token aan

  1. Ga in Milo naar Beheer en kies API-tokens.
  2. Maak een nieuw token aan met een herkenbare naam, bijvoorbeeld "Claude Desktop". Een vervaldatum is optioneel.
  3. Kopieer het token meteen: het wordt maar één keer getoond.

Behandel het token als een wachtwoord. Het geeft toegang tot je administratie met jouw rechten. Intrekken kan altijd, op dezelfde pagina.

Stap 2: voeg Milo toe aan Claude Desktop

  1. Open Claude Desktop en ga naar Settings, tabblad Developer.
  2. Kies Edit Config. Het bestand claude_desktop_config.json opent in je editor.
  3. Voeg Milo toe onder mcpServers en zet je eigen API-token achter Bearer:
{
  "mcpServers": {
    "milo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.milomoves.app/mcp",
        "--header",
        "Authorization:${MILO_AUTH}"
      ],
      "env": {
        "MILO_AUTH": "Bearer plak-hier-je-api-token"
      }
    }
  }
}

Sla het bestand op en herstart Claude Desktop volledig: sluit de app helemaal af en open hem opnieuw. Daarna vind je de Milo-tools bij de tools onder het invoerveld van de chat.

Wat kun je vragen?

  • "Welke facturen staan er nog open?"
  • "Hoeveel heb ik deze maand gefactureerd?"
  • "Maak een conceptfactuur voor Jansen BV voor 8 uur consultancy."
  • "Schrijf 2 uur op het project Website voor vandaag."
  • "Welke uren van vorige maand zijn nog niet gefactureerd?"

Wat kan wel en niet?

Via de koppeling kan Claude je administratie lezen en werk voor je klaarzetten: facturen en offertes bekijken, klanten en projecten beheren, uren boeken en conceptfacturen maken.

Versturen, verwijderen, statuswijzigingen en bulkacties zijn bewust niet beschikbaar via de koppeling. Een conceptfactuur die Claude klaarzet, controleer en verstuur je dus zelf in Milo. Zo blijven de stappen met echte gevolgen altijd in jouw handen.

Goed om te weten: gegevens die Claude via de koppeling opvraagt, worden onderdeel van je gesprek met Claude en vallen onder de voorwaarden van je AI-tool.

Werkt het niet?

  • Zie je de Milo-tools niet? Herstart Claude Desktop volledig en controleer of de JSON-configuratie geldig is, bijvoorbeeld op een ontbrekende komma.
  • Krijg je een autorisatiefout? Dan is het token waarschijnlijk verlopen of ingetrokken. Maak in Milo een nieuw token aan en zet het in de configuratie.
  • Wordt npx niet gevonden? Installeer Node.js en herstart je computer.

Andere AI-tools

De koppeling gebruikt MCP (Model Context Protocol), een open standaard. Andere AI-tools die MCP ondersteunen, zoals Cursor, koppel je op dezelfde manier: hetzelfde adres, dezelfde configuratie, met je eigen API-token.

Liever niets installeren? De Milo-assistent zit gewoon in Milo web, rechtsonder in de chat, en voert dezelfde soort taken voor je uit.

Kom je er niet uit? Stel je vraag aan Milo via de chat rechtsonder, of mail naar [email protected].