Een MCP-server verbinden in de applicatie
Voor een succesvolle verbinding zijn compatibele eindpunten, transport en authenticatie nodig.
Wat je gaat leren
- Uitleg: host, client en server
- Pas het idee toe in een voorbeeld: een MCP-server verbinden in de applicatie
- Herken beperkingen en verifieer het resultaat van de oefening
Voor een succesvolle verbinding zijn compatibele eindpunten, transport en authenticatie nodig. Selecteer vervolgens hulpmiddelen die nuttig zijn voor de agent.
Deze stappen verwijzen naar de functies die in de applicatiecode zijn geïdentificeerd. Dit materiaal is niet gevalideerd op een live exemplaar; controleer de documentatie en de opties in uw versie.
Hoe het werkt, stap voor stap
Host, client en server
MCP is een protocol dat AI-applicaties verbindt met externe mogelijkheden. De host zorgt voor de ervaring, de client beheert de verbinding en de server stelt tools, bronnen of aanwijzingen beschikbaar op basis van ondersteuning. Tools voeren bewerkingen uit; bronnen bieden adresseerbare inhoud; prompts bieden sjablonen. Niet elke server implementeert ze alle drie. Transport vervoert berichten, authenticatie identificeert bellers en autorisatie controleert de toegang. Controleer de protocolrevisie en ondersteunde extensies aan beide kanten. Compatibiliteit kan niet worden afgeleid uit alleen een “MCP”-label.
Het model doet voorstellen, de tool voert uit
Tool calling produceert een oproepverzoek met een naam en argumenten. De applicatie valideert het schema, de machtigingen en de limieten vóór uitvoering. Het resultaat keert terug naar de context voor de volgende stap. get_product_stock neemt bijvoorbeeld een SKU en retourneert een hoeveelheid; in de beschrijving moet worden uitgelegd dat er geen producten worden gereserveerd. Onderscheid lege resultaten, validatiefouten, ontbrekende toegang en time-outs. Geldige JSON bewijst niet dat de argumenten correct zijn of dat de actie is geautoriseerd. Houd bij externe effecten ook rekening met dubbele uitvoering.
Controleer de toegang vóór gebruik
Machtigingen moeten worden afgedwongen door servers en de gegevenslaag. Laat het model niet beslissen of een gebruiker een document mag zien. Filter bronnen voordat ze in de context terechtkomen, niet nadat het antwoord is gegenereerd. Gebruik inloggegevens voor minimale toegang, houd deze buiten prompts, schermafbeeldingen en browsercode en draai blootgestelde sleutels. Een toelatingslijst voor widgetdomeinen vervangt API-authenticatie niet. Authenticatie identificeert u; autorisatie bepaalt welke handelingen en gegevens u kunt gebruiken. Test ook toegang geweigerd.
Het verklarende schema
Volg de ononderbroken pijlen voor de hoofdstroom. Gestippelde blauwe pijlen leveren gegevens of context; roze pijlen geven feedback of geretourneerde resultaten weer. Kleuren en vormen onderscheiden modellen, winkels, beslissingen en resultaten. Scrol op kleine schermen horizontaal om het hele schema te volgen.
Een compleet voorbeeld
Stel bij MCP-servers de identiteit en URL in, kies AUTO of servertransport en authenticatie. Test, inspecteer gereedschappen en koppel alleen get_product_stock aan de agent.
Probeer het zelf
- Sluit een alleen-lezen testserver aan en verifieer een geldige SKU-aanroep.
- Leg de input, bron en verwachte uitkomst vast voordat u het experiment uitvoert. Gebruik alleen de fictieve gegevens in het voorbeeld.
- Volg de diagramfasen. Registreer bij elke stap welke informatie wordt ontvangen en geproduceerd; verwar de tussentijdse output niet met het uiteindelijke resultaat.
- Herhaal dit nadat de noodzakelijke informatie is verwijderd of de invoer dubbelzinnig is gemaakt. Controleer of het systeem een antwoord verduidelijkt, stopt of verzint.
- Vergelijk met de uitgelegde oplossing. Bewaar de configuratie, datum, resultaat en een verklaring voor verschillen. Verander één ding en test opnieuw.
Een uitgelegde oplossing
De verbinding wordt gecontroleerd, de tool wordt ontdekt en een toegestane oproep slaagt. Met een succesvolle oefening kun je het verband tussen input, fasen en uitkomst laten zien. Als er informatie ontbreekt, is een voorzichtig antwoord nuttiger dan verzonnen details. Vergelijk meer dan stijl: controleer ook voorwaarden, bronnen en bewerkingen.
Wanneer deze aanpak helpt en wat de beperkingen zijn
stdio is een algemeen concept, geen impliciete optie op afstand. Kies deze aanpak wanneer deze een gemeten behoefte verbetert. Houd een eenvoudige basislijn aan en vergelijk de resultaten met behulp van identieke inputs. Eén succesvol voorbeeld garandeert niet in elke situatie betrouwbaarheid.
Controleer wat je hebt geleerd
Biedt een server met tools automatisch bronnen en aanwijzingen?
Nee. Mogelijkheden zijn optioneel en moeten worden ontdekt en gecontroleerd.
Wie voert een door het model voorgestelde oproep uit?
De applicatie of hostservice na validatie. Het model krijgt niet automatisch onbeperkte toegang.
Welk resultaat moet deze oefening opleveren?
De verbinding wordt gecontroleerd, de tool wordt ontdekt en een toegestane oproep slaagt.
Begrippen om te onthouden
- MCP-server: een service die mogelijkheden blootlegt via Model Context Protocol.
- Gereedschap bellen: Een gestructureerd verzoek om een externe mogelijkheid te gebruiken.
- Autorisatie / Autorisatie: het recht op toegang tot een bewerking of bron controleren.
Bronnen en uw volgende stap
Ter voorbereiding: M01 — Wat is een MCP-server?