On this page
MCPツールリファレンス
この記事では、LiveAgent MCPサーバーが公開するすべてのツールを一覧で紹介します。同じツールセットが以下の両方のコンテキストで利用可能です。
- 個人MCP接続（Bearerトークンまたは OAuth 2.1）— ユーザーの役割の権限に応じて、すべてのツールが自動的に利用可能になります。
- AIエージェントMCP接続 — エージェントを設定する際に管理者が利用可能なツールのサブセットを選択します。そのリストに含まれていないツールは、フローから要求された場合でもブロックされます。
セットアップ手順については、MCP Integration for Agents（個人接続）またはAI Agents feature overview（自動化エージェント）をご覧ください。
読み取り専用ツール
| ツール | 機能 |
|---|---|
| Get ticket messages（チケットメッセージ取得） | チケットメッセージを取得します。カーソルを省略すると初回の全件取得となり、カーソルを指定すると前回のレスポンスより新しいメッセージのみを取得します |
| Get ticket metadata（チケットメタデータ取得） | 件名、タイムスタンプ、ステータス、優先度、部門、担当エージェントなどのチケットプロパティを読み取ります |
| Get tags（タグ取得） | チケットに現在適用されているタグを読み取ります |
| Get ticket notes（チケットノート取得） | 内部チケットノート（エージェントノート、ルールノート、APIノート）をカーソルベースのページネーションで取得します |
| Get ticket field definitions（チケットフィールド定義取得） | アカウントに設定されているすべてのチケットフィールド定義を取得します。リスト型で利用可能な値など、タイプ固有のメタデータも含まれます |
| Get ticket field values（チケットフィールド値取得） | 指定したチケットのすべてのチケットフィールド値を、それぞれの定義メタデータとともに読み取ります |
| List agents（エージェント一覧取得） | アカウント内で利用可能なエージェントの一覧を取得します（アサイン操作に必要です） |
| List departments（部門一覧取得） | 部門の一覧を取得します（転送操作に必要です） |
| Search tickets（チケット検索） | コンテキストを把握するために、システム内の他のチケットを検索します |
書き込みツール
| ツール | 機能 |
|---|---|
| Add tags（タグ追加） | チケットに1つ以上のタグを適用します |
| Remove tags（タグ削除） | チケットから1つ以上のタグを削除します |
| Add note（ノート追加） | チケットに内部ノートを追加します |
| Set ticket field value（チケットフィールド値設定） | カスタムチケットフィールドの値を設定します。値が存在しない場合は作成し、存在していて異なる場合は更新します |
| Delete ticket field value（チケットフィールド値削除） | チケットからカスタムチケットフィールドの値を削除します |
| Submit ticket summary（チケットサマリー送信） | 生成されたAIサマリーをチケットに送信します |
| Resolve ticket（チケット解決） | チケットのステータスを解決済みに設定します |
| Reopen ticket（チケット再オープン） | 以前に解決済みまたは回答済みとなったチケットを再度開きます |
| Assign ticket（チケット割り当て） | チケットを特定のエージェントに割り当てます |
| Transfer ticket（チケット転送） | チケットを別の部門に移動します |
ナレッジベースツール
読み取りツールには knowledgebase 権限が必要です。書き込みツール（作成・更新）には、それに加えて knowledgebase content manage 権限が必要です。
| ツール | 機能 |
|---|---|
| List knowledge bases（ナレッジベース一覧取得） | アカウント内のすべてのナレッジベースを一覧表示します — 他のKBツールで必要となるナレッジベースIDを確認するために、まずこのツールを使用してください |
| List KB categories（KBカテゴリ一覧取得） | ナレッジベースのカテゴリをツリー形式で一覧表示します。特定の親カテゴリのサブツリーに絞ることもできます |
| Search KB articles（KB記事検索） | キーワードやフレーズで記事を検索します。カテゴリで絞り込むこともできます |
| Get KB article（KB記事取得） | 記事の全内容を取得します。各添付ファイルには使い捨てのダウンロードURLが含まれます |
| Create KB article（KB記事作成） | 指定したカテゴリ内に、HTMLコンテンツを持つ新しい記事を作成します |
| Update KB article（KB記事更新） | 記事のタイトル、本文、ステータス、公開範囲、またはカテゴリを更新します。指定したフィールドのみが変更されます |
| Create KB category（KBカテゴリ作成） | 記事を整理するための新しいカテゴリまたはサブカテゴリを作成します |
| Update KB category（KBカテゴリ更新） | 既存カテゴリの名前変更、移動、並べ替え、または公開範囲の変更を行います |
