Zoho Apptics MCPサーバー

Zoho Apptics MCPサーバー

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

概要

Alertメモ:Zoho Apptics MCPサーバーは現在開発中で、BETAフェーズで利用可能です。一部の機能はご利用いただけない場合があり、この期間中に課題が発生することがあります。
Zoho Apptics Model Context Protocol (MCP)サーバーは、会話型AIを活用し、利用状況やエンゲージメント、パフォーマンス統計などの商品データを分析するためにチームをサポートします。AIインターフェース（Claude、Cursorなど）を通じて、自然言語でデータに直接クエリを実行でき、SQLクエリやダッシュボードの詳細な分析は不要です。Zoho Apptics MCPはZoho MCP上に構築されているため、Zoho MCPにアクセスし、サーバーを作成してからZoho Apptics MCPを利用します。

Zoho Apptics MCPサーバーは、以下のMCP機能をサポートしています：
  1. リモートMCPサーバーまたはローカルホストのMCPサーバーに対応。
  2. 認証のためのOAuthサポート。
  3. Appticsデータにさらなるコンテキストを提供するための14以上のツールコール＆プロンプトをLLMに統合。

リモートMCPサーバー


はじめに

権限とアクセス制御

  1. すべての組織メンバーがMCP連携を利用できます。
  2. 組織メンバーは、Zoho Apptics内でアクセス権のあるプロジェクトのデータのみ参照できます。
  3. 既存のロールや権限のアクセス制御がMCP連携にも適用されます。

Zoho MCPサーバーへのアクセス

  1. https://www.zoho.com/mcp/にアクセスし、Playgroundの利用申請を行います。
  2. 申請が承認されたら、https://mcp.zoho.com/にアクセスします。

  1. 管理サーバーで、サーバーを作成をクリックし、サーバー名を入力して作成をクリックします。
  2. サーバーが作成されます。ツール設定をクリックし、サーバーにAppticsを追加します。

  1. 要件に応じてツールを選択し、今すぐ追加をクリックします。

  1. 左側のメニューから接続をクリックし、Apptics MCPをLLMに追加します。


実装

ご利用のLLMツールに応じて、以下の手順を完了してください。
Claude
カーソル
ウィンドサーフ
VS コード
Claude

Zoho Apptics MCP を Claude に接続する

Claude を Zoho Apptics MCP と連携させることで、会話ウィンドウ内から安全かつ簡単な設定でリアルなワークフローを処理できるようになります。

Claude で Zoho Apptics MCP を設定する

メモ: Claude 組織の管理者のみがこの手順を実行できます。接続が完了すると、組織内のすべてのユーザーがこの統合にアクセスできますが、この Zoho Apptics MCP インスタンスにリンクされたツールの管理は管理者のみが可能です。
  1. claude.ai/設定/integrations にアクセスします。
  2. 組織のインテグレーションをクリックします。
  3. 追加するインテグレーションを選択します。
  4. 名前を入力し、上記で提供されたインテグレーションURLを貼り付けます。
  5. 追加をクリックします。

Claude で Zoho Apptics MCP ツールにアクセスする

  1. 新しいチャットを開きます。
  2. 検索とツールを選択します。
  3. Zoho Apptics MCP の接続を選びます。
  4. チャットで使用したいツールを選択します。
  5. Claude にツールを使って処理するよう依頼します。
カーソル

Zoho Apptics MCPをCursorに接続する

Zoho Apptics MCPのツールをCursor IDE内で直接利用できます。AIアシスタントを有効にし、コーディング作業スペースを離れることなく安全に実際の処理を実行できます。
  1. {
  2. 'mcpServers': {
  3. 'ZohoMCP': {
  4. 'url': 'YOUR_INTEGRATION_URL'
  5. }
  6. }
  7. }

CursorでのZoho Apptics MCPの設定

