Kayzen Analytics MCP サーバー

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

特徴

• 自動認証: 自動更新メカニズムを備えた組み込みトークン管理

• レポート管理: Kayzen分析レポートへの簡単なアクセス

• エラー処理: APIインタラクションの包括的なエラー処理

• TypeScript サポート: 型定義を備えた完全な TypeScript 実装

• 環境ベースの構成:環境変数を使用した簡単なセットアップ

インストール

構成

Kayzen の資格情報を使用して.envファイルを作成します。

使用法

基本設定

利用可能なツール

1. list_reports

Kayzen Analytics から利用可能なすべてのレポートを一覧表示します。

• 入力: なし

• 戻り値: 次のものを含むレポート オブジェクトの配列:

  • id : レポート識別子

  • name : レポート名

  • type : レポートタイプ

2. get_report_results

特定のレポートの結果を取得します。

• 入力:

  • report_id (文字列、必須): 取得するレポートのID

  • start_date (文字列、オプション): 開始日（YYYY-MM-DD形式）

  • end_date (文字列、オプション): 終了日（YYYY-MM-DD形式）

• 戻り値: レポートデータとメタデータ

3. analyze_report_results (プロンプト)

レポート結果を分析し、洞察を提供します。

• 入力:

  • report_id (文字列): 分析するレポートのID

• 分析には以下が含まれます:

  • パフォーマンス指標

  • 主な傾向

  • 最適化の領域

  • 異常なパターンや異常

設定

Claude Desktopでの使用

Claude Desktop でこれを使用するには、 claude_desktop_config.jsonに以下を追加します。

NPX

発達

前提条件

• Node.js (v16 以上)

• npm (v7以上)

• Kayzen API 認証情報

スクリプト

プロジェクト構造

依存関係

主な依存関係:

• @modelcontextprotocol/sdk : ^1.7.0

• axios :^1.8.3

• dotenv :^16.4.7

• zod :^3.24.2

エラー処理

サーバーはさまざまなエラー シナリオを処理します。

• 認証失敗

• 無効なAPIリクエスト

• ネットワークの問題

• トークンの有効期限と更新

• 無効なパラメータ

ライセンス

MITライセンス

著者

フィードモブ