Zoho MCP for Biginの導入ガイド

Zoho MCP for Biginの導入ガイド

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

概要

Zoho MCP(Model Context Protocol)は、AI を使って Bigin と連携する新しい方法を提供します。従来の API や手動でのデータ取得に依存する代わりに、Zoho MCP を利用すると、ChatGPT、Claude、Gemini CLI、VS Code などの MCP クライアント(AI ツール)が、Bigin のデータやツールと安全に連携できます。この連携により、MCP クライアントはデータを取得し、ワークフローをトリガーし、UI では対応しきれない高度なフィルタリングを適用し、繰り返し作業の自動化を支援できます。これらはすべて、Bigin に組み込まれた権限設定とセキュリティに準拠して実行されます。

このセクションでは、Bigin で Zoho MCP を使い始めるために必要な内容を一通り説明します。

What is Zoho MCP?

Model Context Protocol(MCP)は、アプリケーションが大規模言語モデル(LLM)と接続できるようにするオープンソース標準です。MCP を通じて、AI ツール(MCP クライアント)は、サーバーからツール、データ、アクションを構造化かつ安全な方法で要求できます。

Zoho MCPは、このプロトコルを Zoho が実装したものです。Zoho およびサードパーティアプリケーション全体のデータに対して、制御された安全なアクセスを提供するよう設計されています。Zoho MCP を使用すると、MCP サーバーを作成し、それを MCP クライアントに接続できます。これにより、自然言語で指示を出して、Zoho 製品や対応するサードパーティサービス全体のタスクを自動化できます。

たとえば、Bigin にアクセスしていて、オープン中の案件を確認したい場合、AI ツールに次のように依頼できます。

`Bigin のオープン中の案件をすべて表示して、すぐに対応が必要なものをハイライトして。`



AI ツールは Zoho MCP を通じてデータを安全に取得し、複数の画面を手動で操作することなく、必要な情報を提示します。

Zoho MCP は、アプリ間をまたぐワークフローの連携も行えます。たとえば、チームが Bigin で案件の進捗を管理し、Zoho Projects でプロジェクト実行を行い、Cliq でプロジェクトのオンボーディング更新を行っているとします。この場合、AI ツールに次のように依頼して、これらをまとめて処理できます。

`「モバイルアプリ開発」の案件をクローズし、Zoho Projects にプロジェクトをオンボードして、Cliq の「Project Onboarding」チャンネルにプロジェクト詳細付きでメッセージを投稿して。`



AI ツールは 3 つのアプリケーションすべてから必要な情報を取得し、統合された更新情報を返すか、必要なアクションを実行します。どこまで実行できるかは、Zoho MCP サーバーで有効にしているツールに依存します。

Why use Zoho MCP with Bigin?

Zoho MCP を使うと、「クリックして探す」作業から「指示して分析する」スタイルへ移行でき、Bigin をよりスマートに活用できます。MCP クライアントがコンテキストを理解し、必要な情報を取得し、代わりにアクションを実行できるようにすることで、Bigin の利用効率が大きく向上します。メニューをたどったり、レポートを実行したり、複数のツールを切り替えたりする代わりに、達成したいことをそのまま指示するだけで済みます。

Zoho MCP を Bigin と接続すると、MCP クライアントはコンテキストを理解するアシスタントとなり、レコードの取得、パイプラインの要約、活動の分析、指示に基づく更新内容の下書きなどを行えます。たとえば、「期限超過の案件を表示して」「Ted Watson 向けのフォローアップメールを下書きして」「直近 2 週間のパイプラインのパフォーマンスを説明して」と依頼すると、MCP クライアントは指示されたアクションを実行するか、すぐにインサイトを提示します。

さらに Zoho MCP を利用しても、AI がアクセスできる範囲は常にあなたが完全に制御でき、機密性の高い認証情報はすべて Zoho 環境内で安全に保持されます。これにより、手作業では実行が難しいワークフローを実行しながらも、安全かつ信頼性の高い連携が可能になります。

Prerequisites

Bigin 用に Zoho MCP を設定する前に、次の条件を満たしている必要があります。
  1. Zoho アカウントを保有し、Bigin にアクセスできること。
  2. 組織で Zoho MCP が利用可能であること。
  3. ChatGPT、Gemini CLI、Claude Desktop など、カスタム MCP コネクタをサポートする有料プランの AI ツールを利用していること。
  4. MCP ツールへアクセスするために、必要な権限または接続が承認されていること。

Configure your Zoho MCP Server

必要な前提条件を満たしたら、以下の手順に従って Zoho MCP サーバーを設定します。

