返回动态
版本SDK6 分钟阅读

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

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

iagenifysdkmcpagentsintegrations

许多实用工具已经支持 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 作为一等连接方式。集成更简单,同时工具选择和权限仍由应用决定。

常见问题

每个 MCP 服务都需要 IaGenify 适配器吗?

不需要。SDK 通过统一客户端接口连接兼容服务器。

连接服务器后会启用所有工具吗?

不会。可以指定允许列表;未提供列表时,默认不启用工具。

不使用 `api.agents` 也能使用 MCP 吗?

可以。`api.mcp.tools()` 会提供工具定义,供自定义模型循环使用。

MCP 令牌应存放在哪里?

存放在服务端密钥管理器或运行环境配置中,不要放入浏览器代码或代码仓库。

返回动态