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?
- Maak een gratis account aan en haal je persoonlijke API-sleutel op via Mijn Account.
- 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.
- 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/mcpClaude 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.
{
"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.
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonDat 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.
~/.config/Claude/claude_desktop_config.jsonClaude 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.