可信 MCP 工具集 - AgentKit 文档

功能说明

TrustedMcpToolset 连接支持 Trusted MCP 协议的服务，需同时使用 Streamable HTTP 连接与 x-trusted-mcp: true 请求头。仅提供 Authorization 不会启用可信传输。服务端必须支持该协议，普通 MCP 服务使用自定义 MCP Server中的接入方式

前提条件

安装 python -m pip install veadk-python，由服务提供方获取 MCP URL、访问凭证和可信连接要求。设置 MCP_SERVER_URL、MCP_SERVER_TOKEN 后，先验证工具发现，再注册到智能体

使用方法

mcp_connection.py

import asyncio
import os
from veadk.tools.mcp_tool.trusted_mcp_toolset import TrustedMcpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams

async def main():
    toolset = TrustedMcpToolset(
        connection_params=StreamableHTTPConnectionParams(
            url=os.environ["MCP_SERVER_URL"],
            headers={
                "Authorization": f"Bearer {os.environ['MCP_SERVER_TOKEN']}",
                "x-trusted-mcp": "true",
            },
        ),
    )
    try:
        print([tool.name for tool in await toolset.get_tools()])
    finally:
        await toolset.close()

asyncio.run(main())

预期输出为当前凭证可访问的工具名。通过 Agent(tools=[toolset]) 注册时，完成业务调用后同样需要关闭连接

参数

connection_params 为必填，启用可信连接时使用 StreamableHTTPConnectionParams。其他关键字参数沿用已安装 Google ADK McpToolset 的参数与默认值，完整表见自定义 MCP 参数。常用 tool_filter 限定工具范围，header_provider 按请求提供身份相关请求头；不要在多个用户之间复用固定用户令牌可信传输不代替服务端授权，工具发现成功也不代表所有业务操作均已授权。部署要求和服务端配合方式见可信 MCP 安全说明

最后修改于 2026年9月19日