> ## 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 Server

## 功能说明

如果内置接入方式都无法满足需求，可直接使用 Google ADK 的 `MCPToolset` 连接任意 MCP Server。注册后，智能体会自动加载 MCP Server 暴露的工具，并在推理过程中按需调用。

## 使用方法

```python lines theme={null}
from veadk import Agent
from google.adk.tools.mcp_tool.mcp_toolset import MCPToolset
from google.adk.tools.mcp_tool.mcp_session_manager import (
    StreamableHTTPConnectionParams,
)

toolset = MCPToolset(
    connection_params=StreamableHTTPConnectionParams(
        url="https://your-mcp-endpoint",
        headers={"Authorization": "Bearer your-api-key-here"},
    ),
)

agent = Agent(tools=[toolset])
```

## 会话中断后的自动重连

当 MCP Server 重启、缩容或会话过期导致连接失效时，VeADK 会清理已失效的缓存会话、重新连接，并自动重试当前的工具加载或调用一次。若重连后的重试仍然失败，错误会返回给调用方；主动取消的任务不会触发重试。