Roistat MCP Server

マーケティング分析プラットフォーム 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月のCPLを3月と全チャネルで比較して」
「リード #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

Roistat MCP Server

機能

📊 分析

🎯 リードと申し込み

📞 コールトラッキング

📡 広告チャネル

⚙️ プロジェクト

インストール

要件

手順

環境変数

起動

stdio (ローカル、Claude Desktop / Claude Code用)

HTTP (リモートデプロイ、VPS/Docker)

Claude Desktopの設定

HTTP用設定 (OpenClaw / リモートMCP)

Dockerデプロイ (Hostinger VPS用)

Claudeへのリクエスト例

プロジェクト構造

ライセンス

Resources

Related MCP Connectors