Hoe u MCP-servers verbindt met Claude Desktop

Externe servers: een custom connector toevoegen

Open Claude Desktop, ga naar Settings, dan Connectors, en klik op Add custom connector. Geef een naam op, plak de server-URL en bevestig. Custom connectors met remote MCP zijn beschikbaar op de Free-, Pro-, Max-, Team- en Enterprise-plannen; een Free-account is beperkt tot één custom connector. Op Team- en Enterprise-plannen voegt een organisatie-eigenaar de connector eerst toe in de organisatie-instellingen, waarna leden hem vanaf hun eigen Connectors-pagina inschakelen.

Servers die OAuth ondersteunen, vragen u de eerste keer om in de browser in te loggen en scopes goed te keuren; verder is niets nodig. Een optionele sectie Advanced settings neemt een OAuth-client-ID en -secret aan voor servers die een vooraf geregistreerde client vereisen, wat de meeste openbare servers niet doen. Voor de server van HostTracker is de URL https://mcp.host-tracker.com/mcp; deze gebruikt OAuth met dynamische clientregistratie, zodat de connector alleen de scopes bevat die u goedkeurt, en er geen sleutel te plakken is.

Connectors draaien vanaf de kant van Anthropic in plaats van vanaf uw eigen machine, dus ze kunnen geen server op uw lokale netwerk bereiken, en het is hetzelfde mechanisme dat claude.ai en Cowork gebruiken. Het configuratiebestand hieronder is de lokale tegenhanger.

Lokale servers: claude_desktop_config.json bewerken

Open Settings, kies het tabblad Developer en klik op Edit Config. Dat opent het configuratiebestand in uw editor, en maakt het aan als het nog niet bestaat. Het bestand staat op ~/Library/Application Support/Claude/claude_desktop_config.json op macOS en op %APPDATA%\Claude\claude_desktop_config.json op Windows; gebruik in de Linux-bèta de knop Edit Config in plaats van een pad te raden. Elke server is een vermelding onder mcpServers met het commando om te starten en de bijbehorende argumenten:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}

Sla het bestand op, sluit Claude Desktop daarna volledig af en start het opnieuw; alleen het venster sluiten is niet genoeg, want de servers worden gestart wanneer de app opstart. Op Windows moet de runtime waar het commando op leunt, zoals Node.js voor npx, geïnstalleerd zijn en op de PATH staan die de desktopapp ziet, dus een server die prima werkt in een terminal maar niet vanuit de app, is meestal een PATH-verschil.

Om te zien of een server is geladen, klikt u op het icoon "Add files, connectors, and more" linksonder in het berichtenvak, gaat u met de muis over Connectors, en opent u Manage connectors; de server staat daar vermeld met zijn tools. Oudere documentatie noemt dit het hamer-icoon, en de pagina voor probleemoplossing gebruikt die naam in één kop nog steeds.

Extensies uit de directory

Settings, dan Extensions, dan Browse extensions toont een samengestelde directory van lokale servers die als extensie zijn verpakt, en die met één klik installeren en zichzelf bijwerken. Een gedownload pakket installeert u via Install Extension door het bestand te kiezen; deze pakketten gebruiken het .mcpb-formaat, dat de eerdere naam .dxt heeft vervangen, en kunnen Node.js-, Python- of binaire servers omvatten. Privé gedistribueerde pakketten werken niet met auto-update en moeten na een wijziging handmatig opnieuw worden geïnstalleerd.

Waar de logs staan als er niets verschijnt

Claude Desktop schrijft een algemeen verbindingslogboek en één logboek per server. Op macOS staan ze onder ~/Library/Logs/Claude/ als mcp.log en mcp-server-NAME.log; op Windows onder %APPDATA%\Claude\logs. Het bestand per server bevat de eigen foutuitvoer van de server, en daarin staat precies wat er mis is: een ontbrekende module, een verkeerd pad of een geweigerde credential. Is het bestand leeg, dan is de app er nooit in geslaagd het commando te starten, wat weer wijst op de PATH of op een JSON-syntaxfout in het configuratiebestand.

Eén app, twee oppervlakken

Claude Desktop bevat nu een tabblad Code dat Claude Code binnen de applicatie uitvoert, naast het tabblad Chat. Servers die in claude_desktop_config.json zijn gedeclareerd, zijn beschikbaar op zowel het chatoppervlak als in lokale sessies van het tabblad Code, naast die uit ~/.claude.json en het .mcp.json van een project; bestaat dezelfde naam op beide plekken, dan neemt het tabblad Code de definitie uit het desktopbestand over. De losse command-line Claude Code leest het desktopbestand niet. Heeft u servers eerst in de desktopapp ingesteld en wilt u ze ook in de terminal, dan importeert claude mcp add-from-claude-desktop ze op macOS en Windows Subsystem for Linux, zoals beschreven in hoe u een MCP-server aan Claude Code toevoegt.

Een externe monitoringserver als eerste connector

Een externe server is de snelste manier om te bevestigen dat de connectorflow werkt, want er valt niets te installeren en het antwoord is controleerbaar. Voeg de server van HostTracker toe als custom connector, log in wanneer daarom wordt gevraagd, en vraag Claude of een site die u kent online staat; het antwoord moet een controle citeren die is uitgevoerd vanaf de controlepunten van HostTracker op met naam genoemde locaties, in plaats van een gok. De MCP-serverpagina vermeldt alle 65 tools en de scope die elk nodig heeft, van directe controles tot updates van statuspagina's.