Een agenthost heeft mogelijk een verbinding nodig die hij kan configureren. Een applicatieontwikkelaar heeft mogelijk een bibliotheek nodig om in code te importeren. Die vereisten leiden tot verschillende integratie-oppervlakken.
Wat biedt elk aan zijn aanroeper?
Een MCP-server biedt een protocolinterface; een SDK biedt functies en typen voor een programmeertaal.
De architectuurgids van MCP beschrijft servers die mogelijkheden beschikbaar stellen aan verbonden clients. Een server kan als lokaal proces draaien of een remote endpoint bieden.
| Interface | Aanroeper | Wat de aanroeper gebruikt | Runtime-verantwoordelijkheid |
|---|---|---|---|
| MCP-server | Een MCP-client in een agenthost of applicatie | Protocolverzoeken en ontdekte mogelijkheden | Iemand draait het serverproces of de remote service |
| API SDK | Applicatiecode | Bibliotheekmethoden die een API aanroepen | De applicatie draait de bibliotheek en beheert de integratie |
| MCP SDK | Code die een MCP-client of -server implementeert | Protocoltypen en implementatiehelpers | De applicatie draait nog steeds de resulterende client of server |
Een SDK-pakket wordt niet automatisch een draaiende server alleen omdat je het installeert.
Kan een server een SDK gebruiken?
Ja. Een developer kan een protocol-SDK gebruiken om een MCP-server te implementeren, en vervolgens een andere clientbibliotheek gebruiken binnen de handlers.
De MCP SDK-documentatie beschrijft bibliotheken voor het bouwen van clients en servers. Hier duidt SDK op code die wordt gebruikt om het protocol te implementeren.
Een API SDK heeft een ander doel: het roept de API van een service aan. Een hypothetische orderserver zou een orderstatus-tool kunnen beschikbaar stellen waarvan de handler een API SDK gebruikt om de order op te halen.
De buitenste MCP-interface en de binnenste API-aanroep hebben afzonderlijke contracten. Het ondersteunen van een API-operatie maakt deze niet automatisch beschikbaar als een MCP-tool.
Welke verantwoordelijkheden blijven in mijn applicatie?
Je applicatie beslist nog steeds welke operaties worden aangevraagd. Het beslist ook hoe de resultaten worden verwerkt.
Met een API SDK selecteert je code een methode en levert de argumenten. Met MCP routeert de host verzoeken via een client naar de beschikbaar gestelde mogelijkheden van de server.
De MCP-architectuur plaatst het gebruik van modelcontext door de host buiten het bereik van het protocol. Een toolverbinding bepaalt niet je bedrijfsregels, autorisatiebeleid of voltooiingscriteria.
Bij het opzoeken van een order kan het ontvangen van de gevraagde status de taak afronden. Bij het verzenden van een bericht zijn verzending en latere bezorging afzonderlijke uitkomsten.
Hoe kies ik een Bird-integratie?
Je kunt een compatibele agenthost verbinden met de MCP-server van Bird, of applicatiecode integreren via een API-client.
Voor de bibliotheekroute behandelt de Bird SDK-keuze de afweging tussen een SDK en directe HTTP. Voor de toolroute levert de Bird-inventaris van je client de beschikbare toolnamen en invoerschema's.
Vergelijk de operatie die je nodig hebt op de interface die je wilt gebruiken. De aanwezigheid van een operatie in de ene interface garandeert niet dat deze in een andere aanwezig is.
- Gebruik de MCP-verbinding wanneer je host Bird-tools moet ontdekken en aanroepen.
- Gebruik een API-client wanneer je applicatiecode de service-operaties selecteert en aanroept.
- Gebruik een MCP SDK wanneer je de protocolclient of -server zelf implementeert.