概要
利用条件
|
機能領域
|
目的
|
|
ツール
(MCP管理者が設定) |
ツールは、Zoho MCPサーバーを通じてAIクライアントに提供される、各種Zohoサービスや外部アプリケーションの機能を表します。各ツールは、レコードの作成、データの更新、情報の取得、ワークフローの実行など、接続先のアプリケーション内で実行できる特定の操作を表します。
MCPサーバーを設定する際、Zoho MCP管理者は、アプリケーションの要件やセキュリティ上の考慮事項に基づいて、連携するアプリケーションと公開するツールを選択できます。
各ツールには、実行する操作、必要な入力、想定される応答が定義されています。AIクライアントはこの情報を使用して適切なツールを特定して実行できるため、アプリケーションの内部実装やAPIを理解しなくても、アプリケーションを操作できます。
|
|
認証と認可
(MCP管理者が設定) |
認証と認可のレイヤーでは、接続先のアプリケーションを操作するために必要な権限がMCPサーバーに付与されていることを確認します。AIクライアントがアプリケーションからデータを取得したり、操作を実行したりするには、事前に適切なスコープでアプリケーションへのアクセスをMCPサーバーに認可する必要があります。
Zoho MCPでは、次の2つの方法で認可を設定できます。
オンデマンド認可:ユーザーごとの認可方式です。MCPサーバーに接続する各ユーザーは、ツールを使用する前に、自分のアカウント認証情報を使用してOAuth認可フローを完了する必要があります。
接続による認可:MCPサーバーの設定時に、接続を通じて事前に認可を設定します。これは組織単位の認可方式です。管理者が一度認可を行い、取得したOAuthアクセストークンと更新トークンを信頼できるメンバーと共有することで、各ユーザーが個別に認証しなくてもMCPツールにアクセスして実行できるようになります。
Zoho MCP管理者は、Zoho MCPサーバーの設定ページにある接続セクションで認可方式を設定できます。初期設定では、オンデマンド認可が設定されています。
認可の設定後、Zoho MCPの認証レイヤーがアプリケーションに関連付けられた認証情報を管理し、AIクライアントが承認済みの操作のみを実行できるようにします。アクセスが取り消された場合や認可が無効になった場合、ユーザーはツールを使用する前に、アプリケーションを再認可する必要があります。 |
|
要求ハンドラー
(内部処理) |
要求ハンドラーは、MCPクライアントから受信した要求を処理します。要求の構造を検証し、必要な入力が含まれているかどうかを確認して、要求を処理する適切なツールを特定します。
要求の検証が完了すると、要求ハンドラーは要求をAPI変換機能に渡します。必要な入力が不足している、無効である、またはサポートされていない場合、要求ハンドラーはアプリケーションを呼び出さずにエラー応答を返します。 |
|
API変換機能
(内部処理) |
API変換機能は、標準化されたMCP要求をアプリケーション固有のAPI要求に変換します。アプリケーションごとに使用するAPI、エンドポイント、要求形式、データ構造が異なる場合があるため、受信した要求を対象アプリケーションで必要なAPI形式に対応付けます。
その後、コネクターが対応するアプリケーションAPIを呼び出し、要求された操作を行います。 |
|
応答フォーマッター
(内部処理) |
対象アプリケーションでAPI要求が実行されると、アプリケーションから操作結果を含む応答が返されます。応答フォーマッターはこの応答を処理し、標準化されたMCP準拠の形式に変換してからMCPクライアントに返します。
|
| カテゴリー | ツール | 機能 |
|---|---|---|
| アプリケーションとワークスペースの管理 | getApplications | アプリケーションの全一覧を、名前やリンク名などの詳細情報とともに、認証済みのZoho Creatorアカウントから取得します。 |
| getApplicationsByWorkspace | 指定したワークスペースに関連付けられているすべてのアプリケーションの詳細を取得します。 | |
| getWorkspaces | 認証済みユーザーがアクセスできるワークスペースの一覧を取得します。 | |
| getApplicationSummary | 指定したZoho Creatorアプリケーションの概要を取得します。 | |
| duplicateApplication | 既存のアプリケーションを、フォーム、レポート、ワークフロー、設定を含めて複製します。 | |
| deleteApplication | Zoho Creatorアプリケーションと関連リソースを削除します。 | |
| updateApplicationStatus | Zoho Creatorアプリケーションを有効または無効にします。 | |
| getGalleryApps | 利用可能なギャラリーで提供されている作成済みアプリケーションの詳細を取得します。 | |
| installGalleryApp | Zoho Creatorであらかじめ作成された、指定のギャラリーアプリケーションのインストールを開始します。 | |
| getGalleryAppInstallationStatus | ギャラリーアプリケーションのインストール状況を取得します。 | |
| getSections | アプリケーションメニューに設定されているすべてのセクションと、各セクション内のコンポーネントを取得します。各コンポーネントについて、コンポーネントの種類(フォーム、レポート、ページ、チャットエージェント)や表示名などの詳細が返されます。 | |
| データ操作 | getCreatorRecords | 指定したZoho Creatorレポートからすべてのデータを取得します。 |
| getRecordByID | データIDを使用して、Zoho Creatorレポートから特定のデータを取得します。 | |
| addRecords | 指定したフォームに1件以上のデータを追加します。 | |
| updateRecords | レポート内で指定条件に一致するデータを更新します。 | |
| updateRecordByID | データIDを使用して、レポート内の特定のデータを更新します。 | |
| deleteRecords | レポート内で指定条件に一致するデータを削除します。 | |
| deleteRecordByID | データIDを使用して、指定したレポート内の特定のデータを削除します。 | |
| フォームと項目の設定 | getForms | 指定したアプリケーション内のすべてのフォームのメタデータを取得します。 |
| getFormMetadata | 詳細なフォームのメタデータを取得します。これには、すべての項目、リンク名、項目のプロパティ、ボタンなどが含まれます。 | |
| getFields | 指定したフォーム内の項目の一覧を取得します。 | |
| getPages | アプリケーション内のすべてのページのメタデータを取得します。 | |
| getReports | アプリケーション内のすべてのレポートのメタデータを取得します。 | |
| getReportMetadata | レポート名、レポートのリンク名、レポートの種類、基準フォームなど、レポートの詳細なメタデータを取得します。また、レポートで有効になっている操作も取得します。 | |
| プロセスと承認の自動化 | executeStatelessFormButton | ステートレスフォームに設定されたボタンを実行します。ステートレスフォームでは、フォームから送信されたデータは保存されず、主にワークフローやカスタム処理の実行に使用されます。 |
| executeReportCustomAction | レポートに関連付けられたカスタム処理を実行します。カスタム処理では、通知の送信、データの更新、連携の呼び出し、Delugeスクリプトの実行、レポートに設定されたその他のワークフロー処理の実行などを行えます。 | |
| getBlueprintTransitions | 特定のデータで利用可能なブループリントの遷移を取得します。このツールは、データの現在のブループリントのステージと、そのステージから実行できる遷移を返します。 | |
| executeBlueprintTransition | 特定のデータに対してブループリントの遷移を実行します。 | |
| getApprovals | アプリケーションで申請された承認リクエストを、現在のステータスとともに取得します。このツールは、関連するデータ、フォーム名、承認者、申請情報などの詳細を返します。承認処理は、アプリケーションの承認ワークフローで設定されます。 | |
| executeApprovalAction | 指定したデータに対して、承認ワークフローで設定された承認処理を実行します。ユーザーの入力に基づき、承認、却下、または承認ワークフローに設定されたその他の処理など、適切な承認処理を実行します。 | |
| 共同作業とコメント | addComment | レポート内の指定したデータにコメントを追加します。 |
| getComments | レポート内の指定したデータに関連付けられているコメントを取得します。 | |
| addReplyToComment | データ上の既存のコメントに返信を追加します。 | |
| deleteComment | データに追加された指定のコメントを削除します。 | |
| AIとチャットエージェント | getChatAgentMetadata | 表示名、リンク名、設定、チャットエージェントが実行できる操作、会話設定などのチャットエージェントのメタデータを取得します。 |
| invokeChatAgent | ユーザーの入力に基づいて操作を実行するチャットエージェントを呼び出します。 |
|
|
環境管理
|
addAppToEnvironment
|
開発、ステージング、本番の各環境にアプリケーションのインスタンスを作成します。
|
|
getAppEnvironmentStatus
|
アプリケーションの各環境(開発、ステージング、本番)の現在の状態を取得します。レスポンスには、設定状況、前回の公開状況、および本番環境と比較してステージング環境に未反映の変更があるかどうかが含まれます。
|
|
|
getAppStageChanges
|
開発環境で行われた変更のうち、ステージング環境に反映できるすべての変更の一覧を取得します。
|
|
|
getEnvironmentVersionHistory
|
指定したアプリケーションについて、ステージング環境と本番環境での公開履歴を取得します。レスポンスには、バージョン番号、公開日、変更件数、変更を公開したユーザーの情報が含まれます。
|
|
|
getProductionChanges
|
ステージング環境にある変更のうち、本番環境に展開できるすべての変更の一覧を取得します。アカウント所有者名に紐づく、利用可能なアプリケーションの変更を取得します。
|
|
|
publishStageChanges
|
指定したアプリケーションの開発環境からステージング環境に変更を公開します。
|
|
|
publishProductionChanges
|
指定したアプリケーションのステージング環境から本番環境に変更を公開します。
|
|
|
removeAppFromEnvironment
|
開発、ステージング、本番のすべての環境から指定したアプリケーションを削除します。
|
|
|
利用状況と監視
|
getUsageSummary
|
指定した環境について、データ、ストレージ、ユーザー、アプリケーション、AI呼び出し、データソース、APIなど、アカウントの利用状況に関する指標の現在の利用量と上限を返します。
|
|
getUsageTrend
|
指定した環境について、データ、ストレージ、ユーザー、アプリケーション、AI呼び出し、データソースなど、指定した利用状況の指標の日次または月次の利用データを取得します。
|
| ユーザーの意図 | アプリ | 呼び出されるツール | 実行される処理 |
|---|---|---|---|
| オンボーディング要求の作成 | Zoho Creator | addRecords | John Smithの情報を含む新しいデータを、従業員オンボーディング要求フォームに作成します。 |
| オンボーディング活動の割り当て | Zoho Creator | executeReportCustomAction | オンボーディングのワークフローを実行し、人事、IT、社内の各チームにタスクを割り当てます。 |
| 従業員の連絡先の作成 | Zoho CRM | createRecords | Zoho CRMの[連絡先]タブにJohn Smithの連絡先データを作成します。 |
| ITチームへの通知 | メール | sendEmail | ITチームにオンボーディング通知を送信します。 |
| 社内チームへの通知 | メール | sendEmail | 関連する社内チームにオンボーディング通知を送信します。 |
| 承認の開始 | Zoho Creator | getApprovals executeApprovalAction |
オンボーディング要求に設定されている承認プロセスを取得して開始します。 |
| ユーザーへのステータスの提示 | AIクライアント | 該当なし | すべてのアプリからの応答をまとめ、オンボーディングのステータスをユーザーに提示します。 |
| 用語 | 説明 |
| Zoho MCP | AIクライアントが自然言語のプロンプトを使用し、Zohoアプリや外部の業務アプリを安全に操作できるようにする連携プラットフォームです。 |
| MCPサーバー/Zoho MCPサーバー | アプリの接続、ツールの公開、認可の管理を行い、AIクライアントからアプリの機能を呼び出せるようにする、Zoho MCP内の設定可能なゲートウェイです。 |
| MCPクライアント | 適切なツールを特定して呼び出し、Model Context Protocol(MCP)に従って要求を整形してMCPサーバーに送信し、その応答をAIクライアントに返す、AIクライアント内の通信コンポーネントです。 |
| GenAIクライアント/AIクライアント | AIクライアントは、ユーザーが生成AIを操作し、コンテンツ作成、データ分析、コーディング、ワークフローの自動化など、幅広いタスクを実行できるようにするアプリです。AIクライアントには、ChatGPT、Claude、Geminiのほか、Cursor、Windsurf、Visual Studio CodeなどのAI対応IDEがあります。 |
| GenAIアシスタント | 生成AIモデルを使用してユーザーの自然言語プロンプトを理解し、要求されたタスクを実行する、AI搭載の対話型アシスタントです。 |
| AIオーケストレーター | ユーザーのプロンプトを解釈し、必要な処理を判断して、要求されたタスクを完了するための適切なツールを呼び出すAIクライアントです。 |
| ツール | MCPサーバーを通じて公開される個別のアプリ機能です。各ツールは、データの取得や作成、情報の更新、ワークフローの実行など、特定の処理に対応します。 |
| Zoho Flow | 自動ワークフローを通じてZoho製品と外部アプリを接続する、ノーコードの連携プラットフォームです。外部アプリとMCPサーバーを連携するために使用できます。これらの外部アプリは、Zoho MCPでは直接サポートされていません。 |
| サーバーURL | AIクライアントとサーバーを接続するために、MCPサーバー用に生成される一意のエンドポイントです。 |
| APIキー | MCPサーバーに関連付けられた一意の認証キーです。サーバーURLに埋め込まれ、AIクライアントからの要求を認証するために使用されます。 |
| Zoho MCP管理者 | MCPサーバーの作成と管理、アプリとツールの設定、認可の確立、接続されたアプリへのAIアクセスの制御を行う権限を持つユーザーです。 |