Kong Konnect

🚀 Kong Konnect MCP サーバー

Kong Konnect は、API とマイクロサービスを管理するための強力なプラットフォームです。MCP（管理制御平面）プロトコルを通じて、Kong Konnect と簡単にやり取りし、様々な操作を実行できます。このドキュメントでは、Kong Konnect MCP サーバーの使用方法に関する詳細なガイドを提供します。

🚀 クイックスタート

📦 インストール

MCP サーバーのインストール

Kong Konnect MCP サーバーを使用するには、以下の手順でインストールします。

1. Kong Konnect のコードリポジトリをクローンします。

   git clone https://github.com/kong/konnect.git
   cd konnect
   

2. 依存関係をインストールし、プロジェクトをビルドします。

   make build
   

3. MCP サーバーを起動します。

   ./bin/konnect-mcp serve --config config.yaml
   

MCP サーバーの設定

config.yaml ファイルでは、以下のパラメータを設定できます。

• API Key: Kong Konnect API のアクセスキーです。
• Region: 使用する Kong Konnect のリージョン（例：us, eu）です。
• Endpoints: Kong Konnect の API エンドポイントの URL です。

設定例は以下の通りです。

api_key: your_api_key_here
region: us
endpoints:
  - https://api.konghq.com/v1

💻 使用例

基本的な使用法

MCP サーバーがサポートする基本的なコマンドは以下の通りです。

• すべての制御平面をリストする：

  konnect-mcp list-control-planes
  

• 特定の制御平面の情報を取得する：

  konnect-mcp get-control-plane <control_plane_id>
  

• 新しい制御平面グループを作成する：

  konnect-mcp create-group --name my_new_group
  

高度な使用法

API トラフィックの分析

MCP サーバーを使用して、特定のサービスのトラフィック状況を分析できます。例えば：

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

   konnect-mcp list-services <control_plane_id>
   

2. 特定の期間内のリクエストログを取得する：

   konnect-mcp get-requests --service-id <service_id> --start-time "2023-10-01T00:00:00Z" --end-time "2023-10-02T23:59:59Z"
   

消費者の管理

MCP サーバーを通じて、消費者の権限とポリシーを管理することもできます。例えば：

1. すべての消費者をリストする：

   konnect-mcp list-consumers <control_plane_id>
   

2. 消費者の API アクセス権限を更新する：

   konnect-mcp update-consumer <consumer_id> --add-permission "/my_api/*"
   

Claude との統合

Claude Desktop のインストール

1. Claude Desktop をダウンロードしてインストールします。

2. 設定ファイルを開きます。

   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. Kong Konnect MCP サーバーの設定を追加します。

   {
     "mcpServers": {
       "kong-konnect": {
         "command": "node",
         "args": [
           "/absolute/path/to/mcp-konnect/build/index.js"
         ],
         "env": {
           "KONNECT_ACCESS_TOKEN": "your_api_key_here",
           "KONNECT_REGION": "us"
         }
       }
     }
   }
   

4. Claude Desktop を再起動して設定を適用します。

よくある質問

API Key を取得する方法は？

Kong Konnect コンソールにアクセスし、Settings > API Keys の部分で新しい API Key を生成してください。

接続問題を解決する方法は？

Kong Konnect インスタンスが正常に動作していること、およびネットワーク接続がブロックされていないことを確認してください。また、ログファイルを確認して詳細な情報を取得することもできます。

journalctl -u konnect-mcp.service --since "10 minutes ago"

サンプルコード

カスタムプラグインの作成

以下は、簡単な Node.js プラグインの例です。

const { MCPClient } = require('kong-konnect');

async function main() {
  const client = new MCPClient({
    apiKey: 'your_api_key_here',
    region: 'us'
  });

  // すべての制御平面グループを取得する
  const groups = await client.listGroups();
  console.log(groups);
}

main().catch(console.error);

まとめ

このドキュメントを通じて、Kong Konnect MCP サーバーを使用して様々な操作を行うことができるようになるはずです。さらなる支援が必要な場合は、Kong Konnect ドキュメント を参照するか、サポートチームにお問い合わせください。