まず「Cursorに追加」をクリックして自動設定をお試しください。手動でインストールする場合は、以下の手順に従ってください。
  1. Zoho Apptics MCPサーバーを追加します。
  2. Cursorの設定を開きます（⇧ + ⌘ + J）。
  3. MCP Toolsタブに移動し、新規MCPサーバーをクリックします。
  4. 下記のJSON構成をコピー＆ペーストし、CMD + SまたはCTRL + Sで保存します。
  5. Agent方法を有効にします。
  6. Cursor内でZoho Apptics MCPツールへアクセスするため、チャットがAgent方法に設定されていることを確認してください。
重要：MCPサーバーキーはパスワードと同様に厳重に管理してください。キーを使うことで接続済みのツールがアカウントへアクセスし、機密情報が取得される可能性があります。
Windsurf

WindsurfアイコンからZoho Apptics MCPへ接続

Zoho Apptics MCPをWindsurf IDE内で直接利用できます。AIアシスタントが安全かつシンプルな接続を通じて、実際の処理をコーディング環境から行います。
  1. {
  2. 'mcpServers': {
  3. 'Zoho': {
  4. 'command': 'npx',
  5. 'args': [
  6. 'mcp-remote',
  7. 'YOUR_INTEGRATION_URL',
  8. '--transport',
  9. 'http-only'
  10. ]
  11. }
  12. }
  13. }

WindsurfでのZoho Apptics MCP設定

  1. Windsurfの設定を開きます（⌘ + ,）。
  2. Cascadeタブへ移動し、「Server追加」をクリックします。
  3. 「カスタムサーバー追加 +」を選択します。
  4. 以下のJSON設定を追加し、差し込み項目キーを下記のご自身のMCPキーに置き換えます。
メモ: MCPサーバーキーはパスワードと同様に扱ってください！このサーバーに紐づくツールの起動や、データへのアクセスが可能です。
VS コード

Visual Studio コードへの接続

Zoho Apptics MCPを使って、Visual Studio コード内で直接ツールを利用できます。AIアシスタントが安全かつシンプルな接続を通じて、コーディングワークスペースを離れることなく実際の処理を実行します。

重要: Zoho Apptics MCPを正常に機能させるには、GitHub Copilotを有効にし、Visual Studio コードでAgent方法に設定しておく必要があります。

Visual Studio コードでのZoho Apptics MCP設定

  1. Visual Studio コードのコマンドパレットを開きます（⇧ + ⌘ + P（Mac）、Ctrl + Shift + P（Windows））。
  2. 'MCP: サーバー追加...'と入力し、Enterを押します。
  3. 'HTTP (HTTPまたはServer送信済み処理)'を選択し、Enterを押します。
  4. 下記のMCPキーを「Serverキー」項目に貼り付け、Enterを押します。
  5. サーバー名を入力し、Enterを押します。
  6. GitHub CopilotがAgent方法に設定されていることを確認してください。
  7. GitHub Copilotに、Zoho Apptics MCPサーバーからツールを利用するよう依頼します！
注意: MCPサーバーキーはパスワードと同様に扱ってください！このキーを使用すると、サーバーに紐づくツールの起動や機密データへのアクセスが可能です。

ローカルホストMCPサーバー

必要要件

  1. Node.js 18 またはそれ以降。
  2. Zoho Apptics OAuth 認証情報、すなわちクライアントID、clientシークレット、およびApptics APIにアクセスできる更新用トークン。

認証情報

Zoho Apptics ローカル MCP サーバーを設定するには、OAuth 認証情報（クライアントID、clientシークレット、更新用トークン）を環境変数として指定する必要があります。
  1. Zoho API コンソールから新規 self-client アプリケーションを作成します。
  2. JProxy.jmobileapi.すべてスコープでコードを生成します。
  3. OAuth トークンエンドポイントを使用して、コードを更新用トークンと交換します。
  1.  curl -X POST 'https://取引先。Zoho。com/oauth/v2/token' \
   -H 'コンテンツの種類: application/x-www-form-urlencoded' \
   -d 'コード=YOUR_SELF_CLIENT_CODE' \
   -d 'client_id=YOUR_CLIENT_ID' \
   -d 'client_secret=YOUR_CLIENT_SECRET' \
   -d 'grant_type=authorization_code'
