McpToolServerConfigurationService class
Služba zodpovědná za zjišťování a normalizaci serverů nástrojů MCP (Model Context Protocol) a vytváření konfiguračních objektů využitých sadou Claude SDK.
Konstruktory
| Mcp |
Vytvořte McpToolServerConfigurationService. |
Metody
| get |
Připojte se k serveru MCP a vraťte nástroje s názvy s předponou názvu serveru. Vyvolá chybu, pokud adresa URL serveru chybí nebo se klientovi nepodaří vypsat nástroje. |
| list |
Vrátí definice serveru MCP pro daného agenta. Při vývoji (NODE_ENV=Development) se načte místní ToolingManifest.json; jinak se dotazuje na vzdálenou bránu nástrojů. |
| list |
Vrátí definice serveru MCP pro daného agenta. Při vývoji (NODE_ENV=Development) se načte místní ToolingManifest.json; jinak se dotazuje na vzdálenou bránu nástrojů. |
| list |
Vrátí definice serveru MCP pro daného agenta. Při vývoji (NODE_ENV=Development) se načte místní ToolingManifest.json; jinak se dotazuje na vzdálenou bránu nástrojů. Toto přetížení automaticky přeloží agenticAppId z TurnContext a vygeneruje ověřovací token, pokud není zadán. |
| send |
Odešle historii chatu na platformu MCP pro ochranu před hrozbami v reálném čase. |
| send |
Odešle historii chatu na platformu MCP pro ochranu před hrozbami v reálném čase. |
Podrobnosti konstruktoru
McpToolServerConfigurationService(IConfigurationProvider<ToolingConfiguration>)
Vytvořte McpToolServerConfigurationService.
new McpToolServerConfigurationService(configProvider?: IConfigurationProvider<ToolingConfiguration>)Parametry
- configProvider
Volitelný zprostředkovatel konfigurace Výchozí hodnota je defaultToolingConfigurationProvider, pokud není zadána.
Podrobnosti metody
getMcpClientTools(string, MCPServerConfig)
Připojte se k serveru MCP a vraťte nástroje s názvy s předponou názvu serveru. Vyvolá chybu, pokud adresa URL serveru chybí nebo se klientovi nepodaří vypsat nástroje.
function getMcpClientTools(mcpServerName: string, mcpServerConfig: MCPServerConfig): Promise<McpClientTool[]>Parametry
- mcpServerName
-
string
- mcpServerConfig
- MCPServerConfig
Návraty
Promise<McpClientTool[]>
listToolServers(string, string)
Upozornění
Toto rozhraní API je teď zastaralé.
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
Vrátí definice serveru MCP pro daného agenta. Při vývoji (NODE_ENV=Development) se načte místní ToolingManifest.json; jinak se dotazuje na vzdálenou bránu nástrojů.
function listToolServers(agenticAppId: string, authToken: string): Promise<MCPServerConfig[]>Parametry
- agenticAppId
-
string
ID agentické aplikace, pro které se mají zjišťovat servery.
- authToken
-
string
Nosný token použitý při dotazování na vzdálenou bránu nástrojů
Návraty
Promise<MCPServerConfig[]>
Příslib přeloží na pole normalizovaných objektů konfigurace serveru MCP.
listToolServers(string, string, ToolOptions)
Upozornění
Toto rozhraní API je teď zastaralé.
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
Vrátí definice serveru MCP pro daného agenta. Při vývoji (NODE_ENV=Development) se načte místní ToolingManifest.json; jinak se dotazuje na vzdálenou bránu nástrojů.
function listToolServers(agenticAppId: string, authToken: string, options?: ToolOptions): Promise<MCPServerConfig[]>Parametry
- agenticAppId
-
string
ID agentické aplikace, pro které se mají zjišťovat servery.
- authToken
-
string
Nosný token použitý při dotazování na vzdálenou bránu nástrojů
- options
- ToolOptions
Volitelné možnosti nástroje při volání brány
Návraty
Promise<MCPServerConfig[]>
Příslib přeloží na pole normalizovaných objektů konfigurace serveru MCP.
listToolServers(TurnContext, Authorization, string, string, ToolOptions)
Vrátí definice serveru MCP pro daného agenta. Při vývoji (NODE_ENV=Development) se načte místní ToolingManifest.json; jinak se dotazuje na vzdálenou bránu nástrojů. Toto přetížení automaticky přeloží agenticAppId z TurnContext a vygeneruje ověřovací token, pokud není zadán.
function listToolServers(turnContext: TurnContext, authorization: Authorization, authHandlerName: string, authToken?: string, options?: ToolOptions): Promise<MCPServerConfig[]>Parametry
- turnContext
- TurnContext
TurnContext aktuálního požadavku.
- authorization
- Authorization
Autorizační objekt pro výměnu tokenů.
- authHandlerName
-
string
Název obslužné rutiny ověřování, která se má použít pro výměnu tokenů.
- authToken
-
string
Volitelný nosný token. Pokud není k dispozici, automaticky se vygeneruje prostřednictvím výměny tokenů.
- options
- ToolOptions
Volitelné možnosti nástroje při volání brány
Návraty
Promise<MCPServerConfig[]>
Příslib přeloží na pole normalizovaných objektů konfigurace serveru MCP.
sendChatHistory(TurnContext, ChatHistoryMessage[])
Odešle historii chatu na platformu MCP pro ochranu před hrozbami v reálném čase.
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[]): Promise<OperationResult>Parametry
- turnContext
- TurnContext
Kontext otáčení obsahující informace o konverzaci.
- chatHistoryMessages
Zprávy historie chatu, které se mají odeslat.
Návraty
Promise<OperationResult>
Příslib, který se přeloží na OperationResult označující úspěch nebo selhání.
Poznámky
Výjimky HTTP (chyby sítě, vypršení časového limitu) jsou zachyceny a protokolovány, ale ne rethrown. Místo toho metoda vrátí OperationResult určující, zda operace byla úspěšná nebo neúspěšná. Volající se můžou rozhodnout zkontrolovat výsledek zpracování chyb nebo ho ignorovat, pokud nejsou potřeba podrobnosti o chybě.
sendChatHistory(TurnContext, ChatHistoryMessage[], ToolOptions)
Odešle historii chatu na platformu MCP pro ochranu před hrozbami v reálném čase.
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[], options?: ToolOptions): Promise<OperationResult>Parametry
- turnContext
- TurnContext
Kontext otáčení obsahující informace o konverzaci.
- chatHistoryMessages
Zprávy historie chatu, které se mají odeslat.
- options
- ToolOptions
Volitelné možnosti nástroje pro odesílání historie chatu
Návraty
Promise<OperationResult>
Příslib, který se přeloží na OperationResult označující úspěch nebo selhání.
Poznámky
Výjimky HTTP (chyby sítě, vypršení časového limitu) jsou zachyceny a protokolovány, ale ne rethrown. Místo toho metoda vrátí OperationResult určující, zda operace byla úspěšná nebo neúspěšná. Volající se můžou rozhodnout zkontrolovat výsledek zpracování chyb nebo ho ignorovat, pokud nejsou potřeba podrobnosti o chybě.