MeetStream

MeetStream MCP Server

让 Claude 或任何兼容 MCP 的客户端直接访问 MeetStream 会议机器人 API。 添加一个 URL 并登录后，你的助手即可通过 19 个工具运行完整的机器人生命周期（创建、录制、转录、总结、实时交互、管理日历自动加入）。

https://mcp.meetstream.ai/mcp

MeetStream 托管此服务。你无需在自己的设备上安装或运行任何内容，而且服务始终为最新版本。

快速开始

1. 将 https://mcp.meetstream.ai/mcp 添加到你的 AI 工具。不要添加密钥。
2. 点击 Connect（在 Claude Code 中：运行 /mcp，然后选择 Authenticate）。浏览器会打开 app.meetstream.ai。
3. 登录 MeetStream，然后点击 Allow。MeetStream 会为此连接创建 API 密钥。你不会看到或复制该密钥。
4. 向你的 AI 工具提问：“list my meetstream bots”。如果出现列表或空列表，就表示已连接。

各工具的具体步骤请参阅连接。

使用哪个 URL

URL	用途
https://mcp.meetstream.ai/mcp	所有当前客户端。 Streamable HTTP。回复以服务器发送事件（SSE）的形式流式传输，因此无需单独设置 SSE。
https://mcp.meetstream.ai/sse	仅适用于只支持旧版 HTTP+SSE 传输方式（2024-11-05）的客户端。登录方式和 API 密钥的使用方式相同。

Your AI tool ──HTTPS + OAuth sign-in──► mcp.meetstream.ai ──► api.meetstream.ai

旧 npm 包 @meetstream/mcp（npx @meetstream/mcp）已冻结在 0.3.0 版本，不再维护。它早于当前的 create_bot 默认设置和修复版本。请改用托管 URL。

---

连接

添加 URL，无需密钥。客户端会找到 MeetStream 的登录页面，在浏览器中打开 app.meetstream.ai，然后你点击 Allow。控制面板会为此连接创建一个 API 密钥，命名为 MCP · <app name> · <date> · <number>。要断开连接，请在 API 密钥页面删除该密钥。

这是在浏览器中打开的页面。如果你尚未登录 MeetStream，请先登录，然后就会看到此页面：

页面会显示请求连接的应用名称。如果你不认识该应用，请点击 Cancel。登录链接的有效期为 15 分钟。

Claude Code

claude mcp add --transport http meetstream https://mcp.meetstream.ai/mcp
# then run /mcp in Claude Code and choose Authenticate

Claude（网页版和桌面版）

Customize → Connectors → + → Add custom connector。将其命名为 meetstream，将 URL 设为 https://mcp.meetstream.ai/mcp，OAuth 字段留空，然后点击 Connect。

Cursor

编辑 ~/.cursor/mcp.json（或安装 MeetStream Cursor 插件），然后在 Cursor 设置 → MCP 中点击 meetstream 旁边的 Connect：

{
  "mcpServers": {
    "meetstream": { "url": "https://mcp.meetstream.ai/mcp" }
  }
}

VS Code

编辑 .vscode/mcp.json，然后启动服务，并在 VS Code 提示时登录：

{
  "servers": {
    "meetstream": { "type": "http", "url": "https://mcp.meetstream.ai/mcp" }
  }
}

Windsurf

编辑 ~/.codeium/windsurf/mcp_config.json。Cascade 会在首次使用时提示你登录。如果你的 Windsurf 版本无法完成登录，请使用 API 密钥标头（见下文）：

{
  "mcpServers": {
    "meetstream": { "serverUrl": "https://mcp.meetstream.ai/mcp" }
  }
}

Codex

编辑 ~/.codex/config.toml，然后运行 codex mcp login meetstream：

[mcp_servers.meetstream]
url = "https://mcp.meetstream.ai/mcp"

其他 MCP 客户端

将其指向 https://mcp.meetstream.ai/mcp，作为远程（Streamable HTTP）服务。支持 MCP 授权的客户端会自动完成登录：受保护资源元数据（RFC 9728）、授权服务器元数据（RFC 8414）、动态客户端注册（RFC 7591），以及带 PKCE 的授权码流程。访问令牌的有效期为一小时，并会自动刷新。

或使用 API 密钥

对于不支持 OAuth 的客户端，或用于脚本和 CI，请在 app.meetstream.ai/api-keys 创建密钥，并将其作为标头发送：

