Brivvy Mcp

Brivvy AI

此代码仓库是 Brivvy AI 集成的公开入口。你可以在此获取 MCP 服务元数据、安装步骤、客户端连接配置文件和发行说明。

实现细节仍为私有。此处的所有内容均可安全公开。

连接信息

• 服务类型： 远程 MCP（Streamable HTTP）。
• 生产环境 URL： https://mcp.brivvy.io。
• 身份验证： OAuth 2.1 风格流程，使用 PKCE。
• 发现： 调用 JSON-RPC 端点前，请先使用以下地址：
  • https://mcp.brivvy.io/.well-known/oauth-protected-resource。
  • https://mcp.brivvy.io/.well-known/oauth-authorization-server。

可用工具

以下工具名称是公开契约。简短说明与托管服务当前提供的功能一致（连接指南、安全说明和常见问题请参阅 MCP 服务）。

类别	工具	功能说明
语音	list_voices	列出工作区中已发布的语音。
语音	get_voice	返回默认语音或所选语音的语气和风格规则。
模板	list_templates	列出保存在工作区中的内容模板。
模板	list_discover_templates	列出 Brivvy 社区目录中的公开模板。
模板	get_template	返回所选模板的完整提示词和说明。

快速开始

Cursor

将 Brivvy 添加为远程 MCP 服务：

{
  "mcpServers": {
    "Brivvy": {
      "url": "https://mcp.brivvy.io"
    }
  }
}

连接一次，然后在客户端提示时，于浏览器中完成 OAuth。

Claude

将 MCP 连接器指向：

• URL： https://mcp.brivvy.io。
• 传输方式： Streamable HTTP。
• 身份验证： OAuth。

Claude 会读取 .well-known 元数据，并引导你完成授权。

工作区范围

你的 Brivvy 账户在使用 MCP 时一次只能使用一个工作区。你在 OAuth 页面上最后选择的工作区会应用于所有 MCP 客户端，直到你重新授权并选择其他工作区。如果你同时运行 Cursor 和 Claude，它们目前不会分别保留各自的工作区选择。

会话与重新连接

你的访问令牌有效期较短。客户端应使用刷新令牌刷新访问令牌。刷新令牌有效期为 90 天（Amazon Cognito）。有效期结束后，请重新连接并完成 OAuth 流程。

故障排查

• POST / 返回 401： OAuth 完成前出现此情况是正常的。客户端应遵循 WWW-Authenticate 提示并完成发现流程。
• 授权后立即断开连接： 检查回调 URL，再试一次，并确认已完成 OAuth 弹窗中的操作。
• 令牌错误： 重新连接以获取新的 Bearer 令牌。请勿重复使用旧的 Web 会话令牌。
• 未列出工具： 你可能尚未授予 MCP 授权，或者工作区访问权限缺失或已过期。
• 工作区不正确： 重新连接，并在 OAuth 页面上选择所需工作区。此选择会应用于账户上的所有 MCP 客户端。

此处包含的内容

• mcp/server.json，注册表元数据。
• mcp/install/，Cursor 和 Claude 配置文件。
• VERSIONING.md，此公开元数据的版本管理方式。
• CHANGELOG.md，发行说明。
• SECURITY.md，问题报告方式。

内部发行和目录工作流仍保留在 Brivvy 私有 MCP 代码仓库中。

联系我们

• 支持：[email protected]。
• 安全：[email protected]。