Torna

# MCP

有了MCP Server，开发者就可以通过AI助手完成以下工作：根据接口文档生成或修改代码、搜索接口文档内容等。

准备工作：

如果使用nginx反向代理Torna服务，需要添加指令 proxy_http_version 1.1;，如下图所示：

MCP

# 获取Torna API令牌

在Torna后台，点击右上角头像-【个人中心】-【API令牌】，如下图所示：

Torna API令牌

点击新建Token，输入令牌名称，如：MCP，过期时间选填，不填则永久期限。

选择应用，默认为全部应用，如果选择部分应用，MCP只能查询出勾选应用下的接口。

点击确定，如下图所示：

Torna API令牌

保存后在列表页面点击👁将显示完整的token，此token将用于后续的MCP调用。

# 配置MCP

Torna提供两种形式的MCP服务

  • streamable（推荐）
  • sse

以Trae (opens new window)为例，演示如何配置MCP streamable

点击右上角齿轮-【MCP】-Add-手动添加，如下图所示：

Trae MCP

在弹出框内，输入以下内容：

{
  "mcpServers": {
    "tornamcp": {
      "url": "http(s)://<host>:<port>/mcp/<channel>?token=<API令牌>"
    }
  }
}

url说明：

  • host,port：替换成torna服务器地址，如：http://127.0.0.1:7700/mcp/streamable?token=xxxx, http:/torna.xxx.com/mcp/streamable?token=xxxx
  • channel：streamable、sse 二选一，推荐使用streamable
  • API令牌：替换成之前获取的令牌

完整示例如下：

{
  "mcpServers": {
    "tornamcp": {
      "url": "http://192.168.101.111:7700/mcp/streamable?token=2582bb2f4a5e4da09b396ec4c4ffd583"
    }
  }
}

添加完成后可以看到MCP列表中多了一个tornamcp，如下图所示：

Trae MCP

TIP

如果出现403错误，需要在Torna后台输入License

如果出现402错误，需要检查API令牌是否正确

验证MCP Server是否正常工作

创建一个空文件夹：mcp-demo，使用trae打开

聊天框，选择@Builder with MCP

Trae MCP

输入内容

通过tornamcp 查询 登录接口 并生成一个vue3的表单页面

AI会自动寻找登录接口，生成一个vue3的表单页面，最终结果如下图所示：

Trae MCP

生成页面效果图：

Trae MCP

  • AI聊天参考格式
通过tornamcp 查询关键字 "xxx接口" 并生成一个vue3的表单页面

通过tornamcp 查询 /user/logn 接口 并生成一个vue3的表单页面

通过tornamcp 查询关键字 订单相关接口 并生成一个增删改查页面

# MCP客户端查询权限

默认情况下MCP客户端允许查询所有文档

可以前往Torna后台进行设置

Trae MCP

如果设置不允许, 客户端只能查询具备对应权限的文档

设置建议: 如果MCP功能主要提供给前端使用, 可设置允许

← 对接Apifox →