新しい Zoho MCP サーバーを設定するには
  1. Zoho MCPポータルにアクセスします。
  2. Welcome to Zoho MCPセクションで、新しい MCP サーバーの名前を入力し、Create serverをクリックします。

  3. サーバー名には特殊文字やスペースを含めないようにしてください。
  4. Bigin 用に必要なツールを設定するには、Add Toolsをクリックします。

  5. 設定したいサービスを選択します(ここでは Bigin)。

  6. サービスをすばやく見つけるには、検索バーを使用するか、Categoryフィルターを適用することもできます。
    Notes
    メモ:Zoho サービスのツールは、サーバーに追加されたタイミングでオンデマンドにより認可されます。必要に応じて、Connectionタブから認可方法を「Authorize via Connection」に切り替えることもできます。
  7. 利用可能なツールの一覧が表示されます。これらのツールは、プロンプトで要求されたアクションを実行するために必要なコンテキストとアクセス権を提供します。必要なツールを選択し、Add Nowをクリックします。

  8. 選択したツールが MCP サーバーに追加されます。

  9. 同じサービス(ここでは Bigin)にさらにツールを追加する場合や、同じ MCP サーバー内で他の Zoho サービスのツールを設定する場合は、Add More Toolsをクリックし、Bigin または他の Zoho サービスを選択して、必要なツールを追加します。

  10. また、Zoho エコシステム以外のサードパーティアプリケーションと連携する必要がある場合は、同じ MCP サーバー内で利用可能なサードパーティサービスのツールも設定できます。

    これにより、単一の MCP サーバーを通じて、複数の Zoho アプリケーションやサードパーティサービスと AI ツールがシームレスに連携できる、統合されたクロスプロダクト環境を構築できます。選択したすべてのツールが Zoho MCP サーバーに追加されました。
Zoho MCP サーバーは、MCP クライアントとの接続準備が整いました。

Connect MCP to Supported AI tools

Zoho MCP を AI ツールに接続する前に、まず MCP サーバー URL をコピーする必要があります。

MCP サーバー URL をコピーするには
  1. Zoho MCP ポータルを開き、対象の MCP サーバーを選択します。
  2. Connectセクションに移動します。

  3. ページに表示されている MCP URL をコピーします。

この URL は、AI ツール側の設定時に使用します。

MCP URL をコピーしたら、任意の対応 AI ツールに設定できます。手順はクライアントごとに異なります。以下のセクションでは、Zoho MCP を Claude、ChatGPT、Gemini CLI、Cursor、Windsurf、Visual Studio Code と接続する方法を説明します。
Notes
メモ
カスタム MCP 機能は、一般的に AI ツールのプレミアムプラン(Claude Pro など)で利用可能です。任意の AI ツールで Bigin 用の Zoho MCP を設定する前に、その AI ツールのプランがカスタム MCP コネクタまたはアプリをサポートしていることを確認してください。

Claude

Claude と接続するには:
  1. Claude で Settings > Connectorsを開きます(Web または Desktop)。

  2. Add custom connectorをクリックします。

  3. Add custom connectorダイアログで任意の名前を入力し、Zoho MCP ポータルからコピーしたMCP Server URLを貼り付けます。

  4. Addをクリックします。
  5. コネクタ一覧でConnectをクリックし、表示される手順に従って Bigin アカウントへのアクセスを承認します。

承認が完了すると、自然な指示で Claude から Bigin のデータにアクセスできるようになります。

ChatGPT (Developer Mode)

ChatGPT と接続するには:
  1. ChatGPT(Web)でProfile > Settingsを開きます。

  2. Apps > Advanced Settingsセクションに移動します。

  3. Developer modeトグルを有効にします。Developer mode を有効にすると、Create appボタンが表示されます。

  4. Create appをクリックします。
  5. New Appダイアログで、アイコンをアップロードし、任意の名前と説明を入力して、Zoho MCP ポータルからコピーしたMCP Server URLを貼り付けます。

  6. ChatGPT によって表示されるカスタム MCP サーバーに関する情報を確認したら、I understand and want to continueというチェックボックスを選択します。

  7. Createをクリックします。認可を求められたら、画面の指示に従って Bigin アカウントへのアクセスを許可します。
  8. 認可が完了したら、ChatGPT で新しいチャットを開き、接続済みのカスタム Bigin MCP アプリを選択します。

これで、Bigin でアクションを実行するようにプロンプトを送信できるようになります。

Gemini CLI

