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월 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