Zoho MCP 実装ガイド

Zoho MCP 実装ガイド

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

このヘルプドキュメントでは、Zoho MCPサービスの各種機能を実装するために必要な手順について説明します。

Zoho MCP Serverの作成

Zoho MCP Serverを作成するには、次の手順を実行します。
  1. Zoho MCP Consoleに移動します。
  2. ［MCP Serverを作成］をクリックします。
  3. MCP Serverの名前を入力し、［作成］をクリックします。

MCP serverが作成されます。

事前設定済みサーバーの作成

事前設定済みサーバーでは、特定のワークフローを実行するために必要なMCP Toolsが設定された、すぐに使用できるMCP serversを利用できます。

ここでは、CRM Data & Metadata Operationsの事前設定済みサーバーを使用して、必要な手順を説明します。

事前設定済みサーバーを使用するには、次の手順を実行します。
  1. ［サーバーを作成］をクリックします。
  2. 必要な［事前設定済みサーバー］をクリックします。
  3. サーバー名、実装されているサービス、ワークフローの説明、MCP serverに設定されるMCP Toolsの一覧を確認できます。
  4. ［作成］をクリックします。

事前設定済みサーバーが作成され、指定したワークフローを実行するためにサーバーへ追加されたツールの完全な一覧を確認できます。

MCP Serverへのツールの設定

MCP Toolsは、各サービスからMCP serverに提供されます。各ツールでは、特定の操作のみを実行できます。MCP serverに設定されたMCP Toolによって、MCP Clientがサービス内で実行できる操作が決まります。

すべてのMCP Toolsの一覧は、インタラクティブマニュアルで確認できます。

Zoho MCP ServerへのZoho標準サービスツールの追加

Zoho標準サービスからMCP toolsを追加するには、次の手順を実行します。
  1. MCP serverを作成すると、コンソールの［ツール］セクションにアクセスできるようになります。
  2. ［ツールを追加］をクリックします。
  3. サービスの一覧をスクロールするか、フィルターと検索項目を使用して、必要なZoho製品を検索できます。（この例では、Zoho CRMのツールを設定します。）
  4. 必要なツールを検索するか、実行したい操作に一致するツールを見つけて、ツール名の横にあるチェックボックスをクリックします。
  5. 必要なツールをすべて追加したら、［今すぐ追加］をクリックします。
  6. 他のサービスからMCP Toolsを追加する場合は、さらにツールを追加をクリックし、手順3〜5を繰り返します。
ヒント：ツール数は300以内に抑えることをおすすめします。これにより、MCP Clientが誤った応答を生成するのを防ぎ、必要な操作を完了しやすくなります。

Zoho MCP Serverへの外部サービスツールの追加

外部サービスからMCP toolsを追加するには、次の手順を実行します。
  1. MCP serverを作成すると、コンソールの［ツール］セクションにアクセスできるようになります。
  2. ［ツールを追加］をクリックします。
  3. サービスの一覧をスクロールするか、フィルターと検索項目を使用して、必要な外部サービスを検索できます。（この例では、Textitのツールを設定します。）
  4. 必要なツールを検索するか、実行したい操作に一致するツールを見つけて、ツール名の横にあるチェックボックスをクリックします。
  5. 必要なツールをすべて追加したら、［今すぐ追加］をクリックします。
  6. 他のサービスからMCP Toolsを追加する場合は、［さらにツールを追加］をクリックし、手順3〜5を繰り返します。
ヒント：ツール数は300以内に抑えることをおすすめします。これにより、MCP Clientが誤った応答を生成するのを防ぎ、必要な操作を完了しやすくなります。

MCP ServerとMCP Clientの接続

このヘルプセクションでは、MCP Serverを次のような一般的なMCP Clientsに接続するために必要な手順を説明します。
  1. Claude.ai
  2. ChatGPT
  3. Cursor
  4. Windsurf
  5. VS Code
情報：これらの手順は、MCP Consoleの［接続］セクションにも記載されています。

MCP ServerとClaudeの接続

