1. Pendoヘルプセンター
  2. インテグレーション
  3. Pendo MCP

Pendo MCPサーバーに接続する

最終更新日:

この記事では、AIクライアントをPendo MCPサーバーに接続する方法について説明します。Pendo MCPサーバーがどのような機能を持ち、どのように動作するのかについては、「Pendo MCPサーバーの概要」を参照してください。

始める前に

Pendo MCPサーバーに接続する前に：

  • Pendoサブスクリプションの管理者があなたのサブスクリプションに対してMCPを有効にする必要があります。
  • リージョンのURLを確認する必要があります。
  • AIクライアントに外部 MCP サーバーを追加または設定する権限が必要です。
  • OAuth認証、Streamable HTTPまたはSSEトランスポート、および外部MCPサーバーURLをサポートするAIクライアントが必要です。一般的な例としては、Claude、Claude Code、ChatGPT、Cursor、Gemini CLI、Windsurfなどがあります。

PendoでMCPを有効化する

サブスクリプション管理者は、ユーザーがAIクライアントから接続する前にPendo MCPサーバーを起動しなければなりません。

この機能を有効にするには：

  1. Pendoの右上隅にある［設定（Settings）］>［サブスクリプション設定（Subscription settings）］に移動します。
  2. ［AIアクセス］タブを選択します。
  3. Pendo MCPサーバー（読み取り専用ツール）のトグルをオンにしてください。これにより、接続されたAIクライアントがPendoデータを照会および取得できるようになります。
  4. オプションとして、読み取り専用ツールを有効にした後、Pendo MCPサーバー（書き込みツール）を有効にして、AIクライアントがフィードバックアイテムの作成など、Pendo内でアクションを実行できるようにすることもできます。

管理者がPendoでMCPサーバーをオンにした後、PendoユーザーはOAuth認証、Streamable HTTPまたはSSEトランスポート、外部MCPサーバーURLをサポートする好みのAIクライアントでサーバーを使用できます。

リージョンのURLを探す

Pendoサブスクリプションがホストされているデータセンターに一致するMCPサーバーのURLを使用します。これはPendoにサインインする際に使うホスト名と同じです。

  • 米国：https://app.pendo.io/mcp/v0/shttp
  • US1： https://us1.app.pendo.io/mcp/v0/shttp
  • EU： https://app.eu.pendo.io/mcp/v0/shttp
  • 日本：https://app.jpn.pendo.io/mcp/v0/shttp
  • オーストラリア：https://app.au.pendo.io/mcp/v0/shttp

この記事の後半で希望するAIクライアントを設定する際には、このリージョンURLを使用します。リージョンが不明な場合は、PendoのログインURLをご確認ください。

複数のリージョンでPendoのサブスクリプションをご利用の場合は、地域ごとに個別のMCPサーバー接続を設定する必要があります。

AIクライアントを接続する

AIクライアントをPendo MCPサーバーに接続する方法は2つあります。

  • 公式のPendoアプリとコネクタ。一部のAIツールでは、コネクタディレクトリにPendoが公式にサポートされているアプリとして含まれています。これが最もシンプルなセットアップパスです。
  • カスタムMCPサーバー設定。Pendoの公式アプリがないAIツールや、公式コネクタがサポートしていない地域のPendoサブスクリプションの場合は、リージョンURLを使って手動でPendo MCPサーバーを設定します。

以下の手順に従って、OAuthとStreamable HTTPを使用して、お好みのAIクライアントにPendo MCPサーバを設定します。データにアクセスするには、Pendoサブスクリプションの既存のユーザーとして、Pendo認証情報で認証する必要があります。

注：手順は変更される場合があり、AIクライアント、バージョン、構成によって異なる場合があります。表示されている内容と一致しない場合は、AIクライアントのドキュメントを参照して、最新の設定方法とトラブルシューティングの手順を確認してください。

Claude.aiとClaude for Desktop

