Kanzi Portal MCP 服务器¶

Kanzi Portal MCP 服务器将您的 AI 助手连接到您在 Kanzi Portal 中的 Kanzi Account，使您可以用自然语言查询和管理您的账户。例如，您可以询问您的组织拥有哪些许可证、谁在使用这些许可证，以及哪些许可证即将到期。您可以查找某个平台的最新 Kanzi Studio 构建，或者提交支持工单。凡是可以在 Kanzi Portal 中完成的操作，都可以通过 Kanzi Portal MCP 服务器完成。

Kanzi Portal MCP 服务器的地址为 https://portal.kanzi.com/api/mcp。针对中国大陆用户，还提供了镜像 https://portal.kanzi.cn/api/mcp，用于为中国大陆用户提供可靠的服务。该镜像使用相同的注册流程，只是使用 .cn 端点。

与 Kanzi 文档和 API MCP 服务器不同，Kanzi Portal MCP 服务器：

需要您登录。 它使用按用户的 OAuth 2.0。注册服务器后，您的 AI 助手会打开浏览器，供您登录 Kanzi 帐户。
以您的身份运行。 每个请求都以您的 Kanzi Portal 权限运行，因此通过该服务器，您只能执行您在 Kanzi Portal 中可以执行的操作。
不接受 Kanzi 版本参数。 它基于您的帐户工作，而不是针对特定的 Kanzi 版本。

备注

Kanzi Portal MCP 服务器需要具有原生 HTTP MCP 支持的 AI 工具。其他 Kanzi MCP 服务器可以为不具有原生 HTTP 支持的工具使用 mcp-remote stdio 桥接，但它在此处不起作用，因为它无法执行 OAuth 登录。

您可以做什么¶

在您的 Kanzi Portal 权限范围内，您可以通过 Kanzi Portal MCP 服务器：

许可证 — 列出您组织的许可证和您自己的分配，分配和释放许可证，列出持有许可证的主机，以及检查平台授权。
组织 — 读取组织及其成员、分支、层次结构和元数据；创建子组织；更改组织的父组织；与子组织共享许可证；以及管理已验证的电子邮件域。
下载 — 列出 Kanzi Studio 版本以及您的许可证授权您使用的文件，获取安装和下载 URL，下载平台包，以及申请自定义平台和构建。
支持 — 列出、读取和创建支持工单，对其发表评论，更改协作者，以及上传附件。
API 密钥 — 列出、创建、重命名和删除您的 API 密钥。

设置 Kanzi Portal MCP 服务器¶

使用 AI 工具的原生 HTTP MCP 配置在工具中注册服务器，然后在工具首次使用该服务器时登录。

在 Claude Code 中设置¶

添加服务器：

claude mcp add --scope user --transport http kanzi-portal https://portal.kanzi.com/api/mcp

运行 /mcp，选择 kanzi-portal，然后按照浏览器中的提示登录。

在 VS Code 中设置¶

打开 Command Palette (Ctrl Shift P) 并选择 MCP: Open User Configuration。

在 mcp.json 文件中添加服务器配置：

{
   "servers": {
      "kanzi-portal": {
         "type": "http",
         "url": "https://portal.kanzi.com/api/mcp"
      }
   },
   "inputs": []
}

重新加载窗口，然后调用任意 kanzi-portal 工具。VS Code 会在首次调用时提示您登录。

在 Cursor 中设置¶

在 ~/.cursor/mcp.json 文件中添加服务器配置：

{
   "mcpServers": {
      "kanzi-portal": {
         "url": "https://portal.kanzi.com/api/mcp"
      }
   }
}

首次调用 kanzi-portal 工具时会打开浏览器，供您登录。

在 Windsurf 中设置¶

在 ~/.codeium/windsurf/mcp_config.json 文件中添加服务器配置：

{
   "mcpServers": {
      "kanzi-portal": {
         "serverUrl": "https://portal.kanzi.com/api/mcp"
      }
   }
}

首次调用 kanzi-portal 工具时会打开浏览器，供您登录。

在 Codex 中设置¶

在 ~/.codex/config.toml 文件中添加服务器配置：

[mcp_servers.kanzi-portal]
url = "https://portal.kanzi.com/api/mcp"
auth = "oauth"

权限和错误¶

Kanzi Portal MCP 服务器以已登录用户的身份运行，因此它只能执行该用户在 Kanzi Portal 中可以执行的操作。如果请求返回权限错误，说明您的 Kanzi 帐户不具备执行该动作的角色，而不是您的 AI 工具出了问题。产品目录工具仅供 Rightware 内部使用，会拒绝来自其他帐户的请求。

另请参阅¶

Kanzi 文档 MCP 服务器

Kanzi API MCP 服务器

使用 Kanzi AI 工具