MCP serverをClaudeに接続するには、次の手順を実行します。
  1. MCP Consoleの［接続］セクションに移動します。
  2. ［MCP URL］をコピーします。
  3. http://claude.ai/settings/integrationsに移動します。
  4. ［カスタマイズ］をクリックします。
  5. ［コネクター］をクリックします。
  6. 新しいWebコネクターを追加します。MCP serverの名前を入力し、コピーしたMCP URLを貼り付けます。これで、MCP serverがMCP Clientに追加されます。接続を完了するには、ClaudeへのMCP Server接続を承認する必要があります。
  7. コネクター一覧からMCP serverにアクセスし、［接続］をクリックします。
  8. 承認手順に従うと、MCP serverが接続され、使用できるようになります。
これで、Claudeの人工知能を活用して、Zoho MCP serverに設定されたMCP Toolsで許可されているワークフローを実行できます。

MCP ServerとChatGPTの接続

  1. Cursorの［プロフィール］→［設定］→［アプリ］セクションに移動し、［アプリを作成］をクリックします。
  2. サーバーの名前と説明を入力します。
  3. ［MCP Server URL］を貼り付けます。
  4. 認証タイプとして［OAuth］を選択します。
  5. ［作成］をクリックします。
  6. ローカルホストのZoho MCP承認画面に移動します。［許可］をクリックします。

MCP ServerとCursorの接続

自動設定を使用したMCP ServerとCursorの接続

MCP serversの追加に手動手順が必要な他のMCP Clientsとは異なり、Cursorでは自動設定を利用できます。

自動設定を使用してMCP serverをCursorに接続するには、次の手順を実行します。
  1. MCP consoleの［接続］セクションに移動します。
  2. MCP Clientsの一覧から［Cursor］を選択します。
  3. ［Cursorに追加］をクリックします。
MCP serverをCursorに追加するために必要な設定は、自動的に処理されます。

ただし、CursorがMCP serverとそこに設定されたツールにアクセスするには、接続し、必要な承認を行う必要があります。
これで、Cursorの人工知能を活用して、Zoho MCP serverに設定されたMCP Toolsで許可されているワークフローを実行できます。

MCP ServerとCursorの手動接続

MCP ServerをCursorに手動で接続するには、次の手順を実行します。
  1. Cursorの［設定］セクションにある［ツールと連携］タブに移動し、［カスタムMCPを追加］をクリックします。
  2. mcp_config.jsonファイルが開きます。次のコードスニペットをファイルに貼り付けます。
  1. {
  2. 'mcpServers': {
  3. 'ZohoMCP': {
  4. 'command': 'npx',
  5. 'args': [
  6. 'mcp-remote',
  7. 'YOUR-MCP-URL', // MCP URLに置き換えます
  8. '--transport',
  9. 'http-only'
  10. ]
  11. }
  12. }
  13. }
［保存］をクリックすると、ローカルホストのZoho MCP承認画面に移動します。［許可］をクリックします。

ヒント：コンソールの［接続］セクションからJSONスニペットをコピーすると、MCP Clientに貼り付ける際に、MCP URLの値がJSONスニペットに自動的に追加されます。

これで、Cursorの人工知能を活用して、Zoho MCP serverに設定されたMCP Toolsで許可されているワークフローを実行できます。

MCP ServerとWindsurfの接続

