callwright 是什么？

Self-hosted MCP voice agent that places phone calls on your behalf via Retell. callwright 是一个MCP Server，收录自官方 MCP Registry。支持 streamable-http 传输。本页提供产品介绍、配置教程、安装命令与适用场景，可复制到 Cursor、Claude Code、VS Code。

如何安装 callwright？

推荐在 Claude Code（本地）中安装：1. 确保已安装 Claude Code CLI 2. 复制下方命令，将替换为真实环境变量值后，在终端执行 3. 若下方列出了环境变量，请对照填写命令示例：claude mcp add callwright --env RETELL_API_KEY= -- npx -y callwright

callwright 适用于哪些场景？

callwright 可用于需要该MCP Server能力的 AI Agent 工作流，建议结合官方文档与本页安装命令试用。

在 Cursor / Claude Code 中配置 callwright 提示 connection closed 或 exit code 1？

通常由本地运行时环境缺失或命令路径未被 IDE 继承引起。排查步骤： 1. 确认已安装 Node.js 18+（支持 npx）或 Python 3.10+（支持 uvx）； 2. 尝试在终端运行 which npx 或 which uvx，把配置文件中的 "command" 字段改为完整绝对路径； 3. 修改 mcp.json 后，必须完全重载或重启客户端窗口。

提示 spawn npx ENOENT 或 command not found？

这是因为编辑器后台进程未加载完整的终端环境变量（PATH）。解决方案：在全局安装该包（如 npm install -g 包名），或在配置文件中将 command 设置为系统的实际路径（如 Windows 下的 C:\Program Files\nodejs\npx.cmd，Mac 下的 /usr/local/bin/npx）。

提示 Missing required environment variable 或 API 认证失败？

callwright 依赖环境变量（如 RETELL_API_KEY）。请在客户端配置文件的 "env" 对象中填入有效密钥，注意不要包含多余空格或未闭合的双引号。

callwright MCP配置与使用教程

Q: 如何安装 callwright？

推荐在 Claude Code（本地） 中安装：1. 确保已安装 Claude Code CLI 2. 复制下方命令，将 替换为真实环境变量值后，在终端执行 3. 若下方列出了环境变量，请对照填写 命令示例：claude mcp add callwright --env RETELL_API_KEY= -- npx -y callwright

AgentHubMCP · Skill

callwright MCP配置与使用教程 - AgentHub

按平台快速复制

选择你的平台查看安装方式

打开项目根目录下的 .cursor/mcp.json（没有就新建）
点击「复制配置」粘贴进去；若已有其他 MCP，只合并 mcpServers 里的本条目
将 env 中的 <占位符> 替换为真实密钥（见下方「环境变量」）
保存后按 Cmd+Shift+P（Windows：Ctrl+Shift+P）→ 输入 Reload Window 并执行

预填环境变量与密钥（可选）

RETELL_API_KEY

必填secret

MCP_AUTH_TOKEN

secret

PORT

CALLWRIGHT_DATA_DIR

CALLWRIGHT_PUBLIC_URL

CLAUDE_ROUTINE_URL

CLAUDE_ROUTINE_TOKEN

secret

隐私安全承诺：所有参数与密钥仅在您本机的浏览器前端进行实时文本替换，AgentHub 绝不向任何服务器上传或存储您的敏感凭据。

点击「复制配置」直接粘贴到客户端

{
  "mcpServers": {
    "callwright": {
      "command": "npx",
      "args": [
        "-y",
        "callwright"
      ],
      "env": {
        "RETELL_API_KEY": "<RETELL_API_KEY>"
      }
    }
  }
}

配置教程

打开 callwright 详情页，确认这是你需要的 MCP Server（来源官方 MCP Registry）。
按客户端选择 Cursor、Claude Code 或 VS Code，复制 JSON 配置或 CLI 命令。
将配置合并进 mcpServers，并把环境变量占位符替换为真实密钥。
重载窗口后，在 Agent 对话中调用该 MCP 提供的工具。