管理者は、claude.aiとClaude for Desktopの両方で、他のClaudeユーザーが接続できるようにする前に、まずPendo MCPサーバーをコネクタとして追加する必要があります。

  1. Claudeの左下隅にあるプロフィールアイコンを選択し、Admin settingsを選択します。
  2. Connectorsタブを開き、リストの一番下にあるBrowse connectorsを選択します。
  3. 必要に応じて検索ボックスを使用してPendoを選択します。

    Claude_Connectors_Pendo.png
  4. サーバーURLに地域のURLを入力し、［続行（Continue）］を選択します。これにより、組織で使用可能なコネクタのリストに追加されます。

Pendo MCP をコネクタとして追加した後は、Claudeユーザーであれば次の手順で接続できます：

  1. Claudeの左下にあるプロフィールアイコンを選択し、その後［設定］を選択します。


    Claude_Settings.png
     

  2. コネクタタブを開きます。
  3. Pendoコネクタの横にある［接続］を選択します。
  4. サインインを求められた場合は、Pendoアカウントにサインインし、［許可（Allow）］を選択してClaude AIにPendoサブスクリプションへのアクセス権を付与します。
  5. これにより、コネクターページにリダイレクトされ、Pendoコネクターが設定オプションと共に表示されます。これを選択すると、次の操作を行えます：
    • Pendoデータのクエリに利用可能な各閲覧数ツールを表示する。
    • 特定のツールを [常に許可する] か [承認が必要] にするかを選択します。デフォルトでは、すべてのツールが［承認が必要］に設定されています。この設定では、関連するMCPツールを実行するたびにClaudeがあなたの許可を求めます。

Claude Code

  1. ターミナルでclaude mcp add --transport http pendo https://app.pendo.io/mcp/v0/shttpを実行します。必要に応じて、URLを別の地域URLに置き換えます。
  2. claude .を使用してClaudeコードを開始します。確認メッセージが表示され、右下に「1 MCP server needs auth」という短いメッセージが表示されます。
  3. /mcpと入力してMCPサーバーのリストを表示し、矢印キーでPendoに移動してenterキーを押してPendoアカウントにサインインします。
  4. ［認証（Authenticate）］を選択し、もう一度Enterキーを押します。
  5. サインインを求められた場合は、Pendoアカウントにサインインし、［許可（Allow）］を選択してClaude CodeにPendoサブスクリプションへのアクセス権を付与します。
  6. 認証が成功したことを確認するには、/mcpを実行して確認メッセージ「Authentication successful. Connected to Pendo.」を表示させます。ここから利用可能なMCPツールを表示し、認証と接続を管理できます。

    ClaudeCode_MCP_ViewTools.png

ChatGPT（デベロッパーモード）

Pendo MCPサーバーをChatGPTにカスタムインテグレーションとして接続できますが、これにはChatGPTの開発者モードを使用する必要があります。

  1. ChatGPTの左下で自分の名前を選択し、［設定］を選びます。

    ChatGPT_Settings.png
     
  2. ［Apps & Connectors］に移動し、ウィンドウ下部の［詳細設定（Advanced Settings）］を開きます。
  3. ［開発者モード（Developer mode）］がオフの場合はオンにし、［戻る（Back）］を選択します。
  4. モーダルの右上にある［作成（Create）］を選択します。
  5. 「Pendo」をコネクタの［名前（Name）］に入力し、お使いの［地域別URL（regional URL）］を［MCPサーバーURL（MCP Server URL）］として入力し、「OAuth」を［認証方法（Authentication）］で選択します。
  6. ［理解したうえで続行します（I understand and want to continue）］の横にあるチェックボックスを選択し、［作成（Create）］を選択します。
  7. メッセージが表示されたら、Pendoアカウントにサインインし、許可を選択して、ChatGPTにPendoサブスクリプションの権限を付与します。
  8. ChatGPTでステップ１を繰り返して設定を開き、［Apps & Connectors］を選択します。Pendo MCPサーバーが表示され、詳細情報の表示、接続の解除、利用可能なツール一覧の確認などの操作を行えます。
  9. Pendo MCPを使用するには、ChatGPTのホームページに戻ります。プロンプトバーの［＋］アイコンを選択し、［その他（More）> Pendo］を選択してMCPをチャットに接続します。ChatGPT_Add_PendoMCP.png

カーソル

