Vocenya Docs

Vocenya MCP 服务

将 Claude、ChatGPT、Cursor、VS Code 和其他 AI 助手连接到 Vocenya——GH Business Solutions 为小型企业打造的 AI 接待员，以及其开发者文档。

Vocenya 全天候接听电话和网站聊天、预约、收集潜在客户信息、将来电转接给受过培训的人员，并在检查勿拨名单、同意状态和允许拨打时段后发起 AI 外呼。它通过 Streamable HTTP 运行三个远程 Model Context Protocol 服务。无需安装：将客户端指向一个 URL 即可。

完整指南：https://vocenya.com/docs/mcp

服务	URL	身份验证	功能
Vocenya Docs	https://vocenya.com/mcp/docs	无	搜索 Vocenya 开发者文档，并获取包含代码示例的所有 REST 端点。只读。
Vocenya（平台）	https://vocenya.com/mcp/platform	OAuth 或 API 密钥	一个企业账户的通话、潜在客户、预约和聊天；添加潜在客户、排队安排 AI 外呼、更新勿拨名单。
Vocenya Site	https://vocenya.com/mcp/site	无	根据 vocenya.com 解答有关 Vocenya 本身的问题：套餐和价格、产品、行业、地点、指南。只读。

公共服务每个 IP 地址每分钟最多允许 60 个请求。平台服务与 API 密钥共用 REST 请求限额（默认每个密钥每分钟 120 个请求）。

此代码库包含官方 MCP Registry 条目、Claude Code 插件及这些说明。服务由 Vocenya 托管；其代码不在此处。

工具

Vocenya Docs（无需密钥，只读）

工具	功能
search_docs	搜索指南（身份验证、webhook、分页、外呼规则、实时聊天、MCP）和所有 API 端点。
get_doc_page	以 Markdown 格式获取单个文档页面，例如 quickstart、webhooks 或 reference/leads。
list_endpoints	按资源分组列出 REST 端点，包括方法、路径、摘要和所需作用域。
get_endpoint	完整获取单个端点的信息：作用域、参数、请求正文、响应，以及 cURL、Node、PHP 和 Python 代码示例。

Vocenya 平台（OAuth 或 API 密钥）

工具	范围	功能
list_calls	calls:read	AI、GH Live Agent 或团队处理的通话，按时间从新到旧排列。
get_call	calls:read	一通通话及其潜在客户；AI 摘要和转录文本，但账户处于 HIPAA 模式时除外。
list_leads	leads:read	来自通话、聊天和表单的潜在客户。
get_lead	leads:read	一位潜在客户的联系方式、原因、紧急程度和来源。
create_lead	leads:write（AI 回拨还需 outbound:write）	从其他系统添加潜在客户；可选择让 AI 回拨。
list_bookings	bookings:read	AI 在企业日历中预订的预约。
list_chats	chats:read	网站在线聊天对话。
queue_outbound_call	outbound:write	请求 AI 致电已同意接听的人。系统会先进行合规检查；拒绝请求时会返回原因。
add_do_not_call	dnc:write	将号码添加到企业的谢绝来电名单。

每个工具都会检查自身所需的范围（API 密钥的范围，或所有者通过 OAuth 连接时批准的范围），因此只有 leads:read 权限的密钥可以读取潜在客户，但不能安排呼叫。测试密钥（vk_test_...）使用独立的示例数据，不会拨打任何人的电话。处于 HIPAA 模式的账户不会通过 MCP 返回转录文本、AI 摘要或聊天消息。

Vocenya 网站（无需密钥，只读）

get_pricing、get_service、search_industries、get_industry、list_locations、search_articles、get_article，以及资源 vocenya://llms.txt。

身份验证

• 文档和网站： 无需身份验证。
• 平台，OAuth（无需密钥）： 通过 OAuth 登录的客户端（Claude Code、Claude 连接器、ChatGPT 开发者模式等）只需提供 URL。客户端会自行注册，然后账户所有者登录 Vocenya，并选择账户、实时或测试数据以及权限（与 API 密钥使用相同的范围）。所有者可在 Developers 页面查看并断开已连接的应用：https://vocenya.com/app/developers。服务端支持采用 PKCE（S256）的 OAuth 2.1 授权码模式，以及动态客户端注册。
• 平台，API 密钥： Authorization: Bearer vk_live_...（测试数据使用 vk_test_...）。账户所有者在同一个 Developers 页面创建密钥，每个密钥都有自己的范围。请将密钥保存在环境变量中；切勿粘贴到聊天中或提交到代码库。

连接

Claude Code

# Docs (no key)
claude mcp add --transport http vocenya-docs https://vocenya.com/mcp/docs

# Platform with OAuth (Claude Code opens the Vocenya sign-in)
claude mcp add --transport http vocenya https://vocenya.com/mcp/platform

# Or platform with an API key in an environment variable
claude mcp add --transport http vocenya https://vocenya.com/mcp/platform \
  --header "Authorization: Bearer $VOCENYA_API_KEY"

