> ## Documentation Index
> Fetch the complete documentation index at: https://docs.veadk.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# 可信 MCP 工具集

## 功能说明

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

## 前提条件

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

## 使用方法

```python title="mcp_connection.py" lines theme={null}
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 参数](/productions/veadk/preview/zh/components/tools/custom-mcp#参数)。常用 `tool_filter` 限定工具范围，`header_provider` 按请求提供身份相关请求头；不要在多个用户之间复用固定用户令牌

可信传输不代替服务端授权，工具发现成功也不代表所有业务操作均已授权。部署要求和服务端配合方式见[可信 MCP 安全说明](/productions/veadk/preview/zh/components/security/trusted-mcp)