ショートカットリンクを使用するか、MCP設定ファイルを更新してPendo MCPサーバーをCursorに接続できます。

  1. WebブラウザでCursorのMCPディレクトリを開きます。または、ブラウザで次のリンクcursor://anysphere.cursor-deeplink/mcp/install?name=Pendo&config=eyJ1cmwiOiJodHRwczovL2FwcC5wZW5kby5pby9tY3AvdjAvc2h0dHAifQ==を開き、手順3に進みます。
  2. テーブルの上で「pendo」を検索し、［+Cursorに追加（+ Add to Cursor）］を選択します。

    CursorMCPDirectory_AddToCursor.png
     
  3. プロンプトが表示されたら、［Cursorを開く（Open Cursor）］を選択してPendo MCPサーバーをインストールします。
  4. お使いのリージョンURLがURLフィールドに入力されているものと異なる場合は、それに応じて更新し、［インストール（Install）］を選択してください。

    CursorSettings_Install.png
     
  5. ［接続（Connect）］を選択し、次に［開く（Open）］を選択してCursorがリンクを開けるようにします。

    Cursor_CursorSettings_Connect.png
  6. プロンプトが表示されたら、Pendoアカウントにサインインし、［許可（Allow）］を選択してPendoサブスクリプションへのアクセス権を付与します。

Gemini CLI

Pendo MCPサーバーをGeminiコマンドラインインターフェース（CLI）に接続し、ターミナルからライブPendoデータを照会することができます。

  1. ターミナルで（Gemini CLIを起動していない状態で）gemini mcp add pendo https://app.pendo.io/mcp/v0/shttp --transport http --scope userと入力し、必要に応じてapp.pendo.ioを地域のURLに置き換えてください。
  2. geminiコマンドでgemini-cliを起動し、次に/mcp auth pendoを実行します。
  3. プロンプトが表示された場合、Pendoアカウントにサインインし、［許可（Allow）］を選択して、Gemini CLIにPendoサブスクリプションへの権限を付与します。
  4. 認証が成功したことを確認するには、 /mcp を実行して確認メッセージ「Successfully authenticated with MCP server」を表示します。ここから利用可能なMCPツールを表示し、認証と接続を管理できます。

    Gemini_Authenticated.png

Windsurf

これらの手順を実行するには、カスタム MCP を有効にする権限が必要です。

  1. 上部メニューバーで［Windsurf > 設定（Settings）> Windsurf設定（Windsurf Settings）］を選択します。Windsurf_Settings.png
     
  2. ［Cascade］セクションで［MCPサーバー（MCP Servers）］設定を見つけ、［MCPマーケットプレイスを開く（Open MCP Marketplace）］を選択します。Windsurf_Cascade_OpenMCPMarketplace.png
     
  3. Installed MCPsセクションで、右側の歯車アイコンを選択して、~/.codeium/windsurf/mcp_config.jsonファイルを開きます。

  4. 次の構成を追加し、必要に応じてURLを別の地域別URLに置き換えて、ファイルを保存します。

    {
  "mcpServers": {
    "pendo": {
      "serverUrl": "https://app.pendo.io/mcp/v0/shttp"
    }
  }
}
  5. ［MCPマーケットプレイス（MCP Marketplace）］タブに戻り、更新アイコンを選択してから、［Pendo］タイルを選択します。Windsurf_Refresh.png 
  6. メッセージが表示されたら、Pendoアカウントにサインインし、［許可］を選択して、PendoサブスクリプションにWindsurfの権限を付与します。

他のクライアント

サポートするクライアントからも接続できます：

  • OAuth認証。
  • ストリーム可能な HTTP または SSE トランスポート。
  • 外部MCPサーバーのURL。

クライアントのドキュメントに従ってセットアップを行い、Pendo MCPサーバーを追加する際には、以下の設定を使用します。

{
  "mcpServers": {
    "Pendo": {
      "url": "ENTER_YOUR_REGIONAL_ENDPOINT_HERE"
    }
  }
}

設定を保存したら、次の手順に沿って OAuth で認証します。

  1. OAuth プロンプトを承認します。
  2. Pendoの資格情報でサインインします。
  3. 要求されたスコープへのアクセスを許可します。

公式コネクタのリージョン制限

