slim-down als MCP Server voor Claude en andere AI-agents

slim-down biedt een eigen MCP-server (Model Context Protocol) op /mcp, zodat Claude Desktop, Claude Code en andere MCP-clients de conversietools direct kunnen aanroepen β€” zonder dat je zelf curl-commando's of REST-code hoeft te schrijven.

Waarom een MCP-server?

Met MCP hoeft een AI-agent geen HTTP-verzoeken meer op te bouwen: hij ziet convert en convert_file gewoon als tools, net zoals hij ook lokale bestanden of andere ingebouwde functies zou aanroepen. Dat maakt slim-down direct bruikbaar in een gesprek met Claude, zonder losse integratiecode.

Hoe stel je het in?

  1. Maak een gratis account aan en haal je persoonlijke API-sleutel op via Mijn Account.
  2. Voeg slim-down toe aan je MCP-clientconfig (bijvoorbeeld claude_desktop_config.json) met de /mcp-URL en je API-sleutel als Authorization: Bearer header.
  3. Vraag Claude om een document te converteren β€” de agent roept vanzelf de convert of convert_file tool aan en krijgt schone Markdown (of een Word/Excel-bestand) terug.

Claude.ai & Claude Desktop β€” zonder API-sleutel

Dit is de makkelijkste manier: je plakt geen sleutel, maar logt in met je slim-down-account. Ga in Claude naar Instellingen β†’ Connectors, kies "Add custom connector" en vul deze URL in:

https://slim-down.nl/mcp

Claude stuurt je daarna naar slim-down om in te loggen en toestemming te geven. Daarna zie je de tools convert en convert_file in je gesprek. Je kunt de toegang op elk moment weer intrekken via Connectors.

Claude Code β€” één commando

Dit is de snelste manier en werkt op elk besturingssysteem. Open een terminal, vervang <JOUW_API_SLEUTEL> door je eigen sleutel (te vinden via Mijn Account) en voer uit:

claude mcp add --transport http slim-down https://slim-down.nl/mcp \
  --header "Authorization: Bearer <JOUW_API_SLEUTEL>"

Controleer daarna met /mcp in Claude Code of de server verbonden is. Je ziet dan de tools convert en convert_file staan.

Claude Desktop β€” via een bridge

Claude Desktop leest in claude_desktop_config.json alleen lokale servers, geen directe URL's. Het hulpprogramma mcp-remote overbrugt dat: het draait lokaal en praat namens Claude Desktop met onze server. Je hebt hiervoor Node.js nodig.

claude_desktop_config.json
{
  "mcpServers": {
    "slim-down": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://slim-down.nl/mcp",
        "--header", "Authorization: Bearer <JOUW_API_SLEUTEL>"
      ]
    }
  }
}

Staat er al een "mcpServers"-blok in je bestand (bijvoorbeeld voor een andere tool)? Overschrijf het bestand dan niet, maar voeg alleen de regel "slim-down": { ... } toe binnen dat bestaande blok.

Sla het bestand op, sluit Claude Desktop daarna volledig af en start het opnieuw op β€” servers worden alleen bij het opstarten ingeladen.

Waar vind ik claude_desktop_config.json?

Bestaat dit bestand nog niet op jouw computer? Geen probleem β€” maak het gewoon zelf aan op onderstaand pad.

🍎 macOS
~/Library/Application Support/Claude/claude_desktop_config.json
πŸͺŸ Windows
%APPDATA%\Claude\claude_desktop_config.json

Dat is meestal: C:\Users\<jouw-gebruikersnaam>\AppData\Roaming\Claude\claude_desktop_config.json. Tip: plak %APPDATA%\Claude in de adresbalk van de Verkenner om er direct naartoe te gaan.

🐧 Linux
~/.config/Claude/claude_desktop_config.json

Claude Desktop wordt door Anthropic nog niet officieel voor Linux uitgebracht; dit pad geldt voor community-builds.

Veelgestelde vragen

Wat is de slim-down MCP-server precies?

Het is een implementatie van het Model Context Protocol bovenop dezelfde conversielogica als de REST API, bereikbaar op /mcp. In plaats van zelf HTTP-verzoeken te bouwen, ziet een MCP-client zoals Claude Desktop de conversiefuncties gewoon als kant-en-klare tools.

Welke tools biedt de MCP-server aan?

Twee tools: convert voor tekst en gestructureerde data (zoals POST /api/convert), en convert_file voor geΓΌploade bestanden zoals PDF, Word, PowerPoint, Excel, Jupyter Notebooks en ondertitels (zoals POST /api/convert-file).

Heb ik een account nodig om de MCP-server te gebruiken?

Ja. In tegenstelling tot de website zelf kent de MCP-server geen gratis anonieme conversies: je hebt een persoonlijke API-sleutel nodig, dezelfde die je ook voor de REST API gebruikt.

Met welke AI-tools werkt de MCP-server?

Met elke client die het Model Context Protocol ondersteunt via Streamable HTTP, waaronder Claude Desktop en Claude Code. Voeg de /mcp-URL en je API-sleutel toe aan de configuratie van de client.