JSON レスポンスには refresh_token が含まれています。更新用トークンは APPTICS_REFRESH_TOKEN 経由で指定してください。その他の Zoho データセンターを利用する場合は、取引先。Zoho。com を 取引先。Zoho。eu や 取引先。Zoho。in などに切り替えてください。

環境変数

変数
必須
説明
APPTICS_CLIENT_ID
はい
Zoho APIコンソールで作成したOAuth クライアントID
APPTICS_CLIENT_SECRET
はい
Zohoセルフクライアント用 OAuth クライアントシークレット
APPTICS_REFRESH_TOKEN
はい
JProxy、jmobileですべてのscopeを使用して取得したアクセストークン用のリフレッシュトークン
APPTICS_SERVER_URI
いいえ
Apptics APIのベースURLを上書き（デフォルトはhttps://apptics.zoho.com）。必要に応じてリージョナルドメインを利用してください
APPTICS_ACCOUNTS_URI
いいえ
Zoho取引先OAuthベースURLの上書き（デフォルトはhttps://accounts.zoho.com）。他のデータセンターを利用する場合はaccounts.zoho.euやaccounts.zoho.inなどに切り替えてください

Claudeデスクトップ設定

  1. Claude desktop を開きます。
  2. 設定 > Developer > config を編集 に移動します。
  3. 以下の設定を追加します。
  1. {
     'mcpServers': {
       'Zoho-apptics': {
         'command': 'npx',
         'args': ['@zoho_apptics/apptics-mcp'],
         'env': {
           'APPTICS_CLIENT_ID': 'your_client_id',
           'APPTICS_CLIENT_SECRET': 'your_client_secret',
           'APPTICS_REFRESH_TOKEN': 'your_refresh_token'
         }
       }
     }
   }
  1. Claude desktop アプリを再起動します。

 Zoho Apptics MCP ツール

MCP 統合により、Apptics の主要な機能へアクセスできます。

ツール名
 説明
getUserProjects 認証済みユーザーに関連付けられたプロジェクト一覧を取得します。
getCrashList クラッシュの概要リストを取得します。アプリのバージョンやプラットフォームで任意に絞り込むことができます。
getCrashSummary クラッシュレポートの要約表示を取得します。プラットフォームや方法（開発または本番）で絞り込むことも可能です。
getCrashesByDate クラッシュ関連の統計情報を日付やプラットフォームごとに取得します。
getCrashSummaryWithUniqueMessageId ユニークなメッセージIDで識別されるイベントに対して、特定のクラッシュの詳細メタデータおよび診断トレースを取得します。
getEventSummary プラットフォームごとにグループ化されたカスタム処理の概要を取得します。
getEventCountrywiseSummary 国別でグループ化された処理の概要を取得します。
getEventDeviceCount 特定のカスタムイベントを実行済みのユニークな有効デバイス件数を取得します。
getEventCountByDate 日付およびプラットフォームごとにグループ化された処理のデータを取得します。
getAllEventStats 日付、プラットフォーム、国、アプリバージョン、デバイス種類など、1つまたは2つのパラメーターでグループ化したイベント件数の概要を取得します。
getAllScreenStats 日付、プラットフォーム、国、アプリバージョン、デバイス種類など、1つまたは2つのパラメーターでグループ化した画面ビュー件数の概要を取得します。
getAllApiStats プラットフォーム、日付、アプリバージョン、国、デバイス種類などで構成されたAPIの利用統計情報を取得します。
getAllActiveDeviceStats 日付、プラットフォーム、国、アプリバージョン、デバイス種類など、1つまたは2つのパラメーターでグループ化したユニークな有効デバイス件数を取得します。
getActiveDeviceCountByDate
 各プラットフォームごとに、毎日のユニークな有効デバイスの件数を取得します。

例 使用ケース

  1. Appticsでアクセス可能なすべてのプロジェクトのリストを表示してください。
  2. 過去7日間のクラッシュ概要を取得します。
  3. 過去30日間にpayment_madeイベントを完了した有効デバイスの一覧を表示します。
  4. アプリの商品リストページで過去7日間に発生した処理の件数と内容を表示してください。
  5. 各プラットフォームごとにイベントの割合（%）分布を表示してください。