安装命令

以下安装命令与配置步骤已写入页面 HTML，搜索引擎与未启用 JavaScript 的浏览器均可直接读取。

Claude Code（本地）

确保已安装 Claude Code CLI
复制下方命令，将 <占位符> 替换为真实环境变量值后，在终端执行
若下方列出了环境变量，请对照填写

claude mcp add callwright --env RETELL_API_KEY=<RETELL_API_KEY> -- npx -y callwright

Cursor — .cursor/mcp.json（本地）

打开项目根目录下的 .cursor/mcp.json（没有就新建）
点击「复制配置」粘贴进去；若已有其他 MCP，只合并 mcpServers 里的本条目
将 env 中的 <占位符> 替换为真实密钥（见下方「环境变量」）
保存后按 Cmd+Shift+P（Windows：Ctrl+Shift+P）→ 输入 Reload Window 并执行

{
  "mcpServers": {
    "callwright": {
      "command": "npx",
      "args": [
        "-y",
        "callwright"
      ],
      "env": {
        "RETELL_API_KEY": "<RETELL_API_KEY>"
      }
    }
  }
}

VS Code — .vscode/mcp.json（本地）

统一 Manifest

{
  "id": "com.topness/callwright",
  "type": "mcp-server",
  "version": "1.0.4",
  "displayName": "callwright",
  "description": "Self-hosted MCP voice agent that places phone calls on your behalf via Retell.",
  "repository": {
    "url": "https://github.com/topness/callwright",
    "source": "github"
  },
  "distribution": {
    "packages": [
      {
        "registryType": "npm",
        "identifier": "callwright",
        "version": "1.0.4",
        "transport": "streamable-http",
        "environmentVariables": [
          {
            "name": "RETELL_API_KEY",
            "description": "Your Retell secret API key (stays server-side)",
            "isRequired": true,
            "isSecret": true
          },
          {
            "name": "MCP_AUTH_TOKEN",
            "description": "Bearer token clients must send; required when exposed beyond localhost",
            "isSecret": true
          },
          {
            "name": "PORT",
            "description": "Port the HTTP MCP server listens on (default 8787)"
          },
          {
            "name": "CALLWRIGHT_DATA_DIR",
            "description": "Persistent directory for runtime state such as trigger deduplication"
          },
          {
            "name": "CALLWRIGHT_PUBLIC_URL",
            "description": "Public Callwright base URL used to configure Retell webhook delivery"
          },
          {
            "name": "CLAUDE_ROUTINE_URL",
            "description": "Optional complete Claude cloud Routine /fire endpoint URL"
          },
          {
            "name": "CLAUDE_ROUTINE_TOKEN",
            "description": "Optional dedicated bearer token for the configured Claude Routine trigger",
            "isSecret": true
          }
        ]
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode",
    "trae",
    "cherry-studio",
    "lingma",
    "windsurf",
    "cline",
    "workbuddy"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "com.topness/callwright",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/com.topness%2Fcallwright/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}

{
  "mcpServers": {
    "callwright": {
      "command": "npx",
      "args": [
        "-y",
        "callwright"
      ],
      "env": {
        "RETELL_API_KEY": "<RETELL_API_KEY>"
      }
    }
  }
}

Claude Desktop — claude_desktop_config.json（本地）

打开 Claude Desktop 的 claude_desktop_config.json（路径见远程指引）
点击「复制配置」合并到 mcpServers
将 env 中的 <占位符> 替换为真实密钥
完全退出并重启 Claude Desktop

{
  "mcpServers": {
    "callwright": {
      "command": "npx",
      "args": [
        "-y",
        "callwright"
      ],
      "env": {
        "RETELL_API_KEY": "<RETELL_API_KEY>"
      }
    }
  }
}

Trae — .trae/mcp.json（本地）

打开 Trae → 设置 → MCP，或编辑 .trae/mcp.json / 全局 mcp.json
点击「复制配置」粘贴并合并 mcpServers
将 env 中的 <占位符> 替换为真实密钥
保存后重载 Trae 窗口

{
  "mcpServers": {
    "callwright": {
      "command": "npx",
      "args": [
        "-y",
        "callwright"
      ],
      "env": {
        "RETELL_API_KEY": "<RETELL_API_KEY>"
      }
    }
  }
}

Cherry Studio — MCP 设置（本地）

打开 Cherry Studio → 设置 → MCP 服务器 → 添加（STDIO）
也可直接导入下方 JSON：点击「复制配置」合并到 mcpServers
将 env 中的 <占位符> 替换为真实密钥，并确保本机已安装 Node.js / uv（npx、uvx）
启用服务并查看工具列表是否加载成功

{
  "mcpServers": {
    "callwright": {
      "command": "npx",
      "args": [
        "-y",
        "callwright"
      ],
      "env": {
        "RETELL_API_KEY": "<RETELL_API_KEY>"
      }
    }
  }
}

通义灵码 — MCP 配置（本地）

通义灵码：个人设置 → MCP 服务 → 「+」→ 手工添加（STDIO）或配置文件添加
点击「复制配置」合并 mcpServers；命令/参数/环境变量与 JSON 一致
将 env 中的 <占位符> 替换为真实密钥；本机需 Node.js 18+（npx）或已安装 uv（uvx）
确认服务状态为已连接后再在智能体对话中调用

{
  "mcpServers": {
    "callwright": {
      "command": "npx",
      "args": [
        "-y",
        "callwright"
      ],
      "env": {
        "RETELL_API_KEY": "<RETELL_API_KEY>"
      }
    }
  }
}

Windsurf — mcp_config.json（本地）

编辑 ~/.codeium/windsurf/mcp_config.json
点击「复制配置」合并 mcpServers（本地 stdio 与 Cursor 格式相同）
将 env 中的 <占位符> 替换为真实密钥后保存并刷新 Cascade

{
  "mcpServers": {
    "callwright": {
      "command": "npx",
      "args": [
        "-y",
        "callwright"
      ],
      "env": {
        "RETELL_API_KEY": "<RETELL_API_KEY>"
      }
    }
  }
}

Cline — MCP Servers（本地）

Cline 面板 → 设置 → MCP Servers
点击「复制配置」粘贴并合并
将 env 中的 <占位符> 替换为真实密钥后保存

{
  "mcpServers": {
    "callwright": {
      "command": "npx",
      "args": [
        "-y",
        "callwright"
      ],
      "env": {
        "RETELL_API_KEY": "<RETELL_API_KEY>"
      }
    }
  }
}

WorkBuddy — .workbuddy/mcp.json（本地）

编辑 ~/.workbuddy/mcp.json（用户级）或项目目录 .workbuddy/mcp.json
也可在界面：插件 → MCP 服务器 → 配置 MCP，粘贴下方 JSON
将 env 中的 <占位符> 替换为真实密钥；Windows 下 command/脚本路径建议用绝对路径
保存并重启 WorkBuddy，确认连接器状态为绿色

{
  "mcpServers": {
    "callwright": {
      "command": "npx",
      "args": [
        "-y",
        "callwright"
      ],
      "env": {
        "RETELL_API_KEY": "<RETELL_API_KEY>"
      }
    }
  }
}

callwright MCP配置与使用教程

产品介绍

AgentHub Verified 可用性验证技术测试通过

按平台快速复制

预填环境变量与密钥（可选）

配置教程

常见报错排查与运行避坑 (Troubleshooting)FAQ

免安装模拟调用 (Playground)

选型与决策建议（为什么选它？）

相关资源

MarkItDown MCP Server

飞书文档

高德地图

Bilibili

Puppeteer

Playwright

常搭配使用

polymarket-weather-trader

Tavily Search

API Gateway

Planning with files

继续逛 AgentHub