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

작가

피드몹

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

자동화된 인증 및 보고서 관리와 같은 기능을 갖춘 표준화된 인터페이스를 통해 AI 모델이 Kayzen 광고 캠페인 데이터에 액세스하고 분석할 수 있도록 하는 구현입니다.

Related MCP Servers

Audiense Insights MCP Serverofficial
AudienseCo
A
security
A
license
A
quality
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
Last updated -
8
6
14
TypeScript
Apache 2.0
Deep Research MCP Server
Ozamatash
-
security
A
license
-
quality
Enables iterative deep research by integrating AI agents with search engines, web scraping, and large language models for efficient data gathering and comprehensive reporting.
Last updated -
9
249
TypeScript
MIT License
Ads Manager MCP Server
amekala
-
security
F
license
-
quality
Enables users to analyze, manage, and optimize digital advertising campaigns through natural language conversations in Claude, offering performance insights, interactive visualizations, and campaign management for platforms like Amazon Ads.
Last updated -
4
JavaScript
Plausible MCP Server
AVIMBU
-
security
F
license
-
quality
Allows AI models to query and retrieve analytics data from Plausible Analytics through the Plausible API, enabling natural language interactions with website statistics.
Last updated -
TypeScript

View all related MCP servers

Kayzen Analytics MCP Server