Kayzen Analytics MCP 서버

Kayzen Analytics API와 상호 작용하기 위한 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 이 패키지를 사용하면 AI 모델이 표준화된 인터페이스를 통해 Kayzen 광고 캠페인 데이터에 액세스하고 분석할 수 있습니다.

특징

• 자동 인증 : 자동 새로 고침 메커니즘을 갖춘 내장 토큰 관리

• 보고서 관리 : Kayzen 분석 보고서에 쉽게 접근

• 오류 처리 : API 상호 작용을 위한 포괄적인 오류 처리

• TypeScript 지원 : 유형 정의를 포함한 전체 TypeScript 구현

• 환경 기반 구성 : 환경 변수를 사용한 간단한 설정

Related MCP server: Marketing Automation MCP Server

설치

지엑스피1

구성

Kayzen 자격 증명으로 .env 파일을 만듭니다.

KAYZEN_USERNAME=your_username
KAYZEN_PASSWORD=your_password
KAYZEN_BASIC_AUTH=your_basic_auth_token
KAYZEN_BASE_URL=https://api.kayzen.io/v1  # Optional, defaults to this value

용법

기본 설정

import { KayzenMCPServer } from '@feedmob-ai/kayzen-mcp';

const server = new KayzenMCPServer();
server.start();

사용 가능한 도구

1. list_reports

Kayzen Analytics에서 사용 가능한 모든 보고서를 나열합니다.

• 입력 : 없음

• 반환 : 다음을 포함하는 보고서 개체 배열:

  • id : 보고서 식별자

  • name : 보고서 이름

  • type : 보고서 유형

const reports = await server.tools.list_reports();

2. get_report_results

특정 보고서에 대한 결과를 검색합니다.

• 입력 :

  • report_id (문자열, 필수): 가져올 보고서의 ID

  • start_date (문자열, 선택 사항): YYYY-MM-DD 형식의 시작 날짜

  • end_date (문자열, 선택 사항): YYYY-MM-DD 형식의 종료 날짜

• 반환 : 보고서 데이터 및 메타데이터

const results = await server.tools.get_report_results({
  report_id: 'report_id',
  start_date: '2024-01-01',  // optional
  end_date: '2024-01-31'     // optional
});

3. analyze_report_results (프롬프트)

보고서 결과를 분석하고 통찰력을 제공합니다.

• 입력 :

  • report_id (문자열): 분석할 보고서의 ID

• 분석에는 다음이 포함됩니다 .

  • 성과 지표

  • 주요 동향

  • 최적화 영역

  • 비정상적인 패턴이나 이상 현상

설정

Claude Desktop과 함께 사용

Claude Desktop과 함께 사용하려면 claude_desktop_config.json 에 다음을 추가하세요.

엔피엑스

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@feedmob-ai/kayzen-mcp"
      ],
      "env": {
        "KAYZEN_USERNAME": "username",
        "KAYZEN_PASSWORD": "pasword",
        "KAYZEN_BASIC_AUTH": "auth token"
      }
    }
  }
}

개발

필수 조건

• Node.js(v16 이상)

• npm(v7 이상)

• Kayzen API 자격 증명

스크립트

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

# Development mode with hot-reload
npm run dev

프로젝트 구조

kayzen-mcp/
├── src/
│   ├── server.ts        # MCP server implementation
│   └── kayzen-client.ts # Kayzen API client
├── dist/               # Compiled JavaScript
└── package.json       # Project configuration

종속성

주요 종속성:

• @modelcontextprotocol/sdk : ^1.7.0

• axios : ^1.8.3

• dotenv : ^16.4.7

• zod : ^3.24.2

오류 처리

서버는 다양한 오류 시나리오를 처리합니다.

• 인증 실패

• 잘못된 API 요청

• 네트워크 문제

• 토큰 만료 및 새로 고침

• 잘못된 매개변수

특허

MIT 라이센스

작가

피드몹