Bouwen met CometAPIHeb je één API voor meerdere modellen nodig?Test de workflow in Playground en maak daarna een API-sleutel aan wanneer het model en de kosten passen bij je use case.
Hoe je een MCP-server bouwt in Claude Desktop - een praktische gids
MCP wordt al ondersteund in clients zoals Claude voor Desktop en tools van derden. Het protocol is geëvolueerd (de specificatie en servervoorbeelden zijn bijgewerkt tot en met 2025) en leveranciers en engineers publiceren patronen voor veiligere, tokenefficiënte integraties. Dit artikel begeleidt u bij het bouwen van een MCP-server, het verbinden ervan met Claude Desktop en praktische/beveiligings-/geheugentips die u nodig hebt in productie.
Sinds de publieke introductie van de Anthropic Modelcontextprotocol (MCP) on November 25, 2024MCP is snel geëvolueerd van concept naar een praktisch ecosysteem: een open specificatie en meerdere referentieservers zijn beschikbaar, community-implementaties (geheugenservers, toegang tot bestandssystemen, webfetchers) staan op GitHub en NPM, en MCP wordt al ondersteund in clients zoals Claude voor desktop en tools van derden. Het protocol is geëvolueerd (de specificatie en servervoorbeelden zijn bijgewerkt tot en met 2025) en leveranciers en technici publiceren patronen voor veiligere, tokenefficiënte integraties.
Dit artikel begeleidt u bij het bouwen van een MCP-server en het verbinden ervan met Claude Bureaubladen praktische / beveiligings- / geheugentips die u nodig zult hebben in de productie.
Gecontroleerd op duidelijkheid, bronvermelding en actuele API-terminologie.
Wat is het Model Context Protocol (MCP)?
Een duidelijke definitie
Het Model Context Protocol (MCP) is een open, gestandaardiseerd protocol waardoor het voor LLM-hosts (de apps die het model draaien, bijvoorbeeld Claude Desktop) eenvoudig is om externe services aan te roepen die resources (bestanden, DB-rijen), tools (functies die het model kan aanroepen), en prompts (sjablonen die het model kan gebruiken). In plaats van N×M-integraties te implementeren (elk model naar elke tool), biedt MCP een consistent client-serverschema en een runtimecontract, zodat elke MCP-bewuste modelhost elke MCP-compatibele server kan gebruiken. Zo kunnen ontwikkelaars services één keer bouwen en deze vervolgens door elk MCP-bewust model of elke MCP-gebruikersinterface (bijvoorbeeld Claude Desktop) laten gebruiken.
Waarom MCP nu belangrijk is
Sinds Anthropic eind 2024 MCP open source maakte, is het protocol snel uitgegroeid tot een de facto interoperabiliteitslaag voor toolintegraties (Claude, VS Code-extensies en andere agentomgevingen). MCP vermindert dubbel werk, versnelt de ontwikkeling van connectoren (Google Drive, GitHub, Slack, enz.) en maakt het eenvoudiger om persistente geheugenopslag aan een assistent te koppelen.
Wat is de MCP-architectuur en hoe werkt het?
Op een hoog niveau definieert MCP drie rolgroepen en verschillende interactiepatronen.
Kerncomponenten: clients, servers en het register
MCP-client (host): De LLM-host of -applicatie die contextuele gegevens wil: Claude Desktop, een VS Code-agent of een webapp. De client detecteert en maakt verbinding met een of meer MCP-servers.
MCP-server (resourceprovider): Een netwerkservice die bronnen (bestanden, geheugens, databases, acties) beschikbaar stelt via het MCP-schema. Servers declareren hun mogelijkheden en bieden eindpunten die de client kan aanroepen.
Register / Ontdekking: Optionele componenten of configuratiebestanden die de client helpen beschikbare MCP-servers te ontdekken, mogelijkheden te vermelden en machtigingen of installaties te beheren (bureaubladextensies vormen hiervoor één UX-laag).
Berichtenstromen en capaciteitsonderhandeling
MCP-interacties volgen doorgaans dit patroon:
Ontdekking / registratie: De client krijgt informatie over beschikbare servers (lokaal, netwerk of samengestelde registers).
Aankondiging van de capaciteit: De server deelt een manifest waarin bronnen, methoden en autorisatievereisten worden beschreven.
Verzoek / reactie: De client verstuurt gestructureerde verzoeken (bijvoorbeeld 'lees bestand X', 'zoek geheugens voor Y' of 'maak PR met deze bestanden') en de server reageert met getypte contextuele gegevens.
Actie resultaten & streaming: Servers kunnen resultaten streamen of langdurige operationele eindpunten leveren. De specificatie definieert schema's voor getypte resourcebeschrijvingen en -reacties.
Beveiligingsmodel en vertrouwensgrenzen
MCP standaardiseert opzettelijk controleoppervlakken, zodat LLM's gebruikersgegevens kunnen verwerken en acties kunnen uitvoeren. Deze bevoegdheid vereist zorgvuldige beveiligingsmaatregelen:
Expliciete toestemming van de gebruiker / prompts worden aanbevolen wanneer servers toegang hebben tot privégegevens of bevoorrechte acties kunnen uitvoeren (bijvoorbeeld schrijven naar opslagplaatsen).
Het minste privilege manifesteert zich: Servers moeten minimale scopes declareren en clients mogen alleen de vereiste capaciteiten opvragen.
Transport en autorisatie: Gebruik TLS, tokenized credentials en lokale eindpunten voor gevoelige integraties. De community en platformleveranciers (bijvoorbeeld Microsoft in Windows) experimenteren met registers en UI-mogelijkheden om risico's te beperken.
Waarom Claude integreren met MCP-servers?
Door Claude te integreren met MCP-servers worden drie praktische typen mogelijkheden ontsloten:
Realtime, bruikbare context
In plaats van verouderde snapshots te kopiëren en in prompts te embedden, kan Claude tijdens de query actuele context (bestanden, conversatiegeschiedenis, databaserijen) opvragen. Dit betekent minder benaderende opvragingen en actuelere resultaten. De demo's van Anthropic laten zien hoe Claude dingen doet zoals het aanmaken van GitHub PR's of het lezen van lokale bestanden via MCP.
Kleine, samenstelbare gereedschappen in plaats van één gigantische adapter
U kunt gerichte MCP-servers schrijven – één voor de agenda, één voor het bestandssysteem, één voor een vectorgeheugenopslag – en deze hergebruiken voor verschillende Claude-instanties of clients (desktop, IDE, web). Deze modulariteit schaalt beter dan maatwerkintegraties.
Blijvend en gestandaardiseerd geheugen
MCP maakt geheugenservices mogelijk: permanente opslag die conversatiegeschiedenis, persoonlijke voorkeuren en gestructureerde gebruikersstatus codeert. Omdat MCP het resourcemodel standaardiseert, kunnen meerdere clients dezelfde geheugenserver hergebruiken en een consistente gebruikerscontext in apps behouden. Er bestaan al verschillende community-geheugenservices en uitbreidingspatronen.
Betere UX en lokale controle (Claude Desktop)
Op desktopclients biedt MCP lokale servers directe toegang tot het bestandssysteem van een gebruiker (met toestemming), waardoor privacygevoelige integraties mogelijk zijn zonder cloud-API's. De Desktop Extensions van Anthropic zijn een voorbeeld van hoe de installatie en detectie van MCP-servers op lokale machines wordt vereenvoudigd.
Een MCP-server aanmaken
Wat je nodig hebt voordat je begint
Claude Bureaublad: Installeer de nieuwste Claude Desktop-release voor uw besturingssysteem en zorg ervoor dat MCP/extensie-ondersteuning is ingeschakeld in de instellingen. Voor sommige functies is mogelijk een betaald abonnement vereist (Claude Pro of gelijkwaardig).
Ontwikkelaarsmachine: Node.js (>=16/18 aanbevolen), of Python 3.10+, plus ngrok of een lokale tunneloplossing als u een lokale server voor tests aan het internet wilt blootstellen. Gebruik TLS in productie.
Het MCP-project biedt SDK's en sjablonen aan in de hoofddocumentatie en de GitHub-repository. Installeer de Python- of Node-SDK via de officiële instructies in de docs/repo.
Optie A — Installeer een bestaande (voorbeeld) MCP-server
Anthropic biedt voorbeeldservers, inclusief geheugen, bestandssysteem en hulpmiddelen.
Kloon de referentieservers:
git clone https://github.com/modelcontextprotocol/servers.git
cd servers
Binnenin vindt u mappen zoals:
filesystem/
fetch/
memory/
weather/
Een voorbeeldserver installeren:
cd memory
npm install
npm run dev
Hiermee start u de MCP-server, meestal op:
http://localhost:3000
Controleer of het manifest-eindpunt werkt en of het aanroepen van een tool een correct getypte JSON retourneert.
Optie B — Maak uw eigen MCP-server (aanbevolen om te leren)
Dit is een volledige MCP-server het blootstellen van een enkel hulpmiddel: hello_world.
Hoe verbind ik Claude Desktop met een MCP-server?
Hieronder vindt u een praktische handleiding voor het aanmaken van een eenvoudige MCP-server en het registreren ervan bij Claude Desktop. Deze sectie is praktisch: het behandelt de omgevingsinstelling, het aanmaken van het servermanifest, het beschikbaar maken van de eindpunten die de client verwacht en het configureren van Claude Desktop voor gebruik met de server.
1) Open het Claude Desktop-ontwikkelaarsverbindingsgebied
In Claude Desktop: Instellingen → Ontwikkelaar (of Instellingen → Connectoren (afhankelijk van de clientbuild). Er is een optie om een externe/lokale MCP-server toe te voegen of 'Connector toevoegen'. De exacte gebruikersinterface kan per release verschillen. Als u deze niet ziet, controleer dan het menu 'Ontwikkelaar' op het bureaublad of de meest recente release-opmerkingen.
2) Als u een lokale server configureert: Maak of zoek het configuratiebestand
Na het starten van de Claude-desktopapplicatie worden alle gevonden MCP-servers automatisch geconfigureerd in een bestand met de naam ClaudeDesktopConfig.json. De eerste stap is om dit bestand te zoeken en te openen, of het aan te maken als het nog niet bestaat:
Voor Windows-gebruikers bevindt het bestand zich onder “%APPDATA%\Claude\claude_desktop_config.json”.
Voor Mac-gebruikers bevindt het bestand zich onder “~/Library/Application Support/Claude/claude_desktop_config.json”.
3) Voeg de server toe aan Claude Desktop
Er zijn twee UX-patronen waarmee u Claude Desktop op de hoogte kunt stellen van uw MCP-server:
Bureaubladextensies / Installatieprogramma's met één klik: Anthropic heeft "Desktop Extensions" gedocumenteerd, die manifesten en installatieprogramma's bundelen, zodat gebruikers servers kunnen toevoegen met één klik (aanbevolen voor een bredere distributie). U kunt uw manifest en servermetadata bundelen voor eenvoudige installatie.
Lokale serverregistratie (ontwikkelaarsmodus): Voor lokale tests:
Plaats het manifest op een bekend lokaal pad of serveer het op https://localhost:PORT/.well-known/mcp-manifest.json.
Open in de instellingen van Claude Desktop het paneel MCP/Extensies en kies 'Lokale server toevoegen' of 'Server toevoegen via URL' en plak de manifest-URL of het token.
Verleen de vereiste machtigingen wanneer de client daarom vraagt. Claude inventariseert de serverbronnen en presenteert deze als beschikbare tools/geheugens.
Nu kiezen we ervoor om de lokale MCP te installeren:Voeg een toe mcpServers sectie Hierin staat de naam van uw server en een absoluut pad/opdracht om deze te starten. Sla Claude Desktop op en start het opnieuw.
Na het herstarten toont de gebruikersinterface van Claude de MCP-tools (pictogram Zoeken en Tools) en kunt u de blootgestelde bewerkingen testen (bijvoorbeeld: "Wat is het weer in Sacramento?"). Als de host uw server niet detecteert, raadpleeg dan de mcp.log bestanden mcp-server-<name>.log voor STDERR-uitvoer.
4) Test de integratie
Typ in de Claude-chat:
Call the hello_world tool with name="Alice"
Claude roept uw MCP-server aan en reageert via de uitvoer van de tool.
Hoe implementeer ik een geheugenservice via MCP (geavanceerde tips)?
Geheugenservices behoren tot de krachtigste MCP-servers omdat ze gebruikerscontext persistent maken en zichtbaar maken tijdens sessies. De volgende best practices en implementatietips weerspiegelen de specificaties, Claude-documentatie en communitypatronen.
Geheugendatamodel en -ontwerp
Gestructureerd versus ongestructureerd: Sla zowel gestructureerde feiten (bijv. naam, voorkeursvlaggen) als ongestructureerde conversatiefragmenten op. Gebruik getypte metadata voor snelle filtering.
Chunking en inbedding: Splits lange documenten of conversaties op in semantisch samenhangende stukken en sla vector-embeddings op ter ondersteuning van het zoeken naar overeenkomsten. Dit verbetert de herinnering en vermindert het gebruik van tokens tijdens het ophalen.
Signalen voor recentie en opvallendheid: Registreer tijdstempels en opvallendheidsscores; sta zoekopdrachten toe die de voorkeur geven aan recente of zeer opvallende herinneringen.
Privacytags: Markeer items met gevoeligheidslabels (privé, gedeeld, kortstondig) zodat de cliënt om toestemming kan vragen.
API-patronen voor geheugenbewerkingen
Voer minimaal drie bewerkingen uit:
write: Accepteert een geheugenitem met metagegevens, retourneert een bevestiging en een opslag-ID.
query: Accepteert een zoekopdracht in natuurlijke taal of een gestructureerd filter en retourneert de beste k overeenkomende geheugens (optioneel met uitlegmetagegevens).
delete/update: Ondersteunt levenscyclusbewerkingen en expliciete verzoeken van gebruikers om te vergeten.
Ontwerpreacties omvatten onder meer de herkomst (waar de herinnering vandaan komt) en een betrouwbaarheids-/overeenkomstscore, zodat de cliënt en het model kunnen beslissen hoe agressief ze de herinnering willen gebruiken.
Strategieën voor het vergroten van de retrieval voor Claude
Korte contextvensters: Geef bondige geheugenfragmenten terug in plaats van volledige documenten. Laat Claude indien nodig de volledige context opvragen.
Samenvattingslaag: Sla optioneel een korte samenvatting van elk geheugen op om het aantal tokens te verminderen. Gebruik incrementele samenvattingen bij schrijfbewerkingen.
Gecontroleerde injectie: Bied geheugen aan als een koppelbare 'contextbundel' die de client selectief in prompts kan injecteren in plaats van het model met alles te overspoelen.
Veiligheid en governance voor geheugen-MCP's
Toestemming en audit trail: Registreer wanneer een geheugen is aangemaakt en of de gebruiker toestemming heeft gegeven om het met het model te delen. Presenteer duidelijke UI-mogelijkheden in Claude Desktop voor het bekijken en intrekken van geheugens.
Snelheidsbeperking en validatie: Bescherm uzelf tegen prompt-injectie of exfiltratie door typen te valideren en onverwachte code-uitvoeringsverzoeken van servers niet toe te staan.
Versleuteling in rust en tijdens verzending: Gebruik sterke encryptie voor opgeslagen items en TLS voor alle MCP-eindpunten. Gebruik voor cloudgebaseerde opslag envelopencryptie of door de klant beheerde sleutels indien beschikbaar.
Conclusie: Hoe je een MCP-server bouwt in Claude Desktop
Het artikel is een compact, pragmatisch recept om van nul naar een werkende Claude + geheugenserver op je laptop te gaan:
Test een workflow: Vraag Claude om een kort feit te "onthouden" en te verifiëren of de server het heeft opgeslagen; vraag Claude vervolgens om dat feit in een latere prompt te herinneren. Observeer de logs en pas de rangschikking van de gegevens aan.
Installatievereisten: Node.js >= 18, Git, Claude Desktop (nieuwste).
Een referentieserver klonen: vork de modelcontextprotocol/servers voorbeelden of een community-geheugenserver op GitHub.
Installeren en uitvoeren:npm install → npm run dev (of volg de README-informatie in de repository). Bevestig het manifest-eindpunt (bijv. http://localhost:3000/manifest) retourneert JSON. ()
Connector registreren in Claude Desktop: Instellingen → Ontwikkelaar / Connectoren → Connector toevoegen → wijs naar http://localhost:3000 en scopes goedkeuren.
Door Claude (of een andere host) te integreren met MCP-servers kunt u eenmalig een connector bouwen en deze beschikbaar stellen voor alle MCP-clients (Claude Desktop, IDE's of andere agentframeworks). Hierdoor wordt het onderhoud aanzienlijk verminderd en wordt de functionaliteit van alle tools sneller beschikbaar.
Ontwikkelaars hebben toegang tot de nieuwste API van Claude AI (op de publicatiedatum van dit artikel), zoals Claude Sonnet 4.5 API en Claude Opus 4.1 API via CometAPI, de nieuwste modelversie wordt altijd bijgewerkt met de officiële website. Om te beginnen, verken de mogelijkheden van het model in de Speeltuin en raadpleeg de API-gids voor gedetailleerde instructies. Zorg ervoor dat u bent ingelogd op CometAPI en de API-sleutel hebt verkregen voordat u toegang krijgt. KomeetAPI bieden een prijs die veel lager is dan de officiële prijs om u te helpen integreren.
