Kanzi AI ツールの使用

Kanzi は、情報の検索、Kanzi のコンセプトと API の理解、および問題の迅速な解決に役立つ AI ツールを提供しています:

  • Ask Kanzi は、https://docs.kanzi.com の Documentation に組み込まれた AI アシスタントで、追加のセットアップは不要です。ドキュメントの任意のページの右上にある Ask Kanzi ボタンをクリックするだけで開くことができます。

  • MCP サーバー は、Claude Code、VS Code、Cursor などの独自の AI コーディングエージェントを、同じ基盤となる Documentation および API リファレンスと、お使いの Kanzi Account に接続します。エディタやエージェントの中から Kanzi について問い合わせたり、Kanzi のライセンスやアカウントを管理したりしたい場合に便利です。

クイックセットアップ

独自の AI コーディングエージェントから Kanzi を使用する最も簡単な方法は、エージェント自身にセットアップを行わせることです。エージェントは、URL を取得できることに加えて、お使いのマシン上でファイルを編集し、コマンドを実行できる必要があります。以下をエージェントに貼り付けてください:

Fetch https://docs.kanzi.com/agent-setup/prompt.md and follow it.

エージェントが手順を読み取り、Kanzi MCP サーバーを登録します。エージェントがユーザースコープの MCP 設定にサーバーエントリを書き込み、セットアップコマンドを直接実行するため、手動で設定する必要はありません。ドキュメントサーバーと API サーバーはすぐに使用できます。Portal サーバーでは、さらにツールが初めてそのサーバーを使用するときに Kanzi Account へのサインインを求められます。これは Claude Code、VS Code、Cursor、Windsurf、Codex、および MCP をサポートするその他すべてのツールで機能します。

エージェントの処理が完了したら、新しいチャットを開始して、ツールに新しいサーバーを読み込ませます。次に Kanzi に関する質問をして、ツールが応答することを確認します。例: 「Kanzi のドキュメントツールを使用して、Kanzi 4.1 でデータソースがどのように機能するかを教えてください」

代わりにサーバーを手動で設定するには、MCP サーバー を参照してください。

Ask Kanzi

Ask Kanzi は Documentation と API リファレンスに基づいているため、一般的な学習データではなく検証済みのコンテンツから回答します。概念に関する質問 (「データソースはどのように機能しますか?」)、手順に関する質問 (「プロパティをデータソースの値にバインドするにはどうすればよいですか?」)、API に関する質問 (「Kanzi 4.1 の kanzi::Node::setProperty のシグネチャは何ですか?」)、移行に関する質問 (「Kanzi 3.9.15 と 4.0.0 の間でレンダーパスについて何が変更されましたか?」) をすることができます。

重要なポイント:

  • ページコンテキスト。 ドキュメントのページから Ask Kanzi を開くと、Ask Kanzi はそのページを自動的にコンテキストとして使用するため、コピーアンドペーストせずにそのページについて追加の質問ができます。Ask Kanzi は、チャット入力欄の上に現在のページをピルとして表示します。ピルの × をクリックすると、そのページがコンテキストから削除されます。

  • セレクションコンテキスト。 Ask Kanzi を開く前にページ上の任意のテキストを選択すると、その選択範囲が追加のコンテキストになります。これは、特定のコードスニペット、表のセル、または段落について質問したい場合に便利です。

  • バージョン: Ask Kanzi は、開いた元のドキュメントページに対応する Kanzi バージョンに基づいて回答します。

  • ソース。 各回答には、その回答の根拠となったドキュメントページが一覧表示されます。ソースをクリックすると新しいタブで開き、文脈の中で回答を検証できます。

  • チャット内の検索。 パネルのヘッダーで虫眼鏡アイコンをクリックして文字を入力すると、現在の会話内のテキストを検索できます。上下の矢印 (または Enter と Shift+Enter) を使用して、見つかった語句を順に移動します。Esc を押すか閉じるボタンをクリックすると、ハイライトが解除されます。

  • 新しいチャット。 パネルのヘッダーで鉛筆アイコンをクリックすると、現在の会話がクリアされ、新しいチャットが開始されます。

