MCP 配置

安心转 MCP 是运行在本机的 Streamable HTTP 服务。Agent 接入后，可以提交本地音视频文件转写并读取转写结果。

Agent 一键接入

在安心转 MCP 页面点击“接入 Agent”，把提示词发送到 Agent 的对话窗口，Agent 会按本文完成配置。客户端生成的提示词已包含当前 MCP URL。

也可以复制下面的提示词：

请阅读 https://anxinzhuan.cn/docs/mcp-setup.md 文档，按照步骤为我配置安心转 MCP。

给 Agent 的说明

• 用户提供了 MCP URL 时使用该地址，否则使用默认地址 http://127.0.0.1:36158/mcp。
• 先按下方“检查服务”确认服务可用。不可用时，请用户打开安心转并在 MCP 页面开启“启用 MCP Server”，再继续配置。
• 按你所在的客户端选择对应的配置方式，优先写入用户级配置。已有 anxinzhuan 时只更新它的地址，不改动其他 MCP 服务。
• 完成后告诉用户需要重启或刷新哪个客户端，以及接入后可用的工具。

连接信息

默认端口被占用时，安心转会自动改用后面的空闲端口，请以 MCP 页面显示的 MCP URL 为准。下文示例使用默认地址，实际地址不同时请替换。使用期间需要保持安心转运行。

检查服务

curl http://127.0.0.1:36158/health

返回 {"status":"ok"} 表示服务正常。Windows PowerShell 中请使用 curl.exe。

添加到客户端

Claude Code

claude mcp add --transport http --scope user anxinzhuan http://127.0.0.1:36158/mcp

添加后可以运行 claude mcp list 查看连接状态。

Codex

codex mcp add anxinzhuan --url http://127.0.0.1:36158/mcp

也可以在 ~/.codex/config.toml 中手动添加：

[mcp_servers.anxinzhuan]
url = "http://127.0.0.1:36158/mcp"

在 Codex 应用中添加时，选择“流式 HTTP”并填写 MCP URL，界面示例见 MCP 调用。

Cursor

在 ~/.cursor/mcp.json 中添加：

{
  "mcpServers": {
    "anxinzhuan": {
      "url": "http://127.0.0.1:36158/mcp"
    }
  }
}

VS Code

在用户级 mcp.json（命令面板运行“MCP: Open User Configuration”）或工作区的 .vscode/mcp.json 中添加：

{
  "servers": {
    "anxinzhuan": {
      "type": "http",
      "url": "http://127.0.0.1:36158/mcp"
    }
  }
}

其他客户端

在客户端的 MCP 设置中添加 Streamable HTTP 类型的服务（可能显示为 HTTP、流式 HTTP 或 streamableHttp），名称填写 anxinzhuan，URL 填写 MCP URL，无需填写认证信息。只支持 stdio 的客户端暂时无法直接连接。

验证连接

保存配置后，重启客户端或刷新 MCP 连接。连接成功后可以看到以下工具：

之后可以直接对 Agent 说“用安心转转写这个文件”，并附上音视频文件的完整路径。