McpToolServerConfigurationService class
MCP(모델 컨텍스트 프로토콜) 도구 서버를 검색 및 정규화하고 Claude SDK에서 사용할 수 있는 구성 개체를 생성하는 서비스를 담당합니다.
생성자
| Mcp |
McpToolServerConfigurationService를 생성합니다. |
메서드
| get |
MCP 서버에 연결하고 서버 이름 앞에 이름이 접두사로 지정된 도구를 반환합니다. 서버 URL이 없거나 클라이언트가 도구를 나열하지 못하면 throw됩니다. |
| 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이 없거나 클라이언트가 도구를 나열하지 못하면 throw됩니다.
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 서버 구성 개체의 배열을 확인하는 약속입니다.
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 서버 구성 개체의 배열을 확인하는 약속입니다.
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 서버 구성 개체의 배열을 확인하는 약속입니다.
sendChatHistory(TurnContext, ChatHistoryMessage[])
실시간 위협 방지를 위해 MCP 플랫폼에 채팅 기록을 보냅니다.
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[]): Promise<OperationResult>매개 변수
- turnContext
- TurnContext
대화 정보를 포함하는 턴 컨텍스트입니다.
- chatHistoryMessages
보낼 채팅 기록 메시지입니다.
반품
Promise<OperationResult>
성공 또는 실패를 나타내는 OperationResult로 확인되는 Promise입니다.
설명
HTTP 예외(네트워크 오류, 시간 제한)가 catch되고 기록되지만 다시 throw되지는 않습니다. 대신 이 메서드는 작업의 성공 여부를 나타내는 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 예외(네트워크 오류, 시간 제한)가 catch되고 기록되지만 다시 throw되지는 않습니다. 대신 이 메서드는 작업의 성공 여부를 나타내는 OperationResult를 반환합니다. 호출자는 오류 처리 결과를 검사하거나 오류 세부 정보가 필요하지 않은 경우 무시하도록 선택할 수 있습니다.