Zoho MCP 実装ガイド

Zoho MCP 実装ガイド

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

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

Zoho MCPサーバーの作成

Zoho MCPサーバーを作成するには：
  1. Zoho MCPコンソールに移動します。
  2. ［MCPサーバーを作成］をクリックします。
  3. MCPサーバーの名前を入力し、［作成］をクリックします。

MCPサーバーが作成されます。

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

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

ここでは、事前設定済みサーバー「CRMデータ＆メタデータ操作」を例に、必要な手順を説明します。

事前設定済みサーバーを使用するには：
  1. ［サーバーを作成］をクリックします。
  2. 使用する事前設定済みサーバーをクリックします。
  3. サーバー名、実装されるサービス、ワークフローの説明、MCPサーバーに設定されるMCPツールの一覧を確認できます。
  4. ［作成］をクリックします。

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

MCPサーバーへのツールの設定

MCPツールは、各サービスからMCPサーバーに提供されます。各ツールでは、特定の操作を実行できます。MCPサーバーに設定されたMCPツールにより、MCPクライアントがサービス内で実行できる操作が決まります。

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

Zohoの標準サービスのツールをZoho MCPサーバーに追加

Zohoの標準サービスからMCPツールを追加するには：
  1. MCPサーバーを作成すると、コンソールの［ツール］セクションにアクセスできるようになります。
  2. ［ツールを追加］をクリックします。
  3. サービス一覧をスクロールするか、フィルターと検索欄を使用して、必要なZoho製品を検索できます。（この例では、Zoho CRMのツールを設定します。）
  4. 必要なツールを検索するか、実行したい操作に一致するツールを探し、ツール名の横にあるチェックボックスをクリックします。
  5. 必要なツールをすべて追加したら、［今すぐ追加］をクリックします。
  6. 他のサービスからMCPツールを追加する場合は、［さらにツールを追加］をクリックし、手順3～5を繰り返します。
ヒント：ツール数は300以下に抑えることをおすすめします。これにより、MCPクライアントがハルシネーションを起こさず、必要な操作を完了しやすくなります。

外部サービスのツールをZoho MCPサーバーに追加

外部サービスからMCPツールを追加するには：
  1. MCPサーバーを作成すると、コンソールの［ツール］セクションにアクセスできるようになります。
  2. ［ツールを追加］をクリックします。
  3. サービス一覧をスクロールするか、フィルターと検索欄を使用して、必要な外部サービスを検索できます。（この例では、Textitのツールを設定します。）
  4. 必要なツールを検索するか、実行したい操作に一致するツールを探し、ツール名の横にあるチェックボックスをクリックします。
  5. 必要なツールをすべて追加したら、［今すぐ追加］をクリックします。
  6. 他のサービスからMCPツールを追加する場合は、［さらにツールを追加］をクリックし、手順3～5を繰り返します。
ヒント：ツール数は300以下に抑えることをおすすめします。これにより、MCPクライアントがハルシネーションを起こさず、必要な操作を完了しやすくなります。

MCPサーバーとMCPクライアントの接続

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

MCPサーバーとClaudeの接続

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

MCPサーバーとChatGPTの接続

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

MCPサーバーとCursorの接続

自動設定を使用したMCPサーバーとCursorの接続

MCPサーバーを追加する際に手動手順が必要な他のMCPクライアントとは異なり、Cursorでは自動設定を利用できます。

自動設定を使用してMCPサーバーをCursorに接続するには：
  1. MCPコンソールの［接続］セクションに移動します。
  2. MCPクライアントの一覧からCursorを選択します。
  3. ［Cursorに追加］をクリックします。
MCPサーバーをCursorに追加するために必要な設定は、自動的に処理されます。

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

MCPサーバーとCursorの手動接続

MCPサーバーを手動で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クライアントに貼り付けると、MCP URLの値がJSONスニペットに自動的に追加されます。

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

MCPサーバーとWindsurfの接続

MCPサーバーを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', //Replace MCP URLに置き換えます
  8. '--transport',
  9. 'http-only'
  10. ]
  11. }
  12. }
ヒント：コンソールの［接続］セクションからJSONスニペットをコピーした場合、MCPクライアントに貼り付けると、MCP URLの値がJSONスニペットに自動的に追加されます。

［保存］をクリックすると、ローカルホストでZoho MCPの認証画面が表示されます。［許可］をクリックします。

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

MCPサーバーとVS Codeの接続

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

MCPサーバーを追加する際に手動手順が必要な他のMCPクライアントとは異なり、VS Codeでは自動設定を利用できます。

自動設定を使用してMCPサーバーをVS Codeに接続するには：
  1. MCPコンソールの［接続］セクションに移動します。
  2. MCPクライアントの一覧からVS Codeを選択します。
  3. ［VS Codeに追加］をクリックします。
MCPサーバーをVS Codeに追加するために必要な設定は、自動的に処理されます。

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

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

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

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

カスタムAIモデル、LLM、AI対応IDE、またはツールがMCPサーバーの追加に対応し、HTTPまたはStreamable Transport経由の接続をサポートしている場合は、以下の手順でZoho MCPサーバーを追加できます。
  1. ツールでAgentモードまたは同等のモードが有効になっていることを確認します。
  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. ポップアップで［削除］をクリックして、ツールを削除します。

ツールが削除されます。

共同作業者の使用

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

共同作業者の招待

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

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

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

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

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

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

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

共同作業者の役割の編集

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

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

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

役割が編集されます。

共同作業者の削除

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

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

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

組織の削除

組織を削除できるのはスーパー管理者のみです。組織を削除する前に、すべての共同作業者を削除していることを確認してください。

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

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

組織が削除されます。

ログの使用

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

ログにアクセスして使用するには、次の手順を実行します。
  1. Zoho MCPコンソールの［ログ］セクションに移動します。
  2. フィルターオプションを使用して、必要な項目を選択します。
    1. ［タイムゾーン］
    2. ［ステータス］（成功/Failure)
    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サーバーが完全に削除されます。