McpToolServerConfigurationService class

Palvelu, joka on vastuussa MCP:n (Model Context Protocol) työkalupalvelimien etsimisestä ja normalisoinnista sekä Claude SDK:n kuluttamien määritysobjektien tuottamisesta.

Konstruktorit

McpToolServerConfigurationService(IConfigurationProvider<ToolingConfiguration>)

Muodosta McpToolServerConfigurationService.

Menetelmät

getMcpClientTools(string, MCPServerConfig)

Muodosta yhteys MCP-palvelimeen ja palauta työkalut, joiden nimien etuliitteenä on palvelimen nimi. Palauttaa virheen, jos palvelimen URL-osoite puuttuu tai jos asiakas ei pysty luettelemaan työkaluja.

listToolServers(string, string)

Palauta tietyn agentin MCP-palvelimen määritykset. Kehitysvaiheessa (NODE_ENV=Kehitys) tämä lukee paikallinen ToolingManifest.json; muussa tapauksessa se tekee kyselyn etätyökaluyhdyskäytävään.

listToolServers(string, string, ToolOptions)

Palauta tietyn agentin MCP-palvelimen määritykset. Kehitysvaiheessa (NODE_ENV=Kehitys) tämä lukee paikallinen ToolingManifest.json; muussa tapauksessa se tekee kyselyn etätyökaluyhdyskäytävään.

listToolServers(TurnContext, Authorization, string, string, ToolOptions)

Palauta tietyn agentin MCP-palvelimen määritykset. Kehitysvaiheessa (NODE_ENV=Kehitys) tämä lukee paikallinen ToolingManifest.json; muussa tapauksessa se tekee kyselyn etätyökaluyhdyskäytävään. Tämä ylikuormitus ratkaisee automaattisesti TurnContextin agenticAppId-tunnuksen ja luo todennustunnuksen, jos sitä ei ole annettu.

sendChatHistory(TurnContext, ChatHistoryMessage[])

Lähettää keskusteluhistorian MCP-ympäristöön reaaliaikaista uhkien suojausta varten.

sendChatHistory(TurnContext, ChatHistoryMessage[], ToolOptions)

Lähettää keskusteluhistorian MCP-ympäristöön reaaliaikaista uhkien suojausta varten.

Konstruktorin tiedot

McpToolServerConfigurationService(IConfigurationProvider<ToolingConfiguration>)

Muodosta McpToolServerConfigurationService.

new McpToolServerConfigurationService(configProvider?: IConfigurationProvider<ToolingConfiguration>)

Parametrit

configProvider

IConfigurationProvider<ToolingConfiguration>

Valinnainen määrityspalvelu. Oletusarvona on defaultToolingConfigurationProvider, jos sitä ei ole määritetty.

Menetelmän tiedot

getMcpClientTools(string, MCPServerConfig)

Muodosta yhteys MCP-palvelimeen ja palauta työkalut, joiden nimien etuliitteenä on palvelimen nimi. Palauttaa virheen, jos palvelimen URL-osoite puuttuu tai jos asiakas ei pysty luettelemaan työkaluja.

function getMcpClientTools(mcpServerName: string, mcpServerConfig: MCPServerConfig): Promise<McpClientTool[]>

Parametrit

mcpServerName

string

mcpServerConfig
MCPServerConfig

Palautukset

Promise<McpClientTool[]>

listToolServers(string, string)

Varoitus

Tämä ohjelmointirajapinta on nyt vanhentunut.

Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.

Palauta tietyn agentin MCP-palvelimen määritykset. Kehitysvaiheessa (NODE_ENV=Kehitys) tämä lukee paikallinen ToolingManifest.json; muussa tapauksessa se tekee kyselyn etätyökaluyhdyskäytävään.

function listToolServers(agenticAppId: string, authToken: string): Promise<MCPServerConfig[]>

Parametrit

agenticAppId

string

Agenttisovellustunnus, josta palvelimia löydetään.

authToken

string

Haltijatunnus, jota käytetään, kun etätyökaluyhdyskäytävää kyselevät.

Palautukset

Promise<MCPServerConfig[]>

Lupaus ratkaista useita normalisoituja MCP-palvelimen määritysobjekteja.

listToolServers(string, string, ToolOptions)

Varoitus

Tämä ohjelmointirajapinta on nyt vanhentunut.

Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.