同じドキュメント全体で検索を使用する方法の詳細については、Documentation の検索 を参照してください。

MCP サーバー

Kanzi MCP サーバーは、AI アシスタントを外部のツールやデータソースに接続するためのオープン標準である Model Context Protocol (MCP) に基づいて構築されています。Kanzi MCP サーバーを AI アシスタントに接続すると、アシスタントはサーバーが提供するツールを使用して Kanzi の情報を調べ、質問に回答できるようになります。

Kanzi は 3 つの MCP サーバーを提供しています。ドキュメントサーバーと API サーバーはパブリックです。認証は不要で、すべての Kanzi バージョンに対応しており、バージョンはツール内で選択します。Portal サーバーはお使いの Kanzi Account に接続するため、サインインが必要で、Kanzi Portal での権限の範囲内で動作します。

  • https://docs.mcp.kanzi.com/mcp の Kanzi ドキュメント MCP サーバー は、AI アシスタントを Kanzi のドキュメントに接続します。Kanzi の概念、機能、ワークフロー、ベストプラクティスについての回答を得るために使用します。

  • https://api.mcp.kanzi.com の Kanzi API MCP サーバー は、AI アシスタントを Kanzi の API リファレンスに接続します。API シグネチャの確認、非推奨ステータスのチェック、インクルードディレクティブの検索、Kanzi バージョン間の API の比較に使用します。

  • https://portal.kanzi.com/api/mcp にある Kanzi Portal MCP サーバー は、AI アシスタントを Kanzi Portal の Kanzi Account に接続します。これを使用すると、ライセンス、組織、ダウンロード、サポートチケット、API キーを自然言語で照会および管理できます。

サーバーを追加する最も簡単な方法は、ワンステップの クイックセットアップ です。サーバーを手動で追加するには、ツールの MCP 設定を使用します。

AI ツール

サーバーの追加方法

Claude Code

claude mcp add --scope user --transport http <name> <url> を実行します。

VS Code

サーバーを mcp.json に追加します (MCP: Open User Configuration で開きます)。

Cursor

サーバーを ~/.cursor/mcp.json に追加します。

Windsurf

サーバーを ~/.codeium/windsurf/mcp_config.json に追加します。

Claude Desktop

URL を追加する代わりに、ワンクリックの .mcpb バンドルをインストールします。Kanzi ドキュメント MCP サーバー と Kanzi API MCP サーバー を参照してください。

Codex

サーバーを ~/.codex/config.toml に追加します。

HTTP を直接サポートしていないその他の MCP ツール

npx -y mcp-remote <url> でサーバーをブリッジします。

<url> には、ドキュメントサーバーの場合は https://docs.mcp.kanzi.com/mcp、API サーバーの場合は https://api.mcp.kanzi.com、Portal サーバーの場合は https://portal.kanzi.com/api/mcp を使用します。Portal サーバーには、HTTP MCP をネイティブにサポートするツールと 1 回限りのサインインが必要です。Portal サーバーでは mcp-remote ブリッジは機能しません。各ツールでの詳しい設定手順については、Kanzi ドキュメント MCP サーバー、Kanzi API MCP サーバー、Kanzi Portal MCP サーバー を参照してください。

Kanzi AI ツールを使用するためのヒント

  • 質問は具体的にしてください。たとえば、「バインディングはどのように機能しますか?」と尋ねる代わりに、「データソースの値に基づいてノードの色を変更するバインディングを Kanzi Studio で作成するにはどうすればよいですか?」と尋ねます。

  • API の使用について質問する場合は、使用しているプログラミング言語と Kanzi バージョンを明記してください。ほとんどの MCP サーバーツールは一度に 1 つの Kanzi バージョンについて回答し、質問をまたいでバージョンを記憶しません。バージョンを指定すると、アシスタントはそれをツールに渡します。指定しない場合、ツールは利用可能な最新バージョンについて回答します。

  • API シグネチャの検証、非推奨のチェック、非推奨 API の代替案の提案を依頼できます。

  • Kanzi のバージョン間で移行する際は、AI アシスタントで Kanzi API MCP サーバーを使用してバージョン間の API を比較します。これにより、変更点を特定し、移行に必要な作業量を見積もることができます。