Gemini CLI(macOS および Windows)と接続するには:
  1. macOS の場合はTerminal、Windows の場合はCommand Promptまたは Powershell を開きます。
  2. 次のコマンドを使用して、任意のディレクトリに Gemini CLI をインストールします。
  3. npm install -g @google/gemini-cli
  4. Gemini CLI で認証を行います。
  5. gemini auth login
  6. 次のコマンドを実行して、設定ファイル内で Zoho MCP for Bigin サーバーを構成します。
  7. macOS の場合
    code ~/.gemini/settings.json
    Windows の場合
    code $env:USERPROFILE\.gemini\settings.json
  8. 開いたsettings.jsonファイルに、MCP サーバーの設定を追加します。
  9. {
    'mcpServers': {
    'BiginMCP': {
    'httpUrl': '<MCP_URL_HERE>'
    }
    },
    'security': {
    'auth': {
    'selectedType': 'oauth-personal'
    }
    }
    }
  10. <MCP_URL_HERE>を、Zoho MCP ポータルからコピーした MCP Server URL に置き換えます。
  11. settings.jsonファイルを保存して閉じます。
  12. Gemini CLI を起動します。
  13. gemini
  14. Gemini CLI の起動時に自動で認可処理が開始されます。開始されない場合は、Gemini CLI のプロンプトで次のコマンドを入力します。
  15. /mcp auth <MCP_Server_Name>
    Notes
    メモ
    <MCP_Server_Name>はコマンド実行時に CLI 上に表示され、settings.jsonファイルで設定した名前に基づきます。
  16. プロンプトが表示されたら、Yesを選択して認証ページをブラウザーで開きます。ブラウザーの指示に従って、Bigin アカウントへのアクセスを許可します。
認可が完了したら、CLI に戻り、自然な言語のプロンプトで Bigin のアクションを実行できます。

Cursor

Cursor と接続するには:
  1. Cursor Desktop でSettingsを開くか、Ctrl + Shift + Jを押します。

  2. Tools & MCPセクションに移動します。

  3. Add Custom MCPをクリックします。

  4. 開いたmcp.jsonファイルに、次の設定を追加します。
  5. {
    'mcpServers': {
    'BiginMCP': {
    'url': '<MCP_URL_HERE>'
    }
    }
    }

  6. <MCP_URL_HERE>を、Zoho MCP ポータルからコピーした MCP Server URL に置き換えます。

  7. mcp.jsonファイルを保存して閉じます。
  8. Installed MCP Serversの下で、設定した MCP のConnectをクリックします。画面の指示に従って、Bigin アカウントへのアクセスを許可します。

認可が完了したら、Cursor で新しいチャットを開き、Bigin でアクションを実行するようにプロンプトを送信できます。

Windsurf

Windsurf と接続するには:
  1. Windsurf Desktop でSettings > Windsurf Settingsを開くか、Ctrl + ,を押します。

  2. Cascadeセクションに移動し、MCP Serversの横にあるOpen MCP Marketplaceをクリックします。

  3. Installed/MCPsの下で、設定アイコンをクリックしてmcp_config.jsonファイルを開きます。

  4. ファイルに次の設定を追加します。
  5. {
    'mcpServers': {
    'BiginMCP': {
    'command': 'npx',
    'args': [
    'mcp-remote',
    '<MCP_URL_HERE>',
    '--transport',
    'http-only'
    ]
    }
    }
    }

  6. <MCP_URL_HERE>を、Zoho MCP ポータルからコピーした MCP Server URL に置き換えます。

  7. ファイルを保存します。認可を求められたら、画面の指示に従って Bigin アカウントへのアクセスを許可します。
認可が完了したら、Windsurf で新しいチャットを開き、Bigin でアクションを実行するようにプロンプトを送信できます。

Visual Studio Code

VS Code と接続するには:
  1. Visual Studio Code を開き、Ctrl + Shift + PCommand Paletteを開きます。
  2. MCP: Add Server...と入力し、Enterを押します。

  3. HTTP (HTTP or Server-Sent Events)を選択し、Enterを押します。

  4. Zoho MCP ポータルからコピーした MCP Server URL を貼り付け、Enterを押します。

  5. 任意のサーバー名を入力し、Enterを押します。

  6. プロンプトが表示されたら、Bigin アカウントへのアクセスを許可するための認可フローに従います。

  7. 認可後、GitHub Copilot を開き、toolモードに設定されていることを確認します。

これで、自然な指示を使って Copilot に Bigin のアクションを実行させることができます。

Manage Connections

接続は、MCP サーバーに追加されたツールの認可レイヤーとして定義されます。各ツールが AI ツールと安全に連携できるようにするために、必要な認証情報、トークン、認証ワークフローを管理します。

Zoho MCP は 2 種類の認可方式をサポートしており、Zoho サービスとサードパーティサービスの両方を管理できます。

