TsgcWSAPIClient_MCP is de clientkant van het Model Context Protocol. Het verbindt met elke MCP-server, via HTTP, HTTP Streamable of een lokaal stdio-subproces, toont de tools, prompts en resources die die aanbiedt en roept ze vanuit je code aan.
Een JSON-RPC-MCP-client met drie transporten. Het voert de initialize-handshake uit, bewaakt de sessie, stuurt verzoeken en beantwoordt de door de server geïnitieerde verzoeken die jouw toepassing wil ondersteunen.
TsgcWSAPIClient_MCP
MCP-servers gebruiken
Windows, macOS, Linux, iOS en Android
sgcAI is zelfstandig. Dit component zit in sgcAI, samen met de sgcWebSockets Core runtime waarop het gebouwd is.
Stel het transport en de opties in, initialiseer en toon en roep vervolgens tools, prompts en resources aan.
uses
sgcAI, sgcAI_MCP_Classes, sgcAI_MCP_Types;
var
oMCP: TsgcWSAPIClient_MCP;
begin
oMCP := TsgcWSAPIClient_MCP.Create(nil);
// Remote server over streamable HTTP.
oMCP.MCPOptions.Transport := aimcptrHttpStreamable;
oMCP.MCPOptions.HttpOptions.URL := 'https://mcp.example.com/mcp';
oMCP.MCPOptions.ClientInfo.Name := 'sgc-mcp-client';
oMCP.MCPOptions.ClientInfo.Version := '1.0.0';
oMCP.MCPOptions.AuthenticationOptions.ApiKey.Enabled := True;
oMCP.MCPOptions.AuthenticationOptions.ApiKey.Value := 'mcp-...';
oMCP.OnMCPListTools := MCPListTools;
oMCP.OnMCPResponseTool := MCPToolResponse;
oMCP.Initialize;
oMCP.ListTools;
oMCP.RequestTool('GetTemperature', vArguments); // vArguments: IsgcJSON
end;
// Or spawn a local MCP server as a subprocess instead:
oMCP.MCPOptions.Transport := aimcptrStdio;
oMCP.MCPOptions.StdioOptions.Command := 'C:\tools\my-mcp-server.exe';
oMCP.MCPOptions.StdioOptions.Arguments := '--stdio';// includes: sgcAI.hpp, sgcAI_MCP_Classes.hpp, sgcAI_MCP_Types.hpp
TsgcWSAPIClient_MCP *oMCP = new TsgcWSAPIClient_MCP(NULL);
oMCP->MCPOptions->Transport = aimcptrHttpStreamable;
oMCP->MCPOptions->HttpOptions->URL = "https://mcp.example.com/mcp";
oMCP->MCPOptions->ClientInfo->Name = "sgc-mcp-client";
oMCP->OnMCPListTools = MCPListTools;
oMCP->OnMCPResponseTool = MCPToolResponse;
oMCP->Initialize();
oMCP->ListTools();De leden die je het vaakst gebruikt.
MCPOptions.Transport kiest aimcptrHttp voor gewone JSON-RPC over POST, aimcptrHttpStreamable voor keep-alive plus een SSE-meldingsstroom, of aimcptrStdio om een lokale server als subproces te starten.
HttpOptions bevat de URL, de TLS-opties en de logging. StdioOptions bevat Command, Arguments, WorkingDir, Environment en Timeout voor het subproces.
AuthenticationOptions ondersteunt een API-sleutel, een eigen header of een volledige OAuth 2.0-flow inclusief identity assertion, wat publieke MCP-servers steeds vaker vereisen.
Initialize voert de handshake uit en Ping controleert of de verbinding leeft. HeartBeat stuurt periodieke pings zodat een inactieve sessie niet wordt verbroken, en Session toont de onderhandelde sessiestatus.
ListTools en RequestTool, ListPrompts en RequestPrompt, ListResources, ListResourceTemplates en RequestResource. De lijstmethoden accepteren een cursorargument voor paginering.
SubscribeResource en UnsubscribeResource volgen een resource op wijzigingen, SetLoggingLevel stelt de uitgebreidheid aan serverzijde bij en Complete vraagt om aanvullingen van argumenten.
OnMCPListRoots, OnMCPSamplingCreateMessage en OnMCPElicitationCreate gaan af wanneer de server de client om bestandssysteemroots, een modelcompletion of gebruikersinvoer vraagt, zodat jouw toepassing het antwoord levert. Een legacy-server (2025-11-25 of ouder) die deze verzoeken rechtstreeks stuurt, buiten Multi Round-Trip Requests om, krijgt zijn antwoord automatisch teruggestuurd zodra de handler terugkeert.
OnMCPInitialize, OnMCPPing, OnMCPListTools, OnMCPResponseTool, OnMCPListPrompts, OnMCPResponsePrompt, OnMCPListResources, OnMCPResponseResource en OnMCPStreamMessage.
MCPOptions.ProtocolEra kiest Auto, Modern of Legacy. In Auto roept de client server/discover aan en valt terug op de 2025-11-25-initialize-handshake wanneer de server ouder is. Discover, NegotiatedEra en OnMCPDiscover tonen het resultaat.
Wanneer een server elicitation, sampling of roots nodig heeft om een aanroep af te ronden, gaat OnMCPInputRequired af met de verzoeken. Vul de antwoorden in en de client herhaalt de aanroep met de ondertekende requestState, tot MCPOptions.MRTR.MaxRounds.
SubscriptionsListen opent een stream voor lijstwijzigingen en resource-updates, afgeleverd via OnMCPListChanged en OnMCPResourcesUpdated. SubscriptionsCancel sluit hem.
MCPOptions.Tasks.Enabled schakelt de extensie in; AutoPoll polt een lopende taak automatisch. TasksGet, TasksUpdate en TasksCancel zijn de handmatige methoden, en OnMCPTaskCreated, OnMCPTaskStatus en OnMCPTaskCompleted melden de voortgang.
MCPOptions.Authorization ontdekt protected resource metadata, registreert via Client ID Metadata Documents of dynamische registratie met application_type, gebruikt PKCE en resource-indicatoren, valideert iss (RFC 9207) en houdt credentials per issuer bij.
MCPOptions.ToolPinning bewaart een SHA-256-vingerafdruk van naam, beschrijving, invoerschema en annotaties van elke getoonde tool, in het geheugen of in FileName. Wijzigt de server een vastgepinde tool, dan wordt de tool uit de lijst gehaald en weigeren RequestTool en CallTool hem totdat je de wijziging accepteert in OnMCPToolChanged of PinTool aanroept. Dit beschermt een agent tegen tool poisoning, een toolbeschrijving die is herschreven om het model te sturen. GetToolsList en CallTool zijn de synchrone versies van ListTools en RequestTool. Nieuw in 2026.11.0.
Gezaghebbende bronnen voor de diensten en protocollen die dit component gebruikt.
| Online helpVolledige API-referentie en gebruiksgids voor de sgcAI-componenten. | Openen | |
| Alle sgcAI-componentenBekijk de volledige functiematrix van alle 15 componenten. | Openen | |
| Download de gratis proefversieVerbind vanuit je eigen code met een publieke of lokale MCP-server. | Openen | |
| PrijzenSingle-, Team- en Site-licenties, volledige broncode. | Openen |