# 安装 SOAPNoteAPI

- 类型: MCP 工具
- 说明: 将诊疗录音或转写快速生成SOAP病历、计费编码与就诊摘要。
- 仓库: https://github.com/soapnoteaicom/soapnoteapi-mcp
- ⚠ 安全: 该 MCP 工具来自官方 Registry 且开源，来源可信度对风险有明显下拉作用；但其功能涉及处理临床转录/音频并需要 API 密钥，存在常规的敏感数据处理与凭证使用注意事项。材料未给出远程端点与详细权限范围，当前更适合评为以谨慎为主而非高风险。

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "SOAPNoteAPI" MCP 服务：
执行：claude mcp add com-soapnoteapi-soapnoteapi-mcp -- npx -y soapnoteapi-mcp
```

### Codex
```
请帮我安装 askskill 上的 "SOAPNoteAPI" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.com-soapnoteapi-soapnoteapi-mcp]
command = "npx"
args = ["-y","soapnoteapi-mcp"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "SOAPNoteAPI" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"com-soapnoteapi-soapnoteapi-mcp": { "command": "npx", "args": ["-y","soapnoteapi-mcp"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --env SOAPNOTEAPI_KEY=YOUR_VALUE --transport stdio com-soapnoteapi-soapnoteapi-mcp -- npx -y soapnoteapi-mcp
```
需要环境变量：SOAPNOTEAPI_KEY

### Codex
```bash
codex mcp add --env SOAPNOTEAPI_KEY=YOUR_VALUE com-soapnoteapi-soapnoteapi-mcp -- npx -y soapnoteapi-mcp
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.com-soapnoteapi-soapnoteapi-mcp]
command = "npx"
args = ["-y","soapnoteapi-mcp"]

[mcp_servers.com-soapnoteapi-soapnoteapi-mcp.env]
SOAPNOTEAPI_KEY = "YOUR_VALUE"
```
需要环境变量：SOAPNOTEAPI_KEY

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "com-soapnoteapi-soapnoteapi-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "soapnoteapi-mcp"
      ],
      "env": {
        "SOAPNOTEAPI_KEY": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=com-soapnoteapi-soapnoteapi-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsInNvYXBub3RlYXBpLW1jcCJdLCJlbnYiOnsiU09BUE5PVEVBUElfS0VZIjoiWU9VUl9WQUxVRSJ9fQ
需要环境变量：SOAPNOTEAPI_KEY