オンデマンド認可(デフォルト)
  1. Zohoサービスから追加されたツールに使用されます。
  2. 各ユーザーが自分のアカウント認証情報を使って個別にアクセスを承認します。
  3. メンバーごとに独立したアクセス制御が必要な場合に適しています。
  4. あなたと他のユーザーが同じ Zoho MCP サーバーに接続する場合、それぞれが個別に承認プロセスを完了する必要があります。アクセスと操作はアカウント単位で認証されるため、各ユーザーが自分の権限を付与することが保証されます。
接続による承認
  1. サードパーティサービスから追加されたツールに対して有効にできます。
  2. OAuth のアクセス/リフレッシュトークンを使用して管理される、組織レベルの承認に依存します。
  3. 個別の承認を求めずに、チームメンバーに承認を拡張したいスーパー管理者に適しています。
  4. あなたがスーパー管理者で、組織のメンバーが同じ Zoho MCP サーバーに接続している場合、OAuth のアクセス/リフレッシュトークンを使用してツールを承認することを選択できます。このオプションを有効にすると、信頼されたユーザーは個別の承認を行わなくても、MCP サーバー経由で操作を実行できます。

接続による承認を有効にする

既定では、Zoho サービスからツールを設定するときにオンデマンド承認が有効になります。

接続による承認に切り替えるには:
  1. MCP ポータルの接続セクションに移動します。
  2. 編集をクリックします。

  3. 接続による承認を選択し、更新をクリックします。

  4. 承認するには、承認済みツール一覧に移動し、対象の接続の横にある三点リーダーアイコンをクリックして承認を選択し、表示される手順に従ってサービスへのアクセスを許可します。

有効化後、この MCP サーバー経由で実行されるすべての操作は、スーパー管理者の OAuth トークンを使用します。

接続を取り消すには:
  1. MCP ポータルの接続セクションに移動します。
  2. 承認済みツール一覧に移動し、対象の接続の横にある三点リーダーアイコンをクリックして取り消しを選択します。

  3. 確認のため取り消しをクリックします。
取り消した接続は、いつでも再度承認できます。

サードパーティサービス接続

サードパーティサービスからツールを MCP サーバーに追加すると、Zoho Flow の安全な認可プロセスを通じて、サードパーティサービス接続が有効化および承認されます。この接続は必要に応じて取り消したり削除したりできます。

サードパーティ接続を取り消すには:
  1. MCP ポータルの[接続] > [サードパーティサービス]タブに移動します。
  2. 承認済みツール一覧に移動し、対象の接続の横にある三点リーダーアイコンをクリックして取り消しを選択します。

  3. 確認のため取り消しをクリックします。
同じメニューから承認を選択することで、取り消した接続はいつでも再承認できます。

サードパーティ接続を削除するには:
  1. MCP ポータルの[接続] > [サードパーティサービス]タブに移動します。
  2. 承認済みツール一覧に移動し、対象の接続の横にある三点リーダーアイコンをクリックして削除を選択します。

  3. 確認のため削除をクリックします。

Zoho MCP サーバーを管理する

組織向けに作成されたすべての MCP サーバーは、Zoho MCP ポータルのホームページで確認できます。

Zoho MCP サーバーを無効にするには:
  1. Zoho MCP ポータルのホームページに移動します。
  2. 設定済みサーバーの三点リーダーアイコンをクリックし、無効化を選択します。

  3. 確認のため無効化をクリックします。
無効化されたサーバーの三点リーダーアイコンをクリックし、有効化を選択することで、いつでも再度有効にできます。

Zoho MCP サーバーを削除するには:
  1. Zoho MCP ポータルのホームページに移動します。
  2. 設定済みサーバーの三点リーダーアイコンをクリックし、削除を選択します。

  3. 確認のため削除をクリックします。
サーバーは Zoho MCP ポータルから削除されます。

設定済みツールを削除する

Zoho MCP サーバーに追加した各ツールは、接続されたサービスで AI ツールが実行できるアクションを表します。

MCP サーバーにツールを追加していて、一時的に無効にしたい場合は、使用している AI ツール側から直接無効にできます。ただし、そのツールが不要になり完全に削除する必要がある場合は、Zoho MCP ポータルから削除する必要があります。

ツールを削除するには:
  1. ツールを削除したい MCP サーバーを開きます。
  2. ツールセクションで、そのツールが設定されているサービスを選択します。
  3. ツールの横にある三点リーダーアイコンをクリックし、削除を選択します。

  4. 確認のため削除をクリックします。
Zoho MCP の詳細については、Zoho MCP ヘルプドキュメントを参照してください。