voicemode-connect

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

VoiceMode Connect

Voice conversations through the voicemode.dev cloud platform. Connect your AI assistant to voice clients (iOS app, web app) without running local STT/TTS services.

通过voicemode.dev云平台实现语音对话。无需运行本地STT/TTS服务，即可将你的AI助手连接到语音客户端（iOS应用、网页应用）。

How It Works

工作原理

Agents (Claude Code, claude.ai) connect via MCP to voicemode.dev. Clients (iOS app, web app) connect via WebSocket. The platform routes voice messages between them.

Agents（Claude Code、claude.ai）通过MCP连接到voicemode.dev。 Clients（iOS应用、网页应用）通过WebSocket连接。平台负责在两者之间转发语音消息。

Quick Setup

快速设置

1. Add the MCP Server

1. 添加MCP服务器

Add to your Claude Code MCP settings (

~/.claude/settings.json

json

{
  "mcpServers": {
    "voicemode-dev": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://voicemode.dev/mcp"]
    }
  }
}

将以下内容添加到你的Claude Code MCP设置文件（

~/.claude/settings.json

）中：

json

{
  "mcpServers": {
    "voicemode-dev": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://voicemode.dev/mcp"]
    }
  }
}

2. Authenticate

2. 身份验证

When you first use a Connect tool, Claude Code will prompt for OAuth authentication. Sign in with your voicemode.dev account.

当你首次使用Connect工具时，Claude Code会提示进行OAuth身份验证。使用你的voicemode.dev账号登录。

3. Connect a Client

3. 连接客户端

Open the iOS app or web dashboard (voicemode.dev/dashboard) and sign in with the same account.

打开iOS应用或网页控制台（voicemode.dev/dashboard），使用同一个账号登录。

4. Start Talking

4. 开始对话

Use the

status

tool to see connected devices, then use

converse

to have a voice conversation.

使用

status

工具查看已连接的设备，然后使用

converse

工具进行语音对话。

MCP Tools

MCP工具

Tool	Description
`status`	Show connected devices and agents
`converse`	Two-way voice conversation via connected client

工具	描述
`status`	显示已连接的设备和Agents
`converse`	通过已连接的客户端进行双向语音对话

Relationship to Local VoiceMode

与本地VoiceMode的关系

Feature	Local VoiceMode	VoiceMode Connect
STT/TTS	Local (Whisper/Kokoro)	Client device (phone/browser)
Setup	Install services	Just add MCP server
Internet	Optional	Required
Latency	Lower	Higher
Mobile voice	No	Yes

Use both: Local VoiceMode for desktop voice, Connect for mobile voice.

功能	本地VoiceMode	VoiceMode Connect
STT/TTS	本地（Whisper/Kokoro）	客户端设备（手机/浏览器）
设置	安装服务	仅需添加MCP服务器
网络	可选	必需
延迟	较低	较高
移动语音	不支持	支持

同时使用两者：本地VoiceMode用于桌面端语音，Connect用于移动端语音。

Documentation

文档

Overview - What is VoiceMode Connect
Architecture - How agents and clients connect
Claude Code Setup - Detailed setup guide
MCP Tools Reference - Tool parameters

概述 - VoiceMode Connect是什么
架构 - Agents和客户端的连接方式
Claude Code设置 - 详细设置指南
MCP工具参考 - 工具参数

Open Questions

待解决问题

How do multiple agents on the same account interact?
What happens when multiple clients are connected?
How is the target device selected for
```
converse
```
?

These are documented in docs/connect/ as we learn more.

同一账号下的多个Agents如何交互？
当多个客户端连接时会发生什么？
如何为
```
converse
```
选择目标设备？这些问题将在我们进一步研究后记录在docs/connect/中。