Palauta tietyn agentin MCP-palvelimen määritykset. Kehitysvaiheessa (NODE_ENV=Kehitys) tämä lukee paikallinen ToolingManifest.json; muussa tapauksessa se tekee kyselyn etätyökaluyhdyskäytävään.

function listToolServers(agenticAppId: string, authToken: string, options?: ToolOptions): Promise<MCPServerConfig[]>

Parametrit

agenticAppId

string

Agenttisovellustunnus, josta palvelimia löydetään.

authToken

string

Haltijatunnus, jota käytetään, kun etätyökaluyhdyskäytävää kyselevät.

options
ToolOptions

Valinnaiset työkaluvaihtoehdot yhdyskäytävää kutsuttaessa.

Palautukset

Promise<MCPServerConfig[]>

Lupaus ratkaista useita normalisoituja MCP-palvelimen määritysobjekteja.

listToolServers(TurnContext, Authorization, string, string, ToolOptions)

Palauta tietyn agentin MCP-palvelimen määritykset. Kehitysvaiheessa (NODE_ENV=Kehitys) tämä lukee paikallinen ToolingManifest.json; muussa tapauksessa se tekee kyselyn etätyökaluyhdyskäytävään. Tämä ylikuormitus ratkaisee automaattisesti TurnContextin agenticAppId-tunnuksen ja luo todennustunnuksen, jos sitä ei ole annettu.

function listToolServers(turnContext: TurnContext, authorization: Authorization, authHandlerName: string, authToken?: string, options?: ToolOptions): Promise<MCPServerConfig[]>

Parametrit

turnContext
TurnContext

Nykyisen pyynnön TurnContext.

authorization
Authorization

Valtuutusobjekti tunnuksen vaihdolle.

authHandlerName

string

Sen todennuskäsittelijän nimi, jota käytetään tunnuksen vaihdossa.

authToken

string

Valinnainen haltijatunnus. Jos sitä ei anneta, se luodaan automaattisesti tunnuksensiirron kautta.

options
ToolOptions

Valinnaiset työkaluvaihtoehdot yhdyskäytävää kutsuttaessa.

Palautukset

Promise<MCPServerConfig[]>

Lupaus ratkaista useita normalisoituja MCP-palvelimen määritysobjekteja.

sendChatHistory(TurnContext, ChatHistoryMessage[])

Lähettää keskusteluhistorian MCP-ympäristöön reaaliaikaista uhkien suojausta varten.

function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[]): Promise<OperationResult>

Parametrit

turnContext
TurnContext

Vuoron konteksti, joka sisältää keskustelutietoja.

chatHistoryMessages

ChatHistoryMessage[]

Lähetettävät keskusteluhistorian viestit.

Palautukset

Promise<OperationResult>

Lupaus, joka ratkaisee OperationResult-kohteen, joka ilmaisee onnistumisen tai epäonnistumisen.

Huomautukset

HTTP-poikkeukset (verkon virheet ja aikakatkaisut) havaitaan ja kirjataan, mutta ne eivät jää uudelleen käyttöön. Sen sijaan -menetelmä palauttaa OperationResult-arvon, joka ilmaisee, onko toiminto onnistunut vai epäonnistunut. Soittajat voivat joko tarkastaa virheenkäsittelytuloksen tai ohittaa sen, jos virhetietoja ei tarvita.

sendChatHistory(TurnContext, ChatHistoryMessage[], ToolOptions)

Lähettää keskusteluhistorian MCP-ympäristöön reaaliaikaista uhkien suojausta varten.

function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[], options?: ToolOptions): Promise<OperationResult>

Parametrit

turnContext
TurnContext

Vuoron konteksti, joka sisältää keskustelutietoja.

chatHistoryMessages

ChatHistoryMessage[]

Lähetettävät keskusteluhistorian viestit.

options
ToolOptions

Valinnaisia työkaluvaihtoehtoja keskusteluhistorian lähettämiseen.

Palautukset

Promise<OperationResult>

Lupaus, joka ratkaisee OperationResult-kohteen, joka ilmaisee onnistumisen tai epäonnistumisen.

Huomautukset

HTTP-poikkeukset (verkon virheet ja aikakatkaisut) havaitaan ja kirjataan, mutta ne eivät jää uudelleen käyttöön. Sen sijaan -menetelmä palauttaa OperationResult-arvon, joka ilmaisee, onko toiminto onnistunut vai epäonnistunut. Soittajat voivat joko tarkastaa virheenkäsittelytuloksen tai ohittaa sen, jos virhetietoja ei tarvita.