MCP Konnect

🚀 Kong 侃侃

Kong Konnect は強力な API 管理プラットフォームで、企業が API サービスを管理および監視するのを支援します。このドキュメントでは、Kong Konnect の MCP（モデルコンテキストプロトコル）サーバーを使用して機能を拡張する方法を詳細に説明します。

🚀 クイックスタート

Kong Konnect を使って API サービスを管理するには、まずインストールと設定を行い、その後利用可能なツールを使って操作を行います。

✨ 主な機能

• API サービスの管理と監視が可能です。
• 様々な分析、設定、制御平面のツールが提供されています。
• MCP サーバーを使って機能を拡張できます。

📦 インストール

Kong Konnect CLI のインストール

1. npm を使って Kong Konnect CLI をインストールします。

   npm install -g kong-konnect-cli
   

2. インストールを確認します。

   kong-konnect --version
   

MCP サーバーの起動

インストールが完了したら、MCP サーバーを起動します。

node build/index.js

📚 ドキュメント

設定

プロジェクトのルートディレクトリに config.json ファイルを作成します。

{
  "api_key": "your_kong_api_key",
  "region": "us"
}

利用可能なツール

分析ツール

1. すべてのコントロールプレーンをリストする

kong-konnect list-control-planes

2. サービスの詳細情報を取得する

kong-konnect get-service-details --service-id <SERVICE_ID>

設定ツール

1. すべてのサービスをリストする

kong-konnect list-services

2. 新しいサービスを作成する

kong-konnect create-service --name "New Service" --endpoint "/api/new"

コントロール平面ツール

1. コントロール平面の状態を確認する

kong-konnect check-control-plane-status --plane-id <PLANE_ID>

開発

新しいツールの追加

1. parameters.ts でパラメータを定義します。
2. prompts.ts のドキュメント説明を更新します。
3. operations/ フォルダ内で具体的な操作ロジックを実装します。
4. 新しいツールを tools.ts に登録します。
5. 最後に、index.ts でツールの実行を処理します。

トラブルシューティング

よくある問題

• 接続エラー：API キーが有効か、ネットワーク設定が正しいかを確認します。
• 権限問題：ユーザーが必要なリソースにアクセスするための正しい権限を持っていることを確認します。
• データ損失：入力したパラメータと ID が正しいことを確認します。

💻 使用例

基本的な使用法

例 1: API トラフィックの分析

# すべてのコントロールプレーンをリストする
kong-konnect list-control-planes

# 特定のコントロールプレーン上のサービスリストを取得する
kong-konnect get-services --plane-id <PLANE_ID>

# 特定のサービスのトラフィックを監視する
kong-konnect monitor-service-traffic --service-id <SERVICE_ID>

例 2: 設定管理

# 既存のサービス設定を更新する
kong-konnect update-service-config --service-id <SERVICE_ID> --config '{"timeout": 3000}'

# 不要になったサービスを削除する
kong-konnect delete-service --service-id <SERVICE_ID>

以上の手順に従えば、Kong Konnect の MCP サーバーを使って API リソースをスムーズに管理できます。詳細なヘルプが必要な場合は、公式ドキュメントを参照するか、サポートチームにお問い合わせください。