Narrivela TEXT TO SPEECH
MCP CONNECTIONS

通用 MCP 接入与客户端配置

查看 Narrivela 远程 MCP 地址、账户 OAuth 和各客户端配置，了解文字、批量、分页下载流程及未完成的宿主验收范围。

接入与验收状态

生产服务协议验收通过（SDK）

2026 年 10 月 14 日，使用 MCP SDK 1.32.0 完成真实生产服务协议验收：公共客户端 DCR、无客户端密钥的授权码与 S256 PKCE、有效签名令牌及严格邮箱验证，以及一次保持同一账户身份的刷新令牌轮换。

无专用 UI 的 SDK 已读取实际 get_service_capabilities，并调用 Qwen Audio 3.0 TTS Plus 完成一个两段短句批量任务；两个 WAV 下载与包含两份音频和清单的 ZIP 内容已核对。它验证的是服务协议，不是下列七个宿主的实际应用连接。长文本与大批量的支持基于同一服务端实现和隔离 SDK 夹具，尚未完成真实生产大长文或大批量生成验收。

资料核对日期：2026 年 10 月 14 日。首次通用连接还受 客户端注册容量 限制。下列七个宿主均未标为通过。网页语音与公开插件状态请分别查看 当前可用状态。

服务配置

名称
Narrivela
MCP 地址
https://app.narrivela.com/mcp
传输
HTTPS Streamable HTTP；使用这个实际地址，不要选本地 stdio 或另造 SSE 地址。
OAuth 资源
https://app.narrivela.com/mcp
权限
voxkit:use 是既有权限标识；公开品牌仍为 Narrivela。
账户
使用 Narrivela 账户，经浏览器授权并验证邮箱后调用账户工具，无需语音供应商 API key。
通用登录状态
真实生产 SDK 授权码、S256 PKCE、严格邮箱验证与一次轮换刷新通过；每个客户端的实际授权与工具流程仍未验收。
当前输入上限
生产能力查询返回每任务合计 50,000 UTF-16 code units、最多 1,000 项；不是承诺这些上限均已真实生成测试。

使用客户端支持的远程连接器、原生应用或服务端请求路径。本指南不表示任意网站的浏览器 JavaScript 可以跨站直连 MCP。

浏览器授权流程

通用路径采用 OAuth 2.1 授权码、S256 PKCE 与动态客户端注册（DCR）。这是公共客户端流程，令牌端点的客户端认证方式为 none，无需共享 client secret 或手工复制 Bearer。none 不表示 MCP 免登录；工具请求仍须携带当前账户的有效授权。以下服务协议已用 SDK 在生产验证，不是实际宿主已连接的证明。

  1. 发现与注册

    未登录的 MCP 请求返回 401。客户端读取 WWW-Authenticate 指向的受保护资源元数据，再发现授权服务并注册自己的客户端及回调地址。

  2. 完成账户授权

    按浏览器提示登录并验证邮箱；一次性授权码应配合该次请求对应的 S256 PKCE verifier 使用。

  3. 核对精确回调

    使用所选客户端显示或文档规定的回调，注册后精确匹配。私有协议和动态回环回调分别校验；既有网页或 OpenAI 应用回调不是所有客户端的公共回调。

  4. 由客户端刷新授权

    支持的客户端使用 refresh_token grant 并私下保存凭据。生产 SDK 已验证一次刷新令牌轮换保持同一账户；各实际宿主的刷新与回调处理仍需分别验收。断开客户端不等于撤销账户或全部已签发令牌。

不要将运营者 API key、ChatGPT 应用密钥或其他用户的长期凭据放入共享配置。只能填写 API key 的客户端不能因此被宣称支持本账户 OAuth；接入未验收前可使用 网页工作室。

客户端注册容量

Auth0 Free 包含 Auth for MCP，但其实体上限为最多 10 个 Applications 和 100 个 Client Grants。每次向 /oidc/register 发起新的注册都会创建一个应用；客户端应保存首次 DCR 注册结果与 client ID，并在后续登录复用，而不是每次登录重新注册。

用户数和已登记客户端应用数是不同的计数，不能把 100 个用户理解为 100 个应用，也不能承诺当前免费方案能容纳 100 个独立 MCP 客户端实例。生产协议已经验收，但首次通用连接仍受应用容量限制；当前剩余可注册名额尚未确认，不代表所有新注册已被阻止。

