cognigy-ai-mcp-management-server

Cognigy.AI Management MCP サーバー

Management API を通じて Cognigy.AI のバーチャルエージェントを管理する Model Context Protocol サーバー

これは独立したオープンソースの MCP サーバーであり、Cognigy または NiCE とは提携、承認、支援関係にありません。ご自身の有効な Cognigy.AI アカウントと API キーが必要です。これらは Cognigy の商用ライセンス条件に従って使用してください。「Cognigy」および「Cognigy.AI」は、それぞれの所有者の商標です。

これは何ですか？

cognigy-ai-mcp-management-server は、AI コーディングアシスタント（Claude、Cursor など）を使用して、Cognigy.AI の会話型 AI エージェントをプログラムで構築、設定、テスト、運用できるローカル MCP サーバーです。

Cognigy UI をクリックして操作する代わりに、次のことができます。

• 自然言語を使ってフロー、ノード、インテントを作成・管理する
• NLU のトレーニングと回帰テストを自動的に実行する
• スナップショットとパッケージを環境間でデプロイする
• LLM、Knowledge AI、インテグレーションを設定する

対象ユーザー： Cognigy.AI を基盤として開発する開発者、ソリューションアーキテクト、SI パートナー。

要件

• Node.js 20.0.0 以上
• Cognigy.AI アカウント（API アクセス権が必要。Trial、SaaS、オンプレミスに対応）
• API キー（Cognigy UI の「My Profile → API Keys」から生成）

インストール

# 1. Install the Cognigy REST API client (required peer dependency)
npm install @cognigy/rest-api-client

# 2. Install this MCP server
npm install -g cognigy-ai-mcp-management-server

重要： @cognigy/rest-api-client パッケージには「Cognigy Proprietary License」が適用されます。インストールすることで、Cognigy のライセンス条件に同意したものとみなされます。

設定

実行前に環境変数を設定します。

# Required: Your Cognigy API endpoint
export COGNIGY_BASE_URL=https://api-trial.cognigy.ai

# Required: Your API key (never commit this!)
export COGNIGY_API_KEY=your-api-key-here

# Optional: Default project for operations
export COGNIGY_DEFAULT_PROJECT_ID=your-project-id

一般的なベース URL：

環境	ベース URL
Trial	https://api-trial.cognigy.ai
SaaS EU	https://api-app.cognigy.ai
SaaS US	https://api-app-us.cognigy.ai
Dedicated	https://api-<company>.cognigy.cloud

MCP クライアントの設定

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。

{
  "mcpServers": {
    "cognigy": {
      "command": "npx",
      "args": ["cognigy-ai-mcp-management-server"],
      "env": {
        "COGNIGY_BASE_URL": "https://api-trial.cognigy.ai",
        "COGNIGY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

プロジェクトのルートにある .mcp.json に追加します。

{
  "mcpServers": {
    "cognigy": {
      "command": "npx",
      "args": ["cognigy-ai-mcp-management-server"],
      "env": {
        "COGNIGY_BASE_URL": "https://api-trial.cognigy.ai",
        "COGNIGY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "cognigy": {
      "command": "npx",
      "args": ["cognigy-ai-mcp-management-server"],
      "env": {
        "COGNIGY_BASE_URL": "https://api-trial.cognigy.ai",
        "COGNIGY_API_KEY": "your-api-key-here"
      }
    }
  }
}

利用可能なツール

すべてのツール

このサーバーは、ドメイン別に整理された 132 個の MCP ツールを提供します。

カテゴリ	ツール数	説明
プロジェクトとフロー	5	プロジェクト、フロー、フロー設定、ログの一覧表示
ノード	9	CRUD 操作、検索、移動、AI 出力の生成
インテントと NLU	10	インテントの管理、トレーニング、スコアリング、監査
エンドポイント	2	エンドポイント設定の一覧表示と確認
セッション	2	会話コンテキストの注入／リセット
会話	3	会話、トランスクリプトの取得
プレイブックとテスト	6	プレイブック、回帰テストの実行
スナップショット	9	作成、復元、パッケージ化、差分確認、昇格
パッケージ	7	作成、マージ、アップロード、ダウンロード
接続	5	API 接続の管理（シークレットはマスキングされます）
LLM	7	生成 AI プロバイダーの設定
NLU コネクター	5	外部 NLU（Dialogflow、LUIS など）
ナレッジ AI	21	ストア、ソース、チャンク、コネクター（RAG）
関数	9	カスタムコード関数、インスタンス
拡張機能	6	拡張機能のアップロード、設定、管理
コンタクトプロファイル	11	プロファイルの CRUD、マージ、エクスポート（GDPR）
分析	4	会話、通話、ナレッジの指標
監査	2	監査イベントログ
ハンドオーバー	7	ライブエージェントプロバイダーとサービス
検索	1	組織全体のリソース検索
タスク	2	非同期タスクのステータス追跡

主な機能

• デフォルトで安全： すべての変更を伴うツールは、デフォルトで dryRun: true を使用します
• 非同期処理に対応： 長時間実行される操作は、完了するまでポーリングします
• セキュリティ： API キーはメモリ内にのみ保持され、シークレットは自動的にマスキングされます
• ページネーション： すべての一覧表示操作で limit と skip をサポートします

開発とテスト

ライブ API テスト

# Create .env from template
cp .env.example .env
# Edit .env with your credentials

# Run development server
npm run dev

ビルド

npm run build    # Compile TypeScript
npm test         # Run test suite (49 tests)
npm run lint     # Check code style

型の再生成（任意）

新しい Cognigy API から生成済みの型を更新する必要がある場合：

npm run update:spec   # Download latest OpenAPI spec
npm run gen:types     # Regenerate TypeScript types

重要：依存関係

このパッケージには、ピア依存関係として @cognigy/rest-api-client が必要です。つまり、次のとおりです。

1. 別途インストールする必要があります（上記のインストールを参照）
2. パッケージをインストールすると、Cognigy のライセンス条項に同意したことになります
3. Cognigy のコードをバンドルまたは再配布することはありません

以下については、利用者の責任となります。

• Cognigy の独自ライセンス条項を確認し、同意すること
• Cognigy API を使用する適切な権利を有すること
• API 認証情報を安全に管理すること

Cognigy REST API クライアントは、Cognigy GmbH が保守する公式 SDK であり、「Cognigy Proprietary License」のもとで npm に公開されています。

ライセンス

この MCP サーバーは MIT License のもとで公開されています。詳細は LICENSE を参照してください。

注：MIT ライセンスが適用されるのは、この MCP サーバーのコードのみです。依存関係（特に @cognigy/rest-api-client）には、それぞれ独自のライセンスが適用されます。

コントリビューション

コントリビューションを歓迎します。次の手順に従ってください。

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/amazing-feature）
3. 既存のコードパターン（Zod スキーマ、dryRun フラグなど）に従います
4. 新しいツールにはテストを追加します
5. コミットする前に npm test && npm run build を実行します
6. プルリクエストを送信します

開発ガイドライン

• すべてのツールで Zod による入力検証を行う必要があります
• 変更を伴うツールでは dryRun フラグをサポートする必要があります（デフォルト：true）
• ツールの説明は LLM が理解しやすいものにしてください（1～2 文）
• API キーやシークレットをログに記録したり、公開したりしないでください
• ライブ API の前にモックサーバーでテストしてください

サポート

• 問題報告： GitHub Issues
• Cognigy ドキュメント： docs.cognigy.com
• MCP 仕様： modelcontextprotocol.io

---

Model Context Protocol SDK を使用して構築