LiveAgentには組み込みのMCPサーバー（Model Context Protocol）が搭載されており、Claude Desktop、Cursor、claude.ai、FlowHuntなど、MCP対応の外部AIツールをLiveAgentアカウントに直接接続できます。接続後は、これらのツールがエージェントのIDと権限を使って、あなたに代わってチケットデータを読み取ったり操作を実行したりできるようになります。

MCPクライアントの認証方法は2種類あります。

  • Bearerトークン — プロフィール画面でMCPアクセストークンを生成し、クライアントに手動で貼り付けます。
  • OAuth 2.1 — クライアントが認可サーバーを自動的に検出し、同意画面へリダイレクトします。トークンを手動で扱う必要はありません。

プロフィール画面でMCP連携設定を見つける

  1. LiveAgentパネルの右上にあるアバターをクリックし、Edit profile（プロフィールを編集）を選択します。
  2. 左側のメニューからMCP Integration（MCP連携）を選択します。

この画面では、接続情報、アクセストークン、承認済みのOAuthアプリを確認できます。MCP対応クライアントを設定する際は、以下の値を使用してください。

設定項目 値
MCPサーバーURL https://<your-liveagent-domain>/api/mcp
転送プロトコル Streamable HTTP
認証方式 BearerトークンまたはOAuth 2.1（認可コード＋PKCE）

Bearerトークンでの接続

Bearerトークンは、プロフィール画面で生成し、MCPクライアントに直接貼り付けて使うMCPアクセストークンです。手動設定が必要なデスクトップツールやスクリプトに最適です。

アクセストークンの生成

  1. MCP Integration（MCP連携）画面で、Generate token（トークンを生成）をクリックします。
  2. アクセストークンをすぐにコピーしてください。これは一度しか表示されず、後から取得することはできません。
  3. アクセストークンをMCPクライアントのBearerトークン欄に貼り付けます。

重要： アクセストークンを生成したら、すぐに安全な場所に保管してください。紛失した場合は、既存のトークンを失効させて新しいトークンを生成する必要があります。

1アカウントにつき、最大10個のアクティブなアクセストークンを生成できます。同じアカウントを複数のツールやデバイスに接続する場合、複数のトークンを持つことで、他に影響を与えずに個別に失効させることができるため便利です。

注： アクセストークンは、使用頻度にかかわらず、生成日から2年で自動的に失効します。中断を避けるため、期限が切れる前にアクセストークンをローテーションすることをお勧めします。

アクセストークンの管理

MCP Integration（MCP連携）画面のアクセストークン一覧には、各トークンのマスクされた識別子と有効期限が表示されます。個々のアクセストークンを失効させることができ、失効させると対応するMCPクライアントは即座にアクセスできなくなります。

OAuthでの接続

OAuthを使うと、トークンをコピー＆ペーストすることなく、AIツールをLiveAgentのMCPサーバーに接続できます。ツールは標準のOAuth 2.1（PKCE付き）を使用して、認証フロー全体を自動的に処理します。

仕組み

  1. AIツール（例：claude.ai）に、LiveAgentのMCPサーバーURL https://<your-liveagent-domain>/api/mcp を追加します。
  2. ツールがそのURLに接続し、ディスカバリーヒントを受け取って、LiveAgentのOAuthサーバーメタデータを自動的に取得します。
  3. （まだログインしていない場合は）LiveAgentのログインページにリダイレクトされ、その後、接続の承認を求める同意画面が表示されます。
  4. 承認すると、ツールがアクセストークンを受け取り、すぐに使用可能になります。手動でのコピー＆ペーストは不要です。

注： 同意した内容は記憶されます。後で同じツールを再度接続する場合、同意画面は表示されず、フローは自動的に完了します。

承認済みアプリの管理

プロフィール画面のMCP Integration（MCP連携）画面には、Authorized apps（承認済みアプリ）の下に、承認したすべてのOAuthクライアントが一覧表示されます。承認済みアプリはいつでも失効させることができ、失効させるとそのツールは即座にアクセスできなくなり、再接続するには再度OAuthフローを行う必要があります。

エージェント管理権限を持つ管理者は、アカウント内の任意のエージェントについて、承認済みアプリを閲覧・失効させることができます。

利用可能なツール

Bearerトークン、OAuthのどちらで接続した場合でも、AIツールはLiveAgent MCPツールの全機能にアクセスできます。すべての操作はあなたのエージェントIDのもとで実行され、あなたのロールの権限に従います。ツールの完全な一覧と各ツールの機能については、MCP Tools Reference（MCPツールリファレンス）をご覧ください。

注： ルールに従って自動的にFlowHuntフローを実行し、エージェントの設定ごとにツールセットを制限するAIエージェントとは異なり、個人のMCPアクセストークンはすべてのツールへのアクセスを許可します。ただし、あなたのロールの権限は引き続き適用され、ロールで許可されていない操作は拒否されます。

注： MCP接続を通じて実行された操作は、アカウントのAIクレジット予算に対してカウントされます。AI予算とクレジットの仕組みについては、AIエージェントの記事をご参照ください。

権限と監査証跡

MCPクライアントを通じて行われたすべての操作は、Bearerトークン認証・OAuth認証のどちらを使用した場合でも、あなたがLiveAgentパネル上で直接操作したのと同じように、あなたのエージェントアカウントに帰属します。これらの操作は、チケットのアクティビティ履歴にあなたの名前で表示されます。

エージェント管理権限を持つ管理者は、アカウント内の任意のエージェントについて、MCPアクセストークンと承認済みOAuthアプリの両方を閲覧・失効させることができます。

関連記事