{
  "mcpServers": {
    "meetstream": {
      "url": "https://mcp.meetstream.ai/mcp",
      "headers": { "Authorization": "Bearer ms_YOUR_API_KEY" }
    }
  }
}

• Claude Code：claude mcp add --transport http meetstream https://mcp.meetstream.ai/mcp --header "Authorization: Bearer $MEETSTREAM_API_KEY"
• Codex：在 [mcp_servers.meetstream] 块中添加 bearer_token_env_var = "MEETSTREAM_API_KEY"。
• 也可以使用 X-MeetStream-Api-Key: <key>。对于无法设置标头的连接器 UI，可使用 https://mcp.meetstream.ai/mcp?key=<key>。服务不会记录查询字符串，但 URL 中的密钥可能会出现在客户端历史记录中，因此建议优先使用 OAuth 或标头。

较旧的客户端（HTTP+SSE）

/mcp 是主端点，其回复已通过服务器发送事件（text/event-stream）进行流式传输。仅支持较旧的 2024-11-05 HTTP+SSE 传输的客户端，可使用相同的登录或密钥选项连接到 https://mcp.meetstream.ai/sse。流中的第一个事件会指出每个会话的消息端点；密钥不会出现在其中。

检查连接状态

向客户端询问类似 "列出我的 meetstream 机器人" 的问题——如果返回数据（或明确的空列表）而非错误，就说明已连接。

---

然后直接提出请求

"加入我的每日站会：https://meet.google.com/abc-defg-hij，使用 Deepgram 转录并录制，结束后把转录稿发给我。"

"列出我今天的机器人，并给我下午 3 点客户通话的 AI 摘要。"

"在机器人所在的会议中发送“我们会通过电子邮件跟进”，然后向他们展示我们的标志。"

"为我日历中明天的董事会安排一个机器人。"

---

完整功能列表——19 个工具

机器人生命周期

工具	功能说明
create_bot	将机器人发送（或通过 join_at 安排）到 Zoom / Google Meet / Microsoft Teams 会议。默认仅使用音频；启用 record_video 后会开启视频，并以发言人视图录制，除非指定 video_layout: "grid_view"；除非另有要求，否则不会开启逐参与者视频。可配置：转录服务提供商和语言、用于 Webhook 的 callback_url、视频录制、逐参与者音频/视频流、MIA 对话 Agent、登录状态下加入会议（google_login_domain / teams_login_domain，以及可选的 sign_in_email / strict_email，适用于账户中已注册的域名）、通过身份验证加入 Zoom 会议（zoom_zak_url / zoom_obf_url）、自定义属性、数据保留期限、幂等键（安全重试——重复调用会返回原有机器人，不会创建重复机器人）。返回 bot_id 和 transcript_id（设置了服务提供商时）。
list_bots	列出账户中的所有机器人（分页）。
get_bot_status	当前生命周期状态——包括 Joining、InWaitingRoom、InMeeting、Recording、Leaving、Stopped、NotAllowed、Denied、Error、Done 之一。
get_bot_detail	完整的会话元数据：平台、时间、状态时间线、规范的 transcript_id、caption_file（适用于 meeting_captions 服务提供商）以及原始请求载荷。
get_bot_summary	MeetStream 内置的 AI 会议摘要——无需调用外部大模型。
remove_bot	立即让机器人离开正在进行的会议。录制数据会保留。
delete_bot_data	永久删除机器人的音频、视频和转录稿。需要设置 confirm: true——仅在用户明确要求删除数据时调用。此操作不可撤销。

转录

工具	功能
get_transcript	通过 bot_id 获取转录文本。自动通过 /detail → /transcriptions 解析 transcript_id（Webhook 中不会提供）。设置 wait: true 可轮询至结果就绪；设置 raw: true 可获取未经处理的服务商输出。返回的片段格式为 { speaker, transcript, start_time, end_time }。
list_transcriptions	列出某个机器人的所有转录任务，包括服务商、状态和预签名下载 URL（有效期为 1 小时）。
transcribe_audio	使用所选服务商对机器人录制的音频进行（重新）转录；可在会议结束后更换服务商或语言重试。

媒体和会议数据

工具	功能
get_media_urls	获取 audio（1 小时）、video（10 分钟）、audio_streams/video_streams（每位参与者各一条；创建时需启用 separate_audio_streams/separate_video_streams）或 screenshots 的预签名 URL。
get_participants	获取会议中检测到的所有参与者，包括显示名称、全名、状态和流 ID。
get_chats	获取通话期间捕获的会议内聊天消息。
get_speaker_timeline	获取发言人及其发言时间，按发言片段时间线呈现。

