McpToolServerConfigurationService class
Usługa odpowiedzialna za odnajdywanie i normalizację serwerów narzędzi MCP (Model Context Protocol) i tworzenie obiektów konfiguracji używanych przez zestaw Claude SDK.
Konstruktory
| Mcp |
Konstruowanie obiektu McpToolServerConfigurationService. |
Metody
| get |
Połącz się z serwerem MCP i zwróć narzędzia z nazwami poprzedzonymi nazwą serwera. Zgłasza błąd, jeśli brakuje adresu URL serwera lub klient nie może wyświetlić listy narzędzi. |
| list |
Zwróć definicje serwera MCP dla danego agenta. Podczas programowania (NODE_ENV=Programowanie) odczytuje ToolingManifest.jsonlokalne; w przeciwnym razie wysyła zapytanie do zdalnej bramy narzędzi. |
| list |
Zwróć definicje serwera MCP dla danego agenta. Podczas programowania (NODE_ENV=Programowanie) odczytuje ToolingManifest.jsonlokalne; w przeciwnym razie wysyła zapytanie do zdalnej bramy narzędzi. |
| list |
Zwróć definicje serwera MCP dla danego agenta. Podczas programowania (NODE_ENV=Programowanie) odczytuje ToolingManifest.jsonlokalne; w przeciwnym razie wysyła zapytanie do zdalnej bramy narzędzi. To przeciążenie automatycznie rozpoznaje identyfikator agenticAppId z elementu TurnContext i generuje token uwierzytelniania, jeśli nie zostanie podany. |
| send |
Wysyła historię czatów do platformy MCP w celu ochrony przed zagrożeniami w czasie rzeczywistym. |
| send |
Wysyła historię czatów do platformy MCP w celu ochrony przed zagrożeniami w czasie rzeczywistym. |
Szczegóły konstruktora
McpToolServerConfigurationService(IConfigurationProvider<ToolingConfiguration>)
Konstruowanie obiektu McpToolServerConfigurationService.
new McpToolServerConfigurationService(configProvider?: IConfigurationProvider<ToolingConfiguration>)Parametry
- configProvider
Opcjonalny dostawca konfiguracji. Wartość domyślnaToolingConfigurationProvider, jeśli nie zostanie określona.
Szczegóły metody
getMcpClientTools(string, MCPServerConfig)
Połącz się z serwerem MCP i zwróć narzędzia z nazwami poprzedzonymi nazwą serwera. Zgłasza błąd, jeśli brakuje adresu URL serwera lub klient nie może wyświetlić listy narzędzi.
function getMcpClientTools(mcpServerName: string, mcpServerConfig: MCPServerConfig): Promise<McpClientTool[]>Parametry
- mcpServerName
-
string
- mcpServerConfig
- MCPServerConfig
Zwraca
Promise<McpClientTool[]>
listToolServers(string, string)
Ostrzeżenie
Ten interfejs API jest już przestarzały.
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
Zwróć definicje serwera MCP dla danego agenta. Podczas programowania (NODE_ENV=Programowanie) odczytuje ToolingManifest.jsonlokalne; w przeciwnym razie wysyła zapytanie do zdalnej bramy narzędzi.
function listToolServers(agenticAppId: string, authToken: string): Promise<MCPServerConfig[]>Parametry
- agenticAppId
-
string
Identyfikator aplikacji agenta, dla której można odnajdywać serwery.
- authToken
-
string
Token elementu nośnego używany podczas wykonywania zapytań względem zdalnej bramy narzędzi.
Zwraca
Promise<MCPServerConfig[]>
Obietnica rozpoznawania tablicy znormalizowanych obiektów konfiguracji serwera MCP.
listToolServers(string, string, ToolOptions)
Ostrzeżenie
Ten interfejs API jest już przestarzały.
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
Zwróć definicje serwera MCP dla danego agenta. Podczas programowania (NODE_ENV=Programowanie) odczytuje ToolingManifest.jsonlokalne; w przeciwnym razie wysyła zapytanie do zdalnej bramy narzędzi.
function listToolServers(agenticAppId: string, authToken: string, options?: ToolOptions): Promise<MCPServerConfig[]>Parametry
- agenticAppId
-
string
Identyfikator aplikacji agenta, dla której można odnajdywać serwery.
- authToken
-
string
Token elementu nośnego używany podczas wykonywania zapytań względem zdalnej bramy narzędzi.
- options
- ToolOptions
Opcjonalne opcje narzędzi podczas wywoływania bramy.
Zwraca
Promise<MCPServerConfig[]>
Obietnica rozpoznawania tablicy znormalizowanych obiektów konfiguracji serwera MCP.
listToolServers(TurnContext, Authorization, string, string, ToolOptions)
Zwróć definicje serwera MCP dla danego agenta. Podczas programowania (NODE_ENV=Programowanie) odczytuje ToolingManifest.jsonlokalne; w przeciwnym razie wysyła zapytanie do zdalnej bramy narzędzi. To przeciążenie automatycznie rozpoznaje identyfikator agenticAppId z elementu TurnContext i generuje token uwierzytelniania, jeśli nie zostanie podany.
function listToolServers(turnContext: TurnContext, authorization: Authorization, authHandlerName: string, authToken?: string, options?: ToolOptions): Promise<MCPServerConfig[]>Parametry
- turnContext
- TurnContext
Element TurnContext bieżącego żądania.
- authorization
- Authorization
Obiekt autoryzacji dla wymiany tokenów.
- authHandlerName
-
string
Nazwa programu obsługi uwierzytelniania do użycia na potrzeby wymiany tokenów.
- authToken
-
string
Opcjonalny token elementu nośnego. Jeśli nie zostanie podana, zostanie wygenerowana automatycznie za pośrednictwem wymiany tokenów.
- options
- ToolOptions
Opcjonalne opcje narzędzi podczas wywoływania bramy.
Zwraca
Promise<MCPServerConfig[]>
Obietnica rozpoznawania tablicy znormalizowanych obiektów konfiguracji serwera MCP.
sendChatHistory(TurnContext, ChatHistoryMessage[])
Wysyła historię czatów do platformy MCP w celu ochrony przed zagrożeniami w czasie rzeczywistym.
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[]): Promise<OperationResult>Parametry
- turnContext
- TurnContext
Kontekst kolei zawierający informacje o konwersacji.
- chatHistoryMessages
Wiadomości historii czatów do wysłania.
Zwraca
Promise<OperationResult>
Obietnica, która rozwiązuje element OperationResult wskazujący powodzenie lub niepowodzenie.
Uwagi
Wyjątki HTTP (błędy sieci, przekroczenia limitu czasu) są przechwytywane i rejestrowane, ale nie są ponownie przywracane. Zamiast tego metoda zwraca wartość OperationResult wskazującą, czy operacja zakończyła się powodzeniem, czy niepowodzeniem. Osoby wywołujące mogą sprawdzić wynik obsługi błędów lub zignorować go, jeśli szczegóły błędu nie są potrzebne.
sendChatHistory(TurnContext, ChatHistoryMessage[], ToolOptions)
Wysyła historię czatów do platformy MCP w celu ochrony przed zagrożeniami w czasie rzeczywistym.
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[], options?: ToolOptions): Promise<OperationResult>Parametry
- turnContext
- TurnContext
Kontekst kolei zawierający informacje o konwersacji.
- chatHistoryMessages
Wiadomości historii czatów do wysłania.
- options
- ToolOptions
Opcjonalne opcje narzędzi do wysyłania historii czatów.
Zwraca
Promise<OperationResult>
Obietnica, która rozwiązuje element OperationResult wskazujący powodzenie lub niepowodzenie.
Uwagi
Wyjątki HTTP (błędy sieci, przekroczenia limitu czasu) są przechwytywane i rejestrowane, ale nie są ponownie przywracane. Zamiast tego metoda zwraca wartość OperationResult wskazującą, czy operacja zakończyła się powodzeniem, czy niepowodzeniem. Osoby wywołujące mogą sprawdzić wynik obsługi błędów lub zignorować go, jeśli szczegóły błędu nie są potrzebne.