内容
# Zappaz MCP 服务器
Zappaz MCP 服务器连接 MCP 工具到 Zappaz WhatsApp API。它提供了使用 sessionId 和会话令牌的发送和管理消息（文本、图像、视频、音频、文档、联系人、位置）的工具。
### 使用场景
- 通过 MCP 代理发送 WhatsApp 消息。
- 使用多媒体（图像、视频、音频、文档）自动执行服务。
- 分享联系人和位置。
- 按 ID 删除消息。
---
## Zappaz MCP 服务器（远程）
服务器是远程的，位于 `https://mcp.zappaz.io`。
---
## 身份验证
所有调用都需要：
- 查询字符串中的 `sessionId`（`?sessionId=...`）
- 头部中的 `Authorization`
没有这些值，服务器将返回错误。
---
## OpenCode 配置
在 OpenCode 的 `opencode.json` 中添加服务器：
```json
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"zappaz-mcp": {
"type": "remote",
"enabled": true,
"url": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
"headers": {
"Authorization": "YOUR_SESSION_TOKEN"
}
}
}
}
```
## Cursor 配置
创建 `.cursor/mcp.json` 文件，并添加以下内容：
```json
{
"mcpServers": {
"zappaz-mcp": {
"type": "remote",
"enabled": true,
"url": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
"headers": {
"Authorization": "YOUR_SESSION_TOKEN"
}
}
}
}
```
## Antigravity 配置
在 Agent 面板中，点击右上角的三个点，选择 MCP 服务器。点击管理 MCP 服务器。选择“查看原始配置”并添加：
```json
{
"mcpServers": {
"zappaz-mcp": {
"type": "remote",
"enabled": true,
"serverUrl": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
"headers": {
"Authorization": "YOUR_SESSION_TOKEN"
}
}
}
}
```
## VS Code 配置
打开命令面板（Cmd+Shift+P）并输入“MCP：添加服务器”。选择“添加 MCP 服务器”。选择 HTTP 以添加远程 MCP。输入 URL `https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION` 和名称 `zappaz-mcp`。
然后，编辑 `mcp.json` 以添加授权头：
```json
{
"servers": {
"zappaz-mcp": {
"type": "remote",
"enabled": true,
"url": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
"headers": {
"Authorization": "YOUR_SESSION_TOKEN"
}
}
}
}
```
## Claude Desktop 配置
在 MCP 配置文件中添加服务器：
```json
{
"servers": {
"zappaz-mcp": {
"type": "remote",
"enabled": true,
"url": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
"headers": {
"Authorization": "YOUR_SESSION_TOKEN"
}
}
}
}
```
## Claude Code 配置
在 MCP 配置文件中添加服务器：
```json
{
"servers": {
"zappaz-mcp": {
"type": "remote",
"enabled": true,
"url": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
"headers": {
"Authorization": "YOUR_SESSION_TOKEN"
}
}
}
}
```
## Windsurf 配置
在 MCP 配置文件中添加服务器：
```json
{
"servers": {
"zappaz-mcp": {
"type": "remote",
"enabled": true,
"url": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
"headers": {
"Authorization": "YOUR_SESSION_TOKEN"
}
}
}
}
```
---
## 可用工具
### 消息工具
| 工具 | 描述 |
| --- | --- |
| `send_text_message` | 发送文本消息。 |
| `send_image_message` | 发送图像消息。 |
| `send_video_message` | 发送视频消息。 |
| `send_audio_message` | 发送音频消息。 |
| `send_document_message` | 发送文档消息。 |
| `send_contact_message` | 发送联系人消息。 |
| `send_location_message` | 发送位置消息。 |
| `delete_message` | 按 ID 删除消息。 |
### 群组工具
| 工具 | 描述 |
| --- | --- |
| `list_groups` | 列出会话中的所有群组。 |
| `get_group_participants` | 列出群组的参与者。 |
| `create_group` | 创建新群组。 |
| `add_participants` | 将参与者添加到群组。 |
| `remove_participants` | 从群组中删除参与者。 |
| `promote_participants` | 将参与者提升为管理员。 |
| `demote_participants` | 将管理员降级为成员。 |
| `send_group_invite_link` | 发送群组邀请链接。 |
| `update_group` | 更新群组名称、描述和设置。 |
| `update_group_picture` | 更新群组图片。 |
### Webhook 工具
| 工具 | 描述 |
| --- | --- |
| `get_webhooks` | 获取会话的 Webhook 列表。 |
| `create_webhook` | 为会话创建新的 Webhook。 |
| `update_webhook` | 更新会话的现有 Webhook。 |
| `delete_webhook` | 删除会话的现有 Webhook。 |
---
## 注意事项
- 令牌和 sessionId 对所有调用都是必需的。