实时会议交互

工具	功能
send_chat_message	通过机器人向实时会议发送聊天消息。
send_image	将图片或 GIF 显示为机器人的视频画面。img_url 必须可公开访问（不支持 base64）。

日历

工具	功能
list_calendar_events	获取已连接的 Google Calendar 中的即将发生的事件。（连接日历是一次性设置：使用 OAuth 凭据调用 POST /calendar/create_calendar，通常通过 MeetStream CLI 或控制面板完成。）
schedule_calendar_bot	为指定日历事件安排（action: "schedule"）或移除（"unschedule"）机器人。

参考

工具	功能
webhook_events_guide	返回 Webhook 参考文档，包括信封结构（event 和 bot_event）、两层 bot.stopped 终止模型、状态码和流式服务商注意事项；内容已对照捕获的生产环境投递记录核实。让你的模型在编写任何 Webhook 处理程序代码之前先调用此工具。

---

与直接阅读文档有何不同

每个工具的说明和 webhook_events_guide 都包含经实时验证的事实依据，这些内容已通过真实生产环境中的机器人运行确认，而当前公开 API 文档在以下方面存在错误：

• 每次投递都包含 event，大多数还包含用于标明具体名称的 bot_event。使用 event 进行路由，使用 bot_event 获取详细信息。
• 终止事件分为两层：每次结束都会收到一次 event: "bot.stopped"，而 bot_event 会说明原因（bot.stopped、bot.kicked、bot.notallowed、bot.denied、bot.failed）。大厅超时、拒绝和失败会携带 status_code: 500。请根据 bot_event 进行判断，而不是 bot_status——被踢出和正常退出都会报告为 Stopped。
• 仅支持流式传输的转录服务商（deepgram_streaming、assemblyai_streaming、jigsawstack_streaming、meetstream_streaming、meeting_captions）不会生成会后转录文本，因此不会触发 transcription.processed。但仍会触发 bot.done。对这些服务商，会后获取转录文本的请求会无限期返回 202，因此请为轮询设置上限。
• Webhook 负载中不会包含 transcript_id——get_transcript 会自动为你解析，无需让模型猜测。
• 全面采用安全默认值：每次调用 create_bot 都会为 automatic_leave 设置超时时间，并将 recording_permission_denied_timeout 的下限设为 60（API 会对更低的值返回 400）。

工作原理

服务端不持有自己的 API 密钥：每个请求（或 SSE 会话）都会携带调用方的密钥，或封装该密钥的 OAuth 令牌。未提供凭据的请求会收到 401，其中包含设置说明和一个 WWW-Authenticate 标头，指引 OAuth 客户端进入登录流程。Streamable HTTP 是无状态的，因此服务可以水平扩展，无需共享状态；OAuth 令牌是加密的、自包含的值，因此也不需要令牌数据库。

MeetStream 负责运行该服务；它使用 Go 编写，源代码未公开。此仓库包含用户文档和 MCP Registry 条目（server.json）。如需报告问题，请在此处提交 issue。

故障排查

症状	解决方法
登录页面提示链接已过期	登录链接有效期为 15 分钟。请从客户端重新开始连接
从 mcp.meetstream.ai 收到 401	通过客户端登录（OAuth），或发送 Authorization: Bearer <key> / X-MeetStream-Api-Key——服务端没有自己的密钥
工具调用从 API 收到 401	密钥无效或已撤销（对于 OAuth 连接，以应用名称命名的密钥已被删除）。请重新连接，或前往 app.meetstream.ai/api-keys 生成新密钥
get_transcript 返回 ready: false	会议尚未处理完毕，或者（对于流式提供方）没有会后转录文本——请先检查 get_bot_status
日历工具返回空结果或错误	尚未连接日历——请先通过 CLI 中的 meetstream calendar connect 连接一个日历
客户端仅支持旧版 SSE 传输方式	请使用 https://mcp.meetstream.ai/sse

---

更喜欢使用终端？请查看 MeetStream CLI。文档：docs.meetstream.ai · API 规范：openapi.json · 从 Recall.ai 迁移：@meetstream/migrate

隐私与遥测

托管服务会记录各工具的匿名调用次数，以及每次调用是否成功。它绝不会记录你的 API 密钥、OAuth 令牌、会议 URL、转录文本或任何其他内容。服务端日志仅包含请求路径，绝不包含查询字符串。

MIT © MeetStream.ai