若注册受限，可以使用 现有网页工作室。扩大独立客户端开放范围前，需要先确认容量方案；目前没有通过付费升级或删除旧应用消除这一限制。Auth0 官方功能与方案 · 官方实体上限 · 官方 DCR 注册复用说明。

选择客户端

每个平台当前均为未验收（not tested），没有填入虚构版本、成功授权或市场审核结果。未来标为通过时，应说明具体版本、日期与实际验证范围。

WorkBuddy
自定义连接器 streamableHttp · 未验收
Claude Web / Desktop
Web 连接器 Register automatically · 未验收
Cursor
mcpServers 远程 URL · 未验收
VS Code / Copilot
servers 与 type http · 未验收
Gemini CLI
httpUrl 与浏览器 OAuth / DCR · 未验收
Dify
MCP Tools 与 DCR · 未验收
n8n
MCP Client 与 MCP OAuth2 credential · 未验收

WorkBuddy

Narrivela 宿主验收：未验收（not tested）。平台官方文档说明配置路径，不证明 Narrivela 已在该客户端完成授权、发现工具或下载。

在连接器管理页添加名为 Narrivela 的自定义远程连接器，按界面要求使用以下 MCP 配置：

{
  "mcpServers": {
    "narrivela": {
      "type": "streamableHttp",
      "url": "https://app.narrivela.com/mcp",
      "timeout": 30000
    }
  }
}

完成浏览器 OAuth，无需 client secret。标准路径要求 S256、一次性授权码、注册响应回显 redirect_uris 并支持刷新。优先回调为 workbuddy://workbuddy/mcp/connector%3A<source>/oauth/callback，客户端也可能回退至 http://127.0.0.1:{动态端口}/oauth/callback；以实际提供并注册的精确地址为准。私有回调的 DCR 注册与 redirect_uris 回显已取得 201 响应，这只验证注册协议，未验证 WorkBuddy 应用内授权或工具调用。

自定义地址不等于 WorkBuddy 市场上架。官方自定义连接器说明 · 官方开发与 OAuth 规范。

Claude Web / Desktop

Narrivela 宿主验收：未验收（not tested）。平台官方文档说明配置路径，不证明 Narrivela 已在该客户端完成授权、发现工具或下载。

  1. 添加远程连接器

    打开 Customize → Connectors → Add → Custom → Web，名称填写 Narrivela，服务地址使用下方 URL。

  2. 选择自动注册

    OAuth client 选择 Register automatically。它采用 DCR，与 Use Claude’s published identity 是不同身份路径；实现 DCR 不等于另一路径已通过。

  3. 授权并查看实际工具

    完成浏览器授权，再检查工具列表与任务流程。Team / Enterprise 可能还需管理员启用自定义连接器。

https://app.narrivela.com/mcp

Claude 自定义连接器由 Anthropic 云访问服务，因此远程服务必须可公开访问；此处不承诺专用播放器或 Claude 目录上架。Claude 官方连接器说明。

Cursor

Narrivela 宿主验收：未验收（not tested）。平台官方文档说明配置路径，不证明 Narrivela 已在该客户端完成授权、发现工具或下载。

在项目 .cursor/mcp.json 或全局 ~/.cursor/mcp.json 添加：

{
  "mcpServers": {
    "narrivela": {
      "url": "https://app.narrivela.com/mcp"
    }
  }
}

启动连接并按 OAuth 提示登录。单独预注册的公共客户端可使用 auth.CLIENT_ID 与 auth.scopes；这里不提供未注册的 Client ID 或密钥。桌面 http://localhost:8787/callback 与 Web / Agents 的 https://www.cursor.com/agents/mcp/oauth/callback 是不同回调路径，应分别注册和验收。Cursor 官方 MCP 文档。

VS Code / Copilot

Narrivela 宿主验收：未验收（not tested）。平台官方文档说明配置路径，不证明 Narrivela 已在该客户端完成授权、发现工具或下载。

运行命令面板的 MCP: Add Server，选择 HTTP 并填写服务地址；也可在 .vscode/mcp.json 使用：

{
  "servers": {
    "narrivela": {
      "type": "http",
      "url": "https://app.narrivela.com/mcp"
    }
  }
}

这里的顶层字段为 servers。启动并信任服务，完成浏览器 OAuth 后，在聊天中启用工具。单独注册的公共客户端可指定 oauth.clientId；Copilot portable 的 .mcp.json 顶层为 mcpServers，不要混用。工作区或管理员策略可能限制自定义 MCP。官方配置参考 · 官方添加服务说明。

Gemini CLI