也可以从此代码库安装插件，它会添加文档服务和两项技能（REST API 与 Webhook、网站在线聊天安装）：

claude plugin marketplace add gadyamedia/vocenya-mcp
claude plugin install vocenya@vocenya

Claude Desktop 和 claude.ai

文档服务：依次打开 Settings > Connectors > Add custom connector，URL 为 https://vocenya.com/mcp/docs，无需身份验证。

平台服务：添加自定义连接器，URL 为 https://vocenya.com/mcp/platform，然后使用 Vocenya 所有者账户登录（OAuth）。

或者，使用 API 密钥，通过 claude_desktop_config.json 中的 mcp-remote 桥接程序连接：

{
    "mcpServers": {
        "vocenya": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://vocenya.com/mcp/platform",
                "--header",
                "Authorization:${VOCENYA_AUTH}"
            ],
            "env": {
                "VOCENYA_AUTH": "Bearer paste-your-key-here"
            }
        }
    }
}

Cursor

~/.cursor/mcp.json：

{
    "mcpServers": {
        "vocenya-docs": { "url": "https://vocenya.com/mcp/docs" },
        "vocenya": {
            "url": "https://vocenya.com/mcp/platform",
            "headers": { "Authorization": "Bearer ${env:VOCENYA_API_KEY}" }
        }
    }
}

VS Code

.vscode/mcp.json（VS Code 会提示输入密钥一次，并安全地保存密钥）：

{
    "inputs": [
        {
            "type": "promptString",
            "id": "vocenya-key",
            "description": "Vocenya API key (vk_live_... or vk_test_...)",
            "password": true
        }
    ],
    "servers": {
        "vocenya-docs": {
            "type": "http",
            "url": "https://vocenya.com/mcp/docs"
        },
        "vocenya": {
            "type": "http",
            "url": "https://vocenya.com/mcp/platform",
            "headers": { "Authorization": "Bearer ${input:vocenya-key}" }
        }
    }
}

ChatGPT

开启开发者模式，然后添加自定义连接器，URL 为 https://vocenya.com/mcp/docs，无需身份验证。若要访问账户数据，请添加 https://vocenya.com/mcp/platform，使用 OAuth 并以 Vocenya 所有者账户登录。

Grok 和 Grok Bot

在 Grok Business 和 Enterprise 上，将 https://vocenya.com/mcp/platform 添加为自定义 MCP 连接器（“Bring your own MCP”），并使用 OAuth 登录；也可以仅使用具有读取权限范围的 API 密钥。plugins/vocenya-grok 文件夹将两个服务与每日前台审核技能打包在一起，供 Grok Bot 使用：该技能会总结通话、聊天和潜在客户信息，并起草后续跟进内容；未经批准，绝不会联系客户。

其他客户端

任何支持 Streamable HTTP 的客户端均可使用。对于平台服务，请使用 OAuth 登录，或发送 Authorization: Bearer <your key>。

示例提示词

• “使用 Vocenya 文档，告诉我如何验证 webhook 签名。请给出 Node 代码。”
• “创建潜在客户需要什么权限范围？请求正文是什么样的？”
• “显示本周我的 AI 接待员记录的潜在客户。”（平台）
• “AI 预约员为下周一预约了哪些时段？”（平台）
• “VTHOOK 多少钱？每个套餐包含多少 AI 通话分钟数？”（网站）

官方 MCP Registry

registry/ 中的文件是发布到官方 MCP Registry 的条目，命名空间为 com.vocenya（com.vocenya/docs、com.vocenya/platform、com.vocenya/site）。

链接

• MCP 指南：https://vocenya.com/docs/mcp
• 开发者文档：https://vocenya.com/docs
• API 参考：https://vocenya.com/docs/reference（OpenAPI：https://vocenya.com/docs/api.json）
• 测试模式：https://vocenya.com/docs/test-mode
• 面向大模型的文档：https://vocenya.com/docs/llms.txt 和 https://vocenya.com/docs/llms-full.txt
• 定价：https://vocenya.com/pricing
• 隐私：https://vocenya.com/privacy · 条款：https://vocenya.com/terms

隐私

文档和网站服务均为只读，无法查看任何客户账户。平台服务只能查看 API 密钥所属的那个企业账户（或所有者通过 OAuth 连接时选择的账户），且只能查看经批准的权限范围所允许的内容。HIPAA 模式是一项付费附加服务，需要签署 BAA；连接 AI 客户端并不意味着该客户端受 BAA 保障，因此只能向与你另有协议的 AI 工具发送患者数据。完整政策：https://vocenya.com/privacy

支持、安全和许可证

• 问题和更正：提交 issue，或发送邮件至 [email protected]
• 安全问题报告：参见 SECURITY.md
• 许可证：本仓库内容采用 MIT 许可证。Vોકેnya 服务本身是托管式商业产品，受 V જenya 条款 约束。

Copyright (c) 2026 DRAKB LLC dba GH Business Solutions.