McpToolServerConfigurationService class
MCP (モデル コンテキスト プロトコル) ツール サーバーの検出と正規化、および Claude SDK で使用できる構成オブジェクトの生成を担当するサービス。
コンストラクター
| Mcp |
McpToolServerConfigurationService を構築します。 |
メソッド
| get |
MCP サーバーに接続し、サーバー名の前に名前が付いたツールを返します。 サーバー URL が見つからないか、クライアントがツールの一覧を表示できない場合にスローします。 |
| list |
指定されたエージェントの MCP サーバー定義を返します。 開発中 (NODE_ENV=開発) では、ローカル ToolingManifest.jsonが読み取ります。それ以外の場合は、リモート ツール ゲートウェイに対してクエリを実行します。 |
| list |
指定されたエージェントの MCP サーバー定義を返します。 開発中 (NODE_ENV=開発) では、ローカル ToolingManifest.jsonが読み取ります。それ以外の場合は、リモート ツール ゲートウェイに対してクエリを実行します。 |
| list |
指定されたエージェントの MCP サーバー定義を返します。 開発中 (NODE_ENV=開発) では、ローカル ToolingManifest.jsonが読み取ります。それ以外の場合は、リモート ツール ゲートウェイに対してクエリを実行します。 このオーバーロードは、TurnContext から agenticAppId を自動的に解決し、指定されていない場合は認証トークンを生成します。 |
| send |
リアルタイムの脅威保護のために、チャット履歴を MCP プラットフォームに送信します。 |
| send |
リアルタイムの脅威保護のために、チャット履歴を MCP プラットフォームに送信します。 |
コンストラクターの詳細
McpToolServerConfigurationService(IConfigurationProvider<ToolingConfiguration>)
McpToolServerConfigurationService を構築します。
new McpToolServerConfigurationService(configProvider?: IConfigurationProvider<ToolingConfiguration>)パラメーター
- configProvider
オプションの構成プロバイダー。 指定しない場合、既定値は defaultToolingConfigurationProvider になります。
メソッドの詳細
getMcpClientTools(string, MCPServerConfig)
MCP サーバーに接続し、サーバー名の前に名前が付いたツールを返します。 サーバー URL が見つからないか、クライアントがツールの一覧を表示できない場合にスローします。
function getMcpClientTools(mcpServerName: string, mcpServerConfig: MCPServerConfig): Promise<McpClientTool[]>パラメーター
- mcpServerName
-
string
- mcpServerConfig
- MCPServerConfig
返品
Promise<McpClientTool[]>
listToolServers(string, string)
警告
この API は非推奨になりました。
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
指定されたエージェントの MCP サーバー定義を返します。 開発中 (NODE_ENV=開発) では、ローカル ToolingManifest.jsonが読み取ります。それ以外の場合は、リモート ツール ゲートウェイに対してクエリを実行します。
function listToolServers(agenticAppId: string, authToken: string): Promise<MCPServerConfig[]>パラメーター
- agenticAppId
-
string
サーバーを検出するエージェント アプリ ID。
- authToken
-
string
リモート ツール ゲートウェイのクエリを実行するときに使用されるベアラー トークン。
返品
Promise<MCPServerConfig[]>
正規化された MCP サーバー構成オブジェクトの配列に解決する Promise。
listToolServers(string, string, ToolOptions)
警告
この API は非推奨になりました。
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
指定されたエージェントの MCP サーバー定義を返します。 開発中 (NODE_ENV=開発) では、ローカル ToolingManifest.jsonが読み取ります。それ以外の場合は、リモート ツール ゲートウェイに対してクエリを実行します。
function listToolServers(agenticAppId: string, authToken: string, options?: ToolOptions): Promise<MCPServerConfig[]>パラメーター
- agenticAppId
-
string
サーバーを検出するエージェント アプリ ID。
- authToken
-
string
リモート ツール ゲートウェイのクエリを実行するときに使用されるベアラー トークン。
- options
- ToolOptions
ゲートウェイを呼び出すときのオプションのツール オプション。
返品
Promise<MCPServerConfig[]>
正規化された MCP サーバー構成オブジェクトの配列に解決する Promise。
listToolServers(TurnContext, Authorization, string, string, ToolOptions)
指定されたエージェントの MCP サーバー定義を返します。 開発中 (NODE_ENV=開発) では、ローカル ToolingManifest.jsonが読み取ります。それ以外の場合は、リモート ツール ゲートウェイに対してクエリを実行します。 このオーバーロードは、TurnContext から agenticAppId を自動的に解決し、指定されていない場合は認証トークンを生成します。
function listToolServers(turnContext: TurnContext, authorization: Authorization, authHandlerName: string, authToken?: string, options?: ToolOptions): Promise<MCPServerConfig[]>パラメーター
- turnContext
- TurnContext
現在の要求の TurnContext。
- authorization
- Authorization
トークン交換の承認オブジェクト。
- authHandlerName
-
string
トークン交換に使用する認証ハンドラーの名前。
- authToken
-
string
オプションのベアラー トークン。 指定しない場合は、トークン交換によって自動生成されます。
- options
- ToolOptions
ゲートウェイを呼び出すときのオプションのツール オプション。
返品
Promise<MCPServerConfig[]>
正規化された MCP サーバー構成オブジェクトの配列に解決する Promise。
sendChatHistory(TurnContext, ChatHistoryMessage[])
リアルタイムの脅威保護のために、チャット履歴を MCP プラットフォームに送信します。
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[]): Promise<OperationResult>パラメーター
- turnContext
- TurnContext
会話情報を含むターン コンテキスト。
- chatHistoryMessages
送信するチャット履歴メッセージ。
返品
Promise<OperationResult>
成功または失敗を示す OperationResult に解決される Promise。
注釈
HTTP 例外 (ネットワーク エラー、タイムアウト) はキャッチされ、ログに記録されますが、再スローされません。 代わりに、操作が成功したか失敗したかを示す OperationResult が返されます。 呼び出し元は、エラー処理の結果を検査するか、エラーの詳細が必要ない場合は無視することができます。
sendChatHistory(TurnContext, ChatHistoryMessage[], ToolOptions)
リアルタイムの脅威保護のために、チャット履歴を MCP プラットフォームに送信します。
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[], options?: ToolOptions): Promise<OperationResult>パラメーター
- turnContext
- TurnContext
会話情報を含むターン コンテキスト。
- chatHistoryMessages
送信するチャット履歴メッセージ。
- options
- ToolOptions
チャット履歴を送信するためのオプションのツール オプション。
返品
Promise<OperationResult>
成功または失敗を示す OperationResult に解決される Promise。
注釈
HTTP 例外 (ネットワーク エラー、タイムアウト) はキャッチされ、ログに記録されますが、再スローされません。 代わりに、操作が成功したか失敗したかを示す OperationResult が返されます。 呼び出し元は、エラー処理の結果を検査するか、エラーの詳細が必要ない場合は無視することができます。