Narrivela 宿主验收：未验收（not tested）。平台官方文档说明配置路径，不证明 Narrivela 已在该客户端完成授权、发现工具或下载。

添加 HTTP 服务：

gemini mcp add --transport http narrivela https://app.narrivela.com/mcp

或在 .gemini/settings.json 添加：

{
  "mcpServers": {
    "narrivela": {
      "httpUrl": "https://app.narrivela.com/mcp"
    }
  }
}

在 Gemini CLI 会话中运行 /mcp auth narrivela，按浏览器提示授权。HTTP 字段为 httpUrl，不是 SSE 所用的 url。自动发现可使用 DCR；客户端应能打开浏览器并接收 http://localhost:{动态端口}/oauth/callback，并按声明校验授权回调的 iss。无浏览器运行需要单独验证登录路径。Gemini CLI 官方 MCP 文档。

Dify

Narrivela 宿主验收：未验收（not tested）。平台官方文档说明配置路径，不证明 Narrivela 已在该客户端完成授权、发现工具或下载。

在 Integrations → Tools → MCP 添加以下值：

名称
Narrivela
服务 URL
https://app.narrivela.com/mcp
服务标识
narrivela
动态客户端注册
保持 Dynamic Client Registration 开启，并完成 Narrivela 账户授权。

导入工具后用于 Tool / Agent 节点。服务标识会被工作流和导出文件引用，应保持稳定。关闭 DCR 需单独配置固定应用和 Dify 的精确回调，本页不提供该配置。一般 HTTP 支持不证明所用版本的公共客户端 DCR 请求已与 Narrivela 兼容。Dify 官方 Tools 文档。

工作流通过工作区已授权的 Narrivela 身份调用；每位工作流访客不会自动获得独立 Narrivela 账户或新用户额度。

n8n

Narrivela 宿主验收：未验收（not tested）。平台官方文档说明配置路径，不证明 Narrivela 已在该客户端完成授权、发现工具或下载。

普通工作流使用 MCP Client，AI Agent 使用 MCP Client Tool。设置：

传输
所装节点版本提供时，选择 Streamable HTTP。
MCP Endpoint
https://app.narrivela.com/mcp
Authentication
MCP OAuth2 credential
动态注册
保持 Use Dynamic Client Registration 开启。
Resource URL
https://app.narrivela.com/mcp，或由客户端自动发现。
OAuth Redirect URL
使用该 n8n 凭据界面实际展示的精确 URL。

完成浏览器授权，再选择实际工具与参数。旧版只提供 SSE 时，不要把 HTTP 地址当 SSE endpoint；先使用具备 HTTP / MCP OAuth2 能力的版本。MCP Server Trigger 是向外提供 n8n 能力，不是接入 Narrivela 的客户端步骤。MCP Client 官方文档 · MCP Client Tool 官方文档 · MCP OAuth2 凭据文档。

使用该凭据的工作流消耗其 Narrivela 账户额度；共享凭据不创建新用户额度。查询原任务，不要在每次循环或重试中重新提交生成。

不依赖专用播放器的核心工具

成功工具调用的文本内容块与 structuredContent 返回同一个 JSON 对象；错误结果需先读取，不是成功的结构化结果。以下路径不要求 window.openai、专用播放器或原生附件参数。生产 SDK 已无 UI 读取 get_service_capabilities，并完成两段短句的真实生成、查询与下载。长文与大批量的输入、分段、分页等行为有同一服务端实现及隔离 SDK 夹具支持，不能将其写成已完成真实生产大长文或大批量测试。仍以实际发现的工具与当前能力查询为准。

限制与声音
get_service_capabilities 提供输入与附件边界；list_voices 提供实际音色及型号、语言限制。
查看账户额度
get_account_usage 返回当前身份的额度、安全限制和自己的任务。
完整长文本
text_to_speech 接收完整 text，返回后台 job_id；服务在输入限制内自动分段并合成。
有序多段
batch_text_to_speech 接收 items: [{id,text}]；保持唯一 ID 与预期顺序。
进度与分页
get_speech_job 使用 job_id、offset、limit；按 next_offset 继续，直到 null，取完全部片段。
取消与继续
cancel_speech_job / resume_speech_job 操作当前身份自己的任务。继续可能消耗额度，已发生的供应商请求不因此退费。

提交一次，查询同一个任务

  1. 准备完整输入

    在客户端读取获授权的文本文件，或先提取文档文字。查询实际输入限制、声音与额度；语言提示不翻译讲稿。

  2. 提交一个后台任务

    单篇调用 text_to_speech，有序多段调用 batch_text_to_speech；保存返回的 job_id。接受与排队不代表生成完成。

  3. 间隔查询任务

    调用 get_speech_job；有 retry_at 时遵守时间提示，到 completed、failed 或 cancelled 时停止轮询。先读取错误，再有意继续，不要为查进度重新生成。

  4. 取完所有结果页

    用 next_offset 作为下一页 offset，直到 null。下载已完成音频与完整清单或 ZIP。

text_to_speech 参数示例：

{
  "text": "欢迎使用 Narrivela。",
  "language": "zh",
  "output_format": "wav"
}

batch_text_to_speech 参数示例：

{
  "items": [
    {
      "id": "intro",
      "text": "欢迎使用 Narrivela。"
    },
    {
      "id": "ending",
      "text": "感谢收听。"
    }
  ],
  "language": "zh",
  "output_format": "wav"
}

get_speech_job 中的占位符必须替换为实际返回的任务 ID。offset 从 0 开始；示例每页 100，最大每页 1000：

{
  "job_id": "ACTUAL_RETURNED_JOB_ID",
  "offset": 0,
  "limit": 100
}

服务输入、并发限制始终适用，客户端上下文限制也可能更小。公开风格提示不可用。可选语音输出为 WAV / MP3；不承诺无限文本或通用文件上传。

音频、ZIP 和完整清单

完成片段返回 audio_url 用于播放、audio_download_url 用于下载；完成任务返回 bundle_url 用于整组音频与清单的 ZIP，manifest_url 用于完整 JSON 清单。它们是普通 HTTPS 链接；是否内嵌播放器由宿主决定。

使用包含签名查询的完整 URL 并保密；有效链接的持有者可在有效期内获取结果，不要放入公共页面或日志。链接 exp 为访问到期时间，结果 expires_at 为文件保留到期时间。同一登录账户可重新查询仍在保留期内的任务获取新链接；过期或泄露的状态链接不能自行续期。已下载的文件不受服务端到期删除影响。

本地文字与可选界面边界

UTF-8 文本由客户端读取后，以完整 text 提交；JSONL 在本地解析为有序且唯一的 {id,text}。文档先提取可读文字。远程服务无法读取客户端计算机路径；超过工具输入限制时，可使用 网页工作室 并核对它的限制。

show_speech_job 是可选进度和下载卡片；没有卡片的客户端仍可用 get_speech_job 及其链接。submit_speech_file、export_speech_html 的 visuals 与可选原生视频输入需要宿主支持的真实附件。OpenAI 的 openai/fileParams 不会使其他宿主附件自动兼容。不要编造文件 ID、提交本机路径或替换为任意云端 URL；本页不宣称提供通用的服务端 HTML / 视频文件上传路径。

账户与额度边界

工具只操作已授权 Narrivela 身份自己的任务。新用户一次性获得人民币 10 元非现金语音额度，不自动刷新；所有账户同时受全站每 UTC 日历月人民币 1,000 元预算及输入、并发、活跃任务限制。查看当前额度与消耗规则。

Dify / n8n 等共享工作流使用其凭据对应的 Narrivela 身份，工作流每个访客不会获得一份新的免费额度。同一凭据授权的调用也共享该账户的任务访问权限，Narrivela 不会将这些工作流访客自动隔离为独立任务所有者。凭据与私密结果链接不应共享到公开位置，更不能使用运营者的语音供应商密钥。

Registry 与市场状态

MCP Registry：已登记

Narrivela 的 com.narrivela/narrivela 记录已于 2026 年 10 月 14 日（上海时间）发布，版本为 0.6.0；官方记录状态为 active，标为最新版本，远程地址是 https://app.narrivela.com/mcp，传输为 Streamable HTTP。查看官方 Registry 记录。

Registry 登记提供发现元数据，不代表 WorkBuddy、Claude、Cursor、OpenAI 或其他市场审核通过，也不保证搜索收录、排名或 AI 推荐。本页列出的七个宿主的实际连接仍未验收。ChatGPT 公开安装 与 Codex 公开安装 各自维护真实状态。

连接失败时

记录客户端版本、时间与非敏感错误代码，检查 HTTP 传输、浏览器授权、邮箱验证和客户端实际回调。只登录成功不等于语音生成与下载已验收。可通过 支持页面 求助，不要发送密码、令牌、签名下载链接或完整私人讲稿。