一部の公式コネクタはまだすべてのPendoリージョンをサポートしていません：

  • 公式のChatGPTアプリは現在、USおよびEUリージョンのみをサポートしています。
  • 公式のCursorインテグレーションは現在、USリージョンのみをサポートしています。

Pendoサブスクリプションが公式コネクタでサポートされていないリージョンにある場合は、代わりにAIクライアントのカスタムMCPサーバー構成に従ってください。

サブスクリプションの範囲

Pendo MCPサーバーが複数のPendoサブスクリプションへのアクセスをどのように処理するかは、認証方法によって異なります。

  • インタラクティブOAuth。1つの接続で、同一リージョン内のPendoのすべてのサブスクリプションをカバーできます。特定のサブスクリプションにクエリするには、プロンプトにそのサブスクリプションIDを含めてください。別のサブスクリプションをクエリするために再接続や変更は必要ありません。
  • サービスアカウント。各サービスアカウントは単一のPendoサブスクリプションに限定されています。複数のサブスクリプションからデータを照会するには、それぞれのサブスクリプションに個別のサービスアカウントを作成してください。詳細については、「サービスアカウントを使用してPendo MCPサーバーに認証する」を参照してください。

Pendoデータはリージョンごとに分離されているため、どちらの認証方法もリージョンを越えてデータにアクセスすることはできません。複数のリージョン（USとEUの両方など）にPendoサブスクリプションを持つ場合は、リージョンURLを使用してリージョンごとに個別の接続を設定する必要があります。

ヒント：AIクライアントがアクセスできるサブスクリプションを確認するには、すべてのアプリケーションを一覧表示するように依頼してください。

サービスアカウントで認証する

人がサインインせずに実行するAIエージェントやインテグレーションを構築するのであれば、インタラクティブOAuthの代わりにPendoサービスアカウントを使用してください。詳細については、「サービスアカウントを使用してPendo MCPサーバーに認証する」を参照してください。

トラブルシューティング

期待どおりに動作しない場合は、以下の手順を試してみてください。

ヒント：正しく認証され、Pendo MCPサーバーに接続されていることを確認するには、クライアントにどのツールにアクセスできるかを問い合わせてください。

接続に失敗するか、認証エラーが返される

正しいリージョンURLと完全な/mcp/v0/shttpパスを使用していることを確認してください。接続に失敗する最も一般的な原因は、PendoのログインURL（例えば、https://app.pendo.io/）をMCPサーバーのURLの代わりに使用することです。

誤ったURLで認証を行った場合、AIクライアントがそのURLをキャッシュしている可能性があります。PendoコネクタまたはMCPサーバーエントリをクライアントから削除し、正しいリージョンURLで再度追加します。

OAuthに関する問題

OAuth固有の問題については、以下を確認してください。

  • クライアントがOAuthをサポートしていることを確認してください。
  • AIクライアントで正しい権限を持っていることを確認してください。
  • Pendoサブスクリプションを切り替えた場合は、サインアウトして再度サインインしてください。
  • サブスクリプションのデータセンター（US1、EU、日本、オーストラリア）と一致するMCPサーバーURLを使用していることを確認します。

AIクライアントは接続するが、データを返さない

以下の点を確認してください。

  • 認証が正常に完了した。
  • ［サブスクリプション設定］>［AIアクセス］でサブスクリプション管理者がPendo MCPサーバーを有効にした。
  • クエリしているデータにはアクセスできる。MCPサーバーはあなたのPendo権限を継承します。
  • 正しいサブスクリプションに対してクエリを実行している。複数のサブスクリプションに所属している場合、AIクライアントは予想とは異なるものに接続されている可能性があります。
  • クライアントコンソールやログでエラーがないか確認してください。

Microsoft Copilot Studio: 「文字列またはバイナリデータが切り捨てられます」エラー

動的検出を使用してMicrosoft Copilot StudioにPendo MCPサーバーを追加する際にこのエラーが発生した場合は、手動構成に切り替えてOAuthエンドポイントを直接入力してください。これはCopilot Studioの既知の制限事項です。

その他の接続問題

さらにサポートが必要な場合は、Pendoのアカウント担当者またはサポートチームにお問い合わせください。

関連記事

この記事は役に立ちましたか？
3人中1人がこの記事が役に立ったと言っています

このセクションの記事