Roistat MCP 服务器

用于与 Roistat 营销分析平台集成的 MCP (Model Context Protocol) 服务器。它允许 AI 代理（Claude、GPT 等）直接处理 Roistat 数据：分析统计数据、管理潜在客户、跟踪通话和渠道。

功能

📊 分析

工具	描述
`roistat_get_statistics`	营销统计：按渠道/活动划分的访问量、潜在客户、ROI、CPL
`roistat_get_report`	按天/周/月分组的灵活报告

🎯 潜在客户与申请

工具	描述
`roistat_list_leads`	按日期、状态过滤的潜在客户列表
`roistat_get_lead`	特定潜在客户的详细信息
`roistat_update_lead`	更新潜在客户的状态、收入、字段
`roistat_create_lead`	创建新潜在客户（线下转化）

📞 通话跟踪

工具	描述
`roistat_list_calls`	带过滤功能的通话记录
`roistat_get_call`	通话详情：来源、录音、时长
`roistat_list_phones`	虚拟号码列表

📡 广告渠道

工具	描述
`roistat_list_channels`	项目的所有营销渠道
`roistat_get_channel_costs`	指定期间的渠道支出
`roistat_set_channel_costs`	手动上传支出（线下渠道）

⚙️ 项目

工具	描述
`roistat_get_project_info`	项目信息、设置、集成
`roistat_list_events`	转化事件
`roistat_send_event`	手动发送转化事件
`roistat_get_billing`	套餐、余额、使用统计
`roistat_get_mediaplan`	媒体计划：各渠道计划与实际情况对比

安装

要求

Node.js 18+
npm 或 yarn
具有 API 访问权限的 Roistat 账户

步骤

git clone <repo-url>
cd roistat-mcp-server
npm install
npm run build

环境变量

# Обязательные
ROISTAT_API_KEY=ваш_api_ключ        # Профиль → API-ключ
ROISTAT_PROJECT_ID=12345            # Номер проекта (из URL или настроек)

# Опциональные
TRANSPORT=stdio                     # или "http" для удалённого сервера
PORT=3000                           # только при TRANSPORT=http

在哪里找到 API 密钥： Roistat → 设置 → API 密钥 → 复制

运行

stdio（本地，用于 Claude Desktop / Claude Code）

ROISTAT_API_KEY=xxx ROISTAT_PROJECT_ID=12345 node dist/index.js

HTTP（远程部署，VPS/Docker）

TRANSPORT=http PORT=3000 ROISTAT_API_KEY=xxx ROISTAT_PROJECT_ID=12345 node dist/index.js

Claude Desktop 配置

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "roistat": {
      "command": "node",
      "args": ["/path/to/roistat-mcp-server/dist/index.js"],
      "env": {
        "ROISTAT_API_KEY": "ваш_api_ключ",
        "ROISTAT_PROJECT_ID": "12345"
      }
    }
  }
}

HTTP 配置（OpenClaw / 远程 MCP）

{
  "mcpServers": {
    "roistat": {
      "url": "http://your-vps-ip:3000/mcp",
      "type": "streamable-http"
    }
  }
}

Docker 部署（适用于 Hostinger VPS）

FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY dist/ ./dist/
EXPOSE 3000
ENV TRANSPORT=http
CMD ["node", "dist/index.js"]

docker build -t roistat-mcp .
docker run -d -p 3000:3000 \
  -e ROISTAT_API_KEY=xxx \
  -e ROISTAT_PROJECT_ID=12345 \
  roistat-mcp

Claude 请求示例

连接 MCP 后，您可以询问 Claude：

“显示过去 30 天各渠道的 ROI”
“3 月份从 Yandex.Direct 带来了多少潜在客户？”
“查找昨天所有未接来电并为它们创建任务”
“上传今天线下渠道 500 卢布的支出”
“比较 4 月和 3 月所有渠道的 CPL”
“将潜在客户 #12345 的状态更新为 '已支付'，收入 15000 卢布”

项目结构

roistat-mcp-server/
├── src/
│   ├── index.ts              # Точка входа, инициализация сервера
│   ├── services/
│   │   └── roistat-client.ts # HTTP-клиент для Roistat API
│   └── tools/
│       ├── analytics.ts      # Статистика и отчёты
│       ├── leads.ts          # Лиды и заявки
│       ├── calltracking.ts   # Коллтрекинг
│       ├── channels.ts       # Каналы и расходы
│       └── project.ts        # Проект, события, биллинг
├── dist/                     # Скомпилированные файлы
├── package.json
└── tsconfig.json

许可证

MIT

Roistat MCP Server