什么是 MCP 服务器？

供 AI 客户端调用的远程工具主机。narrador 的文本转语音 MCP 在 https://api.narrador.io/mcp，登记为 io.narrador/narrador。

如何加入 Claude Desktop、Cursor 或 VS Code？

若客户端支持远程 MCP OAuth，添加 https://api.narrador.io/mcp 并登录。否则用 Authorization Bearer 带上 nrd_files_ 或 nrd_x_。示例见 https://api.narrador.io/docs。

API 要额外收费吗？

不。API 使用与应用相同的积分和价格。

MCP 与 REST API

面向 AI 代理的文本转语音 MCP 服务器和 API

为 AI 代理提供托管的文本转语音 API 和 MCP 服务器。在 https://api.narrador.io/mcp 用 OAuth 或 API key 连接，或查看 https://api.narrador.io/docs。

通过 narrador files 处理文档
create_files_job 或 POST /v1/files/generate。省略 voiceId 时按文档语言自动选声。
通过 narrador X 处理帖子
generate_x_audio 返回音频，不返回视频。视频导出在应用内。
同一套积分，MCP 或 REST
在 Cursor、Claude Desktop 或 VS Code 用 OAuth，或使用 nrd_files_ / nrd_x_ 密钥。

打开 API 文档

Cursor、Claude Desktop 和 VS Code

远程 MCP 配置 — 与 API 文档中的示例相同。支持远程 MCP OAuth 的客户端只需 URL，包括 Cursor、Claude Desktop 和 VS Code。API 密钥仍是备选：nrd_files_ 用于 narrador files 工具，nrd_x_ 用于 narrador X。

添加到项目中的 .cursor/mcp.json，或每个项目的 ~/.cursor/mcp.json。

OAuth

建议在客户端支持远程 MCP OAuth 时使用。仅 URL — 然后登录。权限范围：narrador:文件,narrador:x.

{
  "mcpServers": {
    "narrador": {
      "url": "https://api.narrador.io/mcp"
    }
  }
}

API 密钥

客户端和脚本的替代方案。相同的 URL 加上 Authorization Bearer 或 x-api-key。

{
  "mcpServers": {
    "narrador": {
      "url": "https://api.narrador.io/mcp",
      "headers": {
        "Authorization": "Bearer nrd_files_YOUR_SECRET_KEY"
      }
    }
  }
}

限制

速率限制: 每个 API 密钥每 60 秒 60 次请求。超出返回 HTTP 429。
文件大小: narrador files 路由上每次文件上传和 URL 下载最大 50 MB。
纯文本: POST /v1/files/generate 与 POST /v1/files/jobs 的 text 字段最多 500,000 个字符。

常见问题

什么是 MCP 服务器？: 供 AI 客户端调用的远程工具主机。narrador 的文本转语音 MCP 在 https://api.narrador.io/mcp，登记为 io.narrador/narrador。
如何加入 Claude Desktop、Cursor 或 VS Code？: 若客户端支持远程 MCP OAuth，添加 https://api.narrador.io/mcp 并登录。否则用 Authorization Bearer 带上 nrd_files_ 或 nrd_x_。示例见 https://api.narrador.io/docs。
API 要额外收费吗？: 不。API 使用与应用相同的积分和价格。