添加和管理标记

# Use McpToolServerConfigurationService.list_tool_servers
from microsoft.agents.a365.tooling import McpToolServerConfigurationService

config_service = McpToolServerConfigurationService()
tool_servers = await config_service.list_tool_servers(agentic_app_id, auth_token)

参数：

包： microsoft-agents-a365-tooling

// Use McpToolServerConfigurationService.listToolServers
const { McpToolServerConfigurationService } = require('@microsoft/agents-a365-tooling');

const configService = new McpToolServerConfigurationService();
const toolServers = await configService.listToolServers(agentUserId, authToken);

参数：

包： Microsoft.Agents.A365.Tooling

// Use IMcpToolServerConfigurationService.ListToolServersAsync
using Microsoft.Agents.A365.Tooling.Services;

var configService = serviceProvider.GetRequiredService<IMcpToolServerConfigurationService>();
var toolServers = await configService.ListToolServersAsync(agentInstanceId, authToken);

参数：

包： Microsoft.Agents.A365.Tooling

• microsoft-agents-a365-tooling：核心工具功能
• microsoft-agents-a365-tooling-extensions-agentframework：Agent Framework 集成
• microsoft-agents-a365-tooling-extensions-azureaifoundry：Azure AI Foundry 集成
• microsoft-agents-a365-tooling-extensions-openai：OpenAI 集成
• microsoft-agents-a365-tooling-extensions-semantickernel：语义内核集成

• @microsoft/agents-a365-tooling：核心工具功能
• @microsoft/agents-a365-tooling-extensions-claude：Claude 集成
• @microsoft/agents-a365-tooling-extensions-openai：OpenAI 集成
• @microsoft/agents-a365-tooling-extensions-langchain：LangChain 集成

• Microsoft.Agents.A365.Tooling：核心工具功能
• Microsoft.Agents.A365.Tooling.Extensions.AgentFramework：Agent Framework 集成
• Microsoft.Agents.A365.Tooling.Extensions.AzureAIFoundry：Azure AI Foundry 集成
• Microsoft.Agents.A365.Tooling.Extensions.SemanticKernel：语义内核集成

使用 OpenAI 的 Python

此示例演示如何在 Python 应用程序中将 MCP 工具与 OpenAI 集成。

添加 Import 语句。

添加所需的导入以访问工具模块和 OpenAI 扩展：

from microsoft.agents.a365.tooling import McpToolServerConfigurationService
from microsoft.agents.a365.tooling.extensions.openai import mcp_tool_registration_service

2. 初始化工具服务

创建配置和工具注册服务的实例：

# Create configuration service and tool service with dependency injection
self.config_service = McpToolServerConfigurationService()
self.tool_service = mcp_tool_registration_service.McpToolRegistrationService()

3. 向 OpenAI 代理注册 MCP 工具

使用此方法 add_tool_servers_to_agent 向 OpenAI 代理注册所有配置的 MCP 工具。 此方法同时处理代理身份验证和非AGENTIC 身份验证方案：

async def setup_mcp_servers(self, auth: Authorization, context: TurnContext):
    """Set up MCP server connections"""
    try:
        use_agentic_auth = os.getenv("USE_AGENTIC_AUTH", "false").lower() == "true"
        if use_agentic_auth:
            self.agent = await self.tool_service.add_tool_servers_to_agent(
                agent=self.agent,
                agentic_app_id=agentic_app_id,
                auth=auth,
                context=context,
            )
        else:
            self.agent = await self.tool_service.add_tool_servers_to_agent(
                agent=self.agent,
                agentic_app_id=agentic_app_id,
                auth=auth,
                context=context,
                auth_token=self.auth_options.bearer_token,
            )

    except Exception as e:
        logger.error(f"Error setting up MCP servers: {e}")

方法参数

下表描述了与 add_tool_servers_to_agent 一起使用的参数。

4. 初始化期间调用

在运行代理之前，请确保在初始化期间调用安装方法：

# Setup MCP servers during initialization
await self.setup_mcp_servers(auth, context)

该方法 add_tool_servers_to_agent 自动：

• 从ToolingManifest.json加载所有 MCP 服务器
• 将其工具注册到 OpenAI 代理
• 基于清单配置设置身份验证
• 使工具可供代理调用

使用 LangChain 的 JavaScript

此示例演示如何在 JavaScript/TypeScript 应用程序中将 MCP 工具与 LangChain 集成。

添加 Import 语句。

添加所需的导入以访问工具模块和 LangChain 扩展：

import { McpToolServerConfigurationService } from '@microsoft/agents-a365-tooling';
import { McpToolRegistrationService } from '@microsoft/agents-a365-tooling-extensions-langchain';

2. 初始化工具服务

创建工具注册服务的实例：

const toolService = new McpToolRegistrationService();

3. 向 LangChain 代理注册 MCP 工具

使用此方法 addToolServersToAgent 向 LangChain 代理注册所有配置的 MCP 工具。 此方法同时处理代理身份验证和非AGENTIC 身份验证方案：

// Get MCP Tools
try {
  const agent = await toolService.addToolServersToAgent(
    agent,
    process.env.AGENTIC_USER_ID || '',
    authorization,
    turnContext,
    process.env.MCP_AUTH_TOKEN || "",
  );
} catch (error) {
  console.error('Error adding MCP tool servers:', error);
}

方法参数

下表描述了与 addToolServersToAgent 一起使用的参数。

4. 初始化期间调用

addToolServersToAgent在初始化期间调用该方法，以向代理注册 MCP 工具。

该方法 addToolServersToAgent 自动：

• 从ToolingManifest.json加载所有 MCP 服务器
• 向 LangChain 代理注册其工具
• 基于清单配置设置身份验证
• 使工具可供代理调用

具有语义内核的 .NET

此示例演示如何在 .NET 应用程序中将 MCP 工具与语义内核集成。

添加 Import 语句。

添加所需的命名空间以访问工具模块和语义内核扩展：

using Microsoft.Agents.A365.Tooling;
using Microsoft.Agents.A365.Tooling.Extensions.SemanticKernel;

在依赖项注入术语中，服务：

将工具服务添加到依赖项注入容器，以便将其注入到类中：

builder.Services.AddSingleton<IMcpToolRegistrationService, McpToolRegistrationService>();
builder.Services.AddSingleton<IMcpToolServerConfigurationService, McpToolServerConfigurationService>();

3. 添加专用字段声明

声明用于保存工具注册服务引用的专用字段：

private readonly IMcpToolRegistrationService _toolsService;

4. 将 MCP 工具注册到语义内核

使用 AddToolServersToAgentAsync 扩展方法向语义内核实例注册所有配置的 MCP 工具。 此方法同时处理代理身份验证和非AGENTIC 身份验证方案：

// Simplified call (authentication configured automatically)
await toolService.AddToolServersToAgentAsync(kernel, userAuthorization, turnContext);

// Or with explicit authentication parameters:
if (useAgenticAuth)
{
    await toolService.AddToolServersToAgentAsync(kernel, userAuthorization, authHandlerName, turnContext);
}
else
{
    await toolService.AddToolServersToAgentAsync(kernel, userAuthorization, authHandlerName, turnContext, authToken);
}

方法参数

下表描述了与 AddToolServersToAgentAsync 一起使用的参数。

该方法 AddToolServersToAgentAsync 自动：

• 从ToolingManifest.json加载所有 MCP 服务器
• 将其工具注册到语义内核
• 基于清单配置设置身份验证
• 使工具可供代理调用