MCP ServerをWindsurfに接続するには、次の手順を実行します。
  1. Windsurfの［設定］に移動します。
  2. 設定の検索バーで「mcp」を検索し、［プラグインを管理］をクリックします。
  3. ［未加工の設定を表示］をクリックします。
  4. mcp_config.jsonファイルが開きます。このファイルに次のコードスニペットをコピーして貼り付け、mcp-remote jsonキーの値としてMCP URLを入力します。
  1. {
  2. 'mcpServers': {
  3. 'ZohoMCP': {
  4. 'command': 'npx',
  5. 'args': [
  6. 'mcp-remote',
  7. 'YOUR-MCP-URL', //MCP URLに置き換えます
  8. '--transport',
  9. 'http-only'
  10. ]
  11. }
  12. }
ヒント：コンソールの［接続］セクションからJSONスニペットをコピーすると、MCP Clientに貼り付ける際に、MCP URLの値がJSONスニペットに自動的に追加されます。

［保存］をクリックすると、ローカルホストのZoho MCP承認画面に移動します。［許可］をクリックします。

これで、Windsurfの人工知能を活用して、Zoho MCP serverに設定されたMCP Toolsで許可されているワークフローを実行できます。

MCP ServerとVS Codeの接続

自動設定を使用したMCP ServerとVS Codeの接続

MCP serversの追加に手動手順が必要な他のMCP Clientsとは異なり、VS Codeでは自動設定を利用できます。

自動設定を使用してMCP serverをVS Codeに接続するには、次の手順を実行します。
  1. MCP consoleの［接続］セクションに移動します。
  2. MCP Clientsの一覧から［VS Code］を選択します。
  3. ［VS Codeに追加］をクリックします。
MCP serverをVS Codeに追加するために必要な設定は、自動的に処理されます。

ただし、VS CodeがMCP serverとそこに設定されたツールにアクセスするには、接続し、必要な承認を行う必要があります。
これで、Zoho MCPサーバーで設定されたMCPツールの許可範囲内で、Copilotの人工知能を活用してVS Codeでワークフローを実行できるようになります。

MCPサーバーのVS Codeへの手動接続

MCPサーバーをVS Codeに接続するには、次の手順を実行します。
  1. GitHub Copilotがインストールされ、有効になっており、［エージェント］モードに設定されていることを確認します。
  2. VS Codeの［コマンドパレット］にアクセスします。
    1. Macの場合：⇧ + ⌘ + P
    2. Windowsの場合：Ctrl + Shift + P
  3. ［MCP:Add Server...］を検索します。
  4. ［HTTP (HTTP or Server-Sent Events)］を選択し、Enterを押します。
  5. ［サーバーキー］入力項目にMCPサーバーのURLを貼り付け、Enterを押します。
  6. MCPサーバーの名前を入力し、Enterを押します。
  7. 接続を認可するために必要な認証手順に従います
これで、Zoho MCPサーバーで設定されたMCPツールの許可範囲内で、Copilotの人工知能を活用してVS Codeでワークフローを実行できるようになります。

MCPサーバーのカスタムMCPクライアントへの接続

カスタムAIモデル、LLM、AI対応IDE、またはツールがMCPサーバーに対応しており、HTTPまたはStreamable Transport経由の接続をサポートしている場合は、次の手順でZoho MCPサーバーを追加できます。
  1. エージェントモードまたは同等のモードがツールで有効になっていることを確認します。
  2. mcp_config.jsonファイルを作成するか、自動化ツールで該当するファイルを検索して特定します。
  3. 次のコードスニペットをファイルに貼り付けます。
  1. {
  2. 'mcpServers': {
  3. 'ZohoMCP': {
  4. 'command': 'npx',
  5. 'args': [
  6. 'mcp-remote',
  7. 'YOUR_MCP_URL', // ご利用のMCP URLに置き換えます
  8. '--transport',
  9. 'http-only'
  10. ]
  11. }
  12. }
  13. }
ヒント：コンソールの［接続］セクションからJSONスニペットをコピーした場合、MCPクライアントに貼り付ける際に、MCP URLの値がJSONスニペットに自動的に追加されます。

これらの手順を実行すると、MCPサーバーがツールに追加されます。問題が解決しない場合は、MCPサポートまでお問い合わせください。

MCPツールの管理

Zoho MCPコンソールでは、設定済みのツールを削除できます。カスタムMCPサーバーと事前設定済みサーバーの両方で、ツールを削除してMCPツールを再設定できます。

MCPツールを削除するには、次の手順を実行します。
  1. 設定済みツールの一覧は、MCPコンソールの［ツール］セクションで確認できます。
  2. 対象のツールの横にある省略記号アイコンをクリックし、［削除］をクリックします。
  3. ポップアップで［削除］をクリックして、ツールを削除します。

ツールが削除されます。

共同作業者の利用

共同作業者は、信頼できるメンバーに招待メールを送信し、組織に追加できるZoho MCPサービスの機能です。これにより、共同作業者はMCPサーバーを個別に作成しなくても、MCPリソースにアクセスできます。

共同作業者の招待

Zoho MCPコンソールから信頼できるメンバーに招待メールを送信し、組織の共同作業者として追加できます。

チームメンバーを招待するには、次の手順を実行します。

1. ユーザープロフィールをクリックし、［共同作業者］をクリックします。

2. ［ユーザーを招待］をクリックします。

3. チームメンバーのメールアドレスを入力し、［役割］ドロップダウンで必要な役割を割り当てます。

4. ［招待］をクリックします。

チームメンバーが共同作業者になります。送信された招待メールからアクセスを確認すると、ステータスが有効になります。

共同作業者の役割の編集

共同作業者の役割を変更するには、次の手順を実行します。

1. 対象の共同作業者の横にある省略記号アイコンをクリックし、［編集］をクリックします。

2. 必要な変更を行い、［保存］をクリックします。

役割が変更されます。

共同作業者の削除

組織から共同作業者を削除するには、次の手順を実行します。
1. 対象の共同作業者の横にある省略記号アイコンをクリックし、［削除］をクリックします。

2. ポップアップで［削除］をクリックして、操作を確定します。

共同作業者が組織から削除されます。

組織の削除

組織を削除できるのは特権管理者のみです。組織を削除する前に、すべての共同作業者を削除していることを確認する必要があります。

組織を削除するには、次の手順を実行します。
1. 省略記号アイコンをクリックし、［組織を削除］をクリックします。

2. ［組織を削除］をクリックして、選択を確定します。

組織が削除されます。

ログの利用

ログは、Zoho MCPサーバーに設定されたMCPツールを通じて行われたすべてのアクセスをインデックス化するZoho MCPの機能です。

ログにアクセスして利用するには、次の手順を実行します。
  1. Zoho MCPコンソールの［ログ］セクションに移動します。
  2. フィルターオプションを使用して、必要な項目を選択します。
    1. タイムゾーン
    2. ステータス（成功／失敗）
    3. 対象のMCPツール
  3. 必要なZUIDと実行IDがある場合は、それらも入力できます。
  4. ［検索］をクリックします。

必要なログが一覧表示されます。

メモ：ログの保持期間は30日間です。この期間を過ぎると、順次削除されます。

認可の管理

認可種別の切り替え

Zoho MCPサービスでは、ZohoサービスのMCPツールを認可するために、オンデマンドで認可と接続経由で認可の2種類の認可種別から選択できます。オンデマンドで認可は、初期設定の認可種別です。外部サービスでは、接続経由で認可のみを提供しています。


認可種別を切り替えるには、次の手順を実行します。
  1. ［接続］セクションに移動し、［Zohoサービス］を選択します。
  2. ［編集］をクリックし、必要な認可種別を選択します。
  3. ［更新］をクリックします。
  4. 変更した認可種別を適用するには、［接続］の横にある省略記号アイコンをクリックし、［認可］をクリックします。

選択した認可種別が適用されます。

認可の取り消し

Zoho MCPサービスでは、ユーザーのMCPツールの認可を取り消すことができます。

Zohoサービスのネイティブ認可の取り消し

認可を取り消すには、次の手順を実行します。
  1. 対象のユーザー詳細の横にある省略記号アイコンをクリックし、［取り消し］をクリックします。
  2. ［取り消し］をクリックして、操作を確定します。

認可が取り消されます。

再度認可するには、未接続の接続の横にある省略記号アイコンをクリックし、［認可］をクリックします。

外部サービスとの接続の管理

外部サービスとのすべての接続は、［接続］セクションの［外部サービス］タブに一覧表示されます。



Zohoサービスのツールで利用できる［取り消し］や［認可］などの操作は、外部サービスとの接続でも利用できます。また、外部サービスとの接続を［削除］することもできます。

外部サービスの接続を削除するには、次の手順を実行します。
  1. 対象のユーザー詳細の横にある省略記号アイコンをクリックし、［削除］をクリックします。
  2. ［削除］をクリックして、操作を確定します。
接続が削除されます。

Zoho MCPサーバーの管理

Zoho MCPコンソールのホームページでは、作成したすべてのサーバーと事前設定済みサーバーの一覧をいつでも確認できます。


Zoho MCPサーバーを作成した後は、設定の変更、一時的な無効化、完全な削除を行えます。

Zoho MCPサーバーの無効化／再有効化

Zoho MCPサーバーを無効にするには、次の手順を実行します。
  1. 対象のサーバーの横にある省略記号アイコンをクリックし、［無効にする］をクリックします。
  2. ［無効にする］をクリックして、選択を確定します。
MCPサーバーが無効になります。無効になっているZoho MCPサーバーを再度有効にするには、上記と同じ手順に従い、代わりに［有効にする］をクリックします。

Zoho MCPサーバーの削除

Zoho MCPサーバーを削除するには、次の手順を実行します。
  1. 対象のサーバーの横にある省略記号アイコンをクリックし、［削除］をクリックします。
  2. ［削除］をクリックして、選択を確定します。
Zoho MCPサーバーは完全に削除されます。