Agents & skills · for AI agents

连接您自己的 MCP 服务器

注册远程 MCP 服务器，使您的智能体能够通过控制台或 REST 调用其工具。

MCP tools:list_mcp_serverslist_toolsupdate_agent

自带工具：注册一个远程 MCP 服务器，其提供的工具即可附加到您的智能体（agent）上。故意不提供“创建 MCP 服务器”工具——注册服务器意味着您信任该服务器在您的租户（tenant）环境中运行，因此这是一个在控制台（或 REST 调用）中进行的有意操作，而非由智能体自行执行。

1. 注册服务器

在控制台中：工具 / MCP → 添加 MCP 服务器 — 为其命名，选择传输协议（Streamable HTTP 或 SSE），以及 URL 和任何身份验证头。

或者通过 REST 接口，使用您的租户密钥（$BASE = https://api.agent4.io/v1）：

curl -X POST $BASE/mcp-servers -H "X-API-Key: $KEY" -H 'Content-Type: application/json' \
  -d '{"name":"my-tools","transport":"streamable_http",
       "config":{"url":"https://tools.example.com/mcp","headers":{"Authorization":"Bearer …"}}}'

仅接受远程传输协议。stdio（本地命令）将被拒绝——因为服务器运行在平台上，而不是您的机器上，所以本地命令对您来说既无用，也存在代码执行风险。

2. 查看其工具

list_mcp_servers()   # the MCP servers registered on your tenant
list_tools()         # every tool you can attach to an agent, including the ones from your servers

3. 将工具附加到智能体

update_agent(name="Support", add_tools=["…"])   # incremental; use tool names exactly as list_tools() reports them

智能体现在可以在对话期间调用这些工具。请保持工具集精简——少量相关的工具胜过大量工具（参见设计原则）。