Kayzen Analytics MCP 서버

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

특징

자동 인증 : 자동 새로 고침 메커니즘을 갖춘 내장 토큰 관리
보고서 관리 : Kayzen 분석 보고서에 쉽게 접근
오류 처리 : API 상호 작용을 위한 포괄적인 오류 처리
TypeScript 지원 : 유형 정의를 포함한 전체 TypeScript 구현
환경 기반 구성 : 환경 변수를 사용한 간단한 설정

설치

지엑스피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 라이센스

작가

피드몹

Kayzen Analytics MCP Server

Integrations

Kayzen Analytics MCP 서버

특징

설치

구성

용법

기본 설정

사용 가능한 도구

1. `list_reports`

2. `get_report_results`

3. `analyze_report_results` (프롬프트)

설정

Claude Desktop과 함께 사용

엔피엑스

개발

필수 조건

스크립트

프로젝트 구조

종속성

오류 처리

특허

작가

Integrations

Kayzen Analytics MCP 서버

특징

설치

구성

용법

기본 설정

사용 가능한 도구

1. list_reports

2. get_report_results

3. analyze_report_results (프롬프트)

설정

Claude Desktop과 함께 사용

엔피엑스

개발

필수 조건

스크립트

프로젝트 구조

종속성

오류 처리

특허

작가

1. `list_reports`

2. `get_report_results`

3. `analyze_report_results` (프롬프트)