连接 Narrivela MCP 服务

开始连接

在支持远程 MCP 和浏览器 OAuth 的客户端中添加 Narrivela。连接后即可让 AI 助手生成单篇或批量配音、查询进度并取得下载地址。

https://app.narrivela.com/mcp

也可以直接在网页工作室试用。使用前登录 Narrivela 并验证邮箱，无需语音供应商 API key。

连接信息

名称: Narrivela
MCP 地址: https://app.narrivela.com/mcp
传输: HTTPS Streamable HTTP
授权: 浏览器 OAuth；使用你自己的 Narrivela 账户并完成邮箱验证
权限: 授权界面可能显示 voxkit:use，这是服务沿用的权限名称。
输入限制: 单任务最多 50,000 UTF-16 code units、1,000 项；以客户端内的 get_service_capabilities 为准。

连接步骤

添加服务
选择远程 HTTP MCP，填写上方地址。以下列出常见客户端的具体入口。
登录账户
让客户端打开浏览器，登录 Narrivela 并验证邮箱。按客户端提示完成授权，无需复制访问令牌。
确认工具
在工具列表找到 get_service_capabilities、text_to_speech 和 batch_text_to_speech，然后提交一段短讲稿试用。

如果客户端要求填写 OAuth 回调地址，使用它显示的精确地址；不要把他人的客户端密钥或访问令牌放进共享配置。

选择客户端

选择正在使用的客户端，查看配置入口和授权步骤。平台界面与工作区权限可能随版本变化。

Codex: 命令行连接
ChatGPT: 自定义 MCP 连接
WorkBuddy: 自定义连接器
Claude Web / Desktop: 自定义 Web 连接器
Cursor: 远程 MCP 配置
VS Code / Copilot: HTTP MCP 服务
Gemini CLI: HTTP 服务与浏览器授权
Dify: MCP 工具
n8n: MCP Client 节点

WorkBuddy

在连接器管理页添加名为 Narrivela 的自定义远程连接器，填入：

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

按浏览器提示完成 Narrivela 账户授权；若要求回调地址，使用 WorkBuddy 当前显示的地址。官方自定义连接器说明。

Claude Web / Desktop

添加远程连接器
打开 Customize → Connectors → Add → Custom → Web，名称填写 Narrivela，服务地址使用下方 URL。
选择自动注册
OAuth client 选择 Register automatically，然后完成浏览器授权。
查看工具
授权后在对话工具列表中启用 Narrivela；Team / Enterprise 工作区可能需要管理员开放自定义连接器。

https://app.narrivela.com/mcp

Claude 官方连接器说明。

Cursor

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

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

启动连接并按浏览器提示授权。Cursor 官方 MCP 文档。

VS Code / Copilot

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

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

启动并信任服务，完成浏览器授权后，在聊天中启用 Narrivela 工具。工作区管理员可能限制自定义 MCP。官方配置参考。

Gemini CLI

添加 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，按浏览器提示授权。Gemini CLI 官方 MCP 文档。

Dify

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

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

导入工具后用于 Tool / Agent 节点。工作流通过该工作区授权的 Narrivela 账户调用和扣额。Dify 官方 Tools 文档。

n8n

普通工作流使用 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。

完成浏览器授权，再选择工具与参数。工作流通过所用凭据对应的 Narrivela 账户调用和扣额。MCP Client 官方文档 · OAuth2 凭据文档。

配音工具

单篇长讲稿可以自动分段并合成音频；整组讲稿可以保留顺序并打包下载。以下是助手接入后最常用的工具。

限制与声音: 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 操作当前身份自己的任务。继续可能消耗额度，已发生的供应商请求不因此退费。

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

准备完整输入
在客户端读取获授权的文本文件，或先提取文档文字。查询实际输入限制、声音与额度；语言提示不翻译讲稿。
提交一个后台任务
单篇调用 text_to_speech，有序多段调用 batch_text_to_speech；保存返回的 job_id。接受与排队不代表生成完成。
间隔查询任务
调用 get_speech_job；有 retry_at 时遵守时间提示，到 completed、failed 或 cancelled 时停止轮询。先读取错误，再有意继续，不要为查进度重新生成。
取完所有结果页
用 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"
}

查询时把任务编号换成提交后返回的 job_id：

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

支持 WAV / MP3；单任务输入和并发限制可用 get_service_capabilities 查看。

保存音频和整组 ZIP

完成片段的 audio_download_url 用于保存音频；完成任务的 bundle_url 提供整组 ZIP，manifest_url 提供完整清单。大批量结果请按 next_offset 分页取完，再下载整组 ZIP。

完成音频通常保留约 24 小时，请在任务显示的到期时间前下载。下载地址带有临时签名；拿到链接的人在有效期内也能访问结果，请勿公开分享。同一账户可在结果保留期内重新查询任务，取得新链接。

使用本地讲稿文件

请让客户端先读取你授权的 UTF-8 文本或从文档中提取文字，再提交给 text_to_speech。批量 JSONL 应解析为按顺序排列的 {id,text} 列表，每项 ID 唯一。远程 MCP 服务不能直接读取你电脑上的本地路径。

部分客户端会展示可选的进度卡片；其余客户端也能使用 get_speech_job 和下载链接完成流程。

账户与额度

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

Dify、n8n 等共享工作流会使用所配置的 Narrivela 账户：请求从该账户扣额，工作流访客共享该账户可访问的任务。请按团队权限管理工作流凭据和私密下载链接。

在 MCP Registry 查找

Narrivela 已收录为 com.narrivela/narrivela；可以查看 Registry 记录，或直接复制本页的 MCP 地址。

首次连接遇到注册错误

少数客户端首次连接时需要注册自己的 OAuth 应用。若出现注册容量错误，请先用网页工作室，并通过支持页面告诉我们客户端名称和错误提示。重连时优先复用客户端已有的注册信息。

连接失败时

先检查是否选择了远程 HTTP MCP、是否完成浏览器授权和邮箱验证。如果登录成功但看不到工具，重新连接并查看客户端或工作区权限；注册容量错误见首次连接说明。求助时请提供客户端名称、版本、发生时间和错误提示，避免发送密码、访问令牌或带签名的下载链接。联系支持。