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

SEO AI Assistant
ccnn2509
-
security
F
license
-
quality
Provides SEO automation with tools for keyword research, SERP analysis, and competitor analysis through Google Ads API integration, enabling AI assistants to access these capabilities via MCP.
Last updated -
4
JavaScript
Google Ads MCP
cohnen
-
security
A
license
-
quality
A tool that connects Google Ads with Claude AI, allowing users to analyze advertising data through natural language conversations and access campaign information, performance metrics, keyword analytics, and ad management.
Last updated -
60
Python
MIT License
SEO AI Assistant
ayushsinghvi92
-
security
F
license
-
quality
MCP server that enables AI assistants to perform SEO automation tasks including keyword research, SERP analysis, and competitor analysis through Google Ads API integration.
Last updated -
Korea Tourism API MCP Server
harimkang
-
security
A
license
-
quality
Enables AI assistants to access South Korean tourism information via the official Korea Tourism Organization API, providing comprehensive search for attractions, events, food, and accommodations with multilingual support.
Last updated -
5
Python
MIT License

View all related MCP servers

Kayzen Analytics MCP Server