# IaGenify SDK 0.3.0：将智能体连接到你选择的 MCP 服务器。

Canonical URL: https://www.iagenify.com/zh/news/iagenify-sdk-mcp-client

SDK 成为 MCP 客户端：连接兼容服务器，选择开放的工具，并在无需为每个供应商编写专用适配器的情况下使用它们。

## Key points
- 兼容的 MCP 服务器可通过统一的 SDK 接口连接。
- 连接可以只授权指定工具，而不是默认开放全部工具。
- 智能体可以使用选定的服务器；自定义模型循环也可以直接取得工具定义。

许多实用工具已经支持 MCP 协议。过去要通过 SDK 使用它们，开发者往往需要为每个供应商编写适配器，并单独转换工具定义。IaGenify SDK 0.3.0 加入 MCP 客户端，以统一接口连接兼容服务器。

## 连接一次，再选择可用工具

连接信息包括服务器 URL，也可以包含认证令牌。开发者选择要开放的工具；如果没有提供列表，则默认不启用任何工具，访问范围始终明确。


```
await api.mcp.connect({
  name: "team-tools",
  url: "https://tools.example.com/mcp",
  token: process.env.TOOLS_TOKEN,
  tools: ["search", "get_record"],
});
```

示例使用通用服务器。实际应用应将凭据保存在运行环境的密钥管理器中，绝不能写入浏览器包、文章或代码仓库。

## 为智能体提供经过选择的工具

连接服务器后，智能体可以使用相关工具。开发者也可以取得 MCP 工具定义，交给自己的模型回合循环处理，而不必使用 SDK 的智能体执行引擎。


```
const agent = api.agents.create({
  runtime: "local",
  machine,
  model: "your-model",
  mcp: ["team-tools"],
});

const definitions = await api.mcp.tools();
```

`mcp` 选项让服务器选择在创建智能体时一目了然。省略该选项会使用账户已连接的服务器；传入空列表则明确表示一个也不使用。

## 权限仍是集成的一部分

MCP 让工具连接更容易，但不能替代对工具权限的判断。SDK 遵循服务器权限和智能体运行模式。应用应只开放任务所需的服务器和操作。

对于已有 MCP 服务器的团队，这尤其有用：他们可以复用协议边界，明确允许的工具，并继续由现有服务器描述自身操作。

## 一种协议，两种使用方式

有些应用希望 IaGenify 执行智能体循环；另一些应用已有自己的编排系统，只需要工具定义。SDK 同时支持这两种路径。

> 连接团队已有的工具，选择智能体可以看到的内容，并让这条边界在代码中保持清晰。

SDK 0.3.0 将 MCP 作为一等连接方式。集成更简单，同时工具选择和权限仍由应用决定。

## FAQ
### 每个 MCP 服务都需要 IaGenify 适配器吗？
不需要。SDK 通过统一客户端接口连接兼容服务器。

### 连接服务器后会启用所有工具吗？
不会。可以指定允许列表；未提供列表时，默认不启用工具。

### 不使用 `api.agents` 也能使用 MCP 吗？
可以。`api.mcp.tools()` 会提供工具定义，供自定义模型循环使用。

### MCP 令牌应存放在哪里？
存放在服务端密钥管理器或运行环境配置中，不要放入浏览器代码或代码仓库。