Kayzen Analytics MCP サーバー

Kayzen Analytics APIと連携するためのモデルコンテキストプロトコル（MCP）サーバー実装。このパッケージにより、AIモデルは標準化されたインターフェースを介してKayzen広告キャンペーンデータにアクセスし、分析できるようになります。

特徴

自動認証: 自動更新メカニズムを備えた組み込みトークン管理
レポート管理: Kayzen分析レポートへの簡単なアクセス
エラー処理: APIインタラクションの包括的なエラー処理
TypeScript サポート: 型定義を備えた完全な TypeScript 実装
環境ベースの構成:環境変数を使用した簡単なセットアップ

インストール

npm install @feedmob-ai/kayzen-mcp

構成

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に以下を追加します。

NPX

{
  "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