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

概要

MCPとは？

Zoho MCPとは？

この図から、以下のことが理解できます：

1. ユーザーがMCPクライアントにプロンプトを入力すると、それが設定済みのZoho MCPサーバーにコンテキストとして提供されます。
   
2. MCPプロトコルを利用してコンテキストが抽出され、設定されたツールに基づき、必要なサービスがAPIを使って呼び出され、必要な処理が実行されます。
   
3. これらすべてのバックエンド処理は、Zoho MCPサーバーが完全に管理します。
   

1. 新規クライアントにMaster サービス Agreementドキュメントをメールで送付する。
   
2. 必要な請求書を生成し、クライアントにメールで送付し、アカウント HeadをCCに入れる。
   
3. クライアントにオンボーディング用のリンクを送信する。
   
4. クライアントとのフォローアップの予定を必要に応じて予約する。
   
5. 最後に、CRMで商談を完了済みに設定し、タブを次のチームに移動し、次の担当者に連絡先を引き継ぐことを通知する。
   

用語集

1. AI Agents：基本的に、指示された結果を達成したり、指示された操作を独自の知能で完了するソフトウェアプログラムです。代表的なAIエージェントには、開く AI、Claude、CrewAI、CoPilot、Cursor などがあります。
   
2. 外部連携：MCPの機能であり、Super Adminが組織のメンバーとアクセストークンや更新トークンを共有できるようにします。
   
3. MCP：MCPはModel Context Protocolの略です。AIエージェントが他のサービスで複雑なワークフローを実行できるように、必要なコンテキストを提供するための標準規格です。
   
4. MCP Client：Claude、OpenAI、Cursor、WindsurfなどのAIエージェントはMCPクライアントです。MCPクライアントは、必要なワークフローを開始するためのプロンプトが入力される場所です。
   
5. MCP Server：MCPサーバーは、MCPクライアントが設定されたサービスで操作を実行できるように、すべてのバックエンド処理を担当します。主にMCPクライアントや入力されたコンテキスト、ライフサイクルルールを管理し、一貫した状態とアクセス制御を確保します。
   
6. サービス：MCPアーキテクチャにおけるサービスとは、対象となるアプリケーションを指します。例えば、MCPクライアントを使ってZoho CRMで処理を行う場合、Zoho CRMがサービスとなります。
   
7. Tools：サービス内で必要な処理を実行するために設定するものがToolsです。例えば、Zoho CRMでは、許可されている処理としてGetRecords、検索する データ、Mass 更新する データ、更新する メモなどがあります。これらの処理がToolsです。必要なToolを選択することで、MCPクライアントは選択されたToolsで定義された処理のみを実行できます。
   

Zoho MCPと従来のAPIの比較

カテゴリー	Zoho MCP	従来のAPI
オペレーション	MCP Clientsによって全て自動で処理され、初期設定とプロンプト以外での手動対応は必要ありません。	手動対応に大きく依存します。APIの実行や呼び出しごとに外部要因に左右されます。
オペレーションスタイル	完全自律型です。	自動化は可能ですが、完全な自律動作はできません。
オペレーションワークフロー	MCP Clientsは、MCP Serverに搭載されたMCPプロトコルを利用して豊富なコンテキストを提供できます。サーバーに連携された頻度サービスやアプリケーションは、ツールを通じて自律的かつ円滑に連携して動作します。 各必須サービスの実行は、追加の認証や手動対応を必要とせず、シームレスに行われます。	オペレーションワークフロー内の個々のサービスがAIによって動作可能であっても、連携して円滑に動作することはできません。 各サービスは個別に起動する必要があり、それぞれの操作は独立して実行されます。
オペレーションディスカバリー	MCP Clientsは利用可能なコマンドを自動的に検出し、自律運用のためのパラメータメタデータを構築できます。	APIの手動探索が必要です。
パラメータ処理	複雑なパラメータの関係性を処理でき、動的なパラメータ解決やコンテキストに応じた入力処理に対応しています。	手動入力が必須であり、厳格かつ従来型の静的パラメータ処理に対応しています。
全体プロセスの最適化の可能性	ワークフロー内のサービスの番号に関係なく、必須ツールが設定されていれば、運用ワークフローのすべての側面が自律的に実行されます。 これにより、時間と労力が大幅に削減され、ワークフローが飛躍的に最適化されます。	最良の場合でも、個々のサービスがAIで自律的に動作できたとしても、完全な自動運用は実現できません。 自動化によるわずかな最適化は期待できますが、MCPによる最適化とは比較になりません。

Zoho MCPの開始方法

前提条件

Zoho MCPサービスは、業務ワークフローの最適化や自動化を必要とするすべての方にご利用いただけます。ご利用にあたり、制限や事前のプログラミング言語の知識は必要ありません。

ただし、Zoho MCPサービスの利点を最大限に活用するために、いくつかの基本的な前提条件を満たす必要があります。

1. ツールとして設定する予定のすべてのZohoサービス、サードパーティサービス、またはカスタムサービスにおいて、有効かつ認証済みの認証情報が必要です。
   
2. AIエージェントを適切なプランで利用し、統合セクションへのアクセスや独自の統合作成ができることを確認してください。
   

Zoho MCPサーバーの設定

必須の前提条件を満たしたら、以下の手順でZoho MCPサーバーの設定を開始できます。
このデモンストレーションを進めるために、以下のサービスを使用します。

MCPクライアント: Claude

サービス: Zoho CRM、Zoho メール

使用ツール:

1. Zoho CRM: 検索する データ、取得する データ、更新する メモ
   
2. Zoho メール: sendEmail
   

選択するサービスによって手順に若干の違いが生じる場合がありますが、基本的な流れは下記の内容とほぼ同様です。

Zoho MCPサーバーを設定するには:

1. Zoho MCPコンソールにアクセスします。

2. Zoho MCPサーバーの名前を入力し、作成をクリックします。

      

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

3. 次に、Config Toolsをクリックして必須ツールを設定します。

      

4. 必須サービス（Zoho CRM、この場合）を選択します。

      

できることは、検索する-棒グラフを使って必須サービスを検索したり、カテゴリーフィルターオプションを利用して、必要なサービスを素早く見つけることです。

5. 次に、ツールの一覧が表示されます。これらのツールは、プロンプトで指示された必須処理を実行するための適切なコンテキストとアクセス権を提供します。必要なツールを選択したら、追加する Nowをクリックしてください。

必須ツールの定義が完了しました。


6. 同様に、Config Toolsボタンをクリックし、必須ツールをZoho MCPサーバーのZoho メールサービスに追加してください。

すべての必須ツールがZoho MCPサーバーに追加されます。

MCP URLをコピーする

Zoho MCPサービスは、Zoho MCPサーバーを作成するたびに安全でユニークなURLを作成します。このMCP URLは、MCPクライアントからプロンプトが実行された際に呼び出されるエンドポイントとして機能します。

MCP URLをコピーするには:

1. サイドバーの接続タブをクリックします。
      

2. URLの横にあるコピーアイコンをクリックしてURLをコピーします。
このURLを使用して、Zoho MCPサーバーとMCPクライアントを連携できます。また、APIキー再生成ボタンをクリックして、新しいMCP URLエンドポイントを生成し、Zoho MCPサーバーを呼び出すことも可能です。

MCPクライアントの設定

MCP URLがあれば、MCPサーバーとMCPクライアントの連携準備が整います。

MCPクライアントと連携するには:

1. Claudeコンソールの設定セクションに移動します。
      

2. Integrationsタブをクリックします。

3. MCP連携に名前を入力し、先ほどコピーしたMCP URLを貼り付けて、追加するをクリックします。

4. MCPサービスがMCPクライアントに追加されます。次に、接続をクリックして連携を認証します。

5. 必要なすべての権限が表示されたOAuth画面に遷移します。承認するをクリックしてください。

これで、MCPクライアントがZoho MCPサーバーによって稼働するようになり、必要なサービスで処理を実行できます。

MCPサービスで設定したツールの一覧は、展開アイコンのトグルをクリックすると確認できます。

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

Zoho MCPサーバーとMCPクライアントを接続するには、Zoho MCPサーバーを作成し、MCP URLエンドポイントを設定していることを確認してください。
これらの要件を満たす手順は、前述のステップで詳しく説明しています。

このヘルプドキュメントでは、以下の代表的なMCPクライアントとの接続手順のみを説明しています。

1. Windsurf
   
2. Cursor
   
3. Copilot
   
4. Claude（Claudeとの接続手順は、上記の取得するStarted Guideに記載されています。）
   

その他のMCPクライアントとの接続手順については、各MCPクライアントの公式ドキュメントをご参照ください。

このセクションで説明している手順は、MCPコンソールの接続セクションにも掲載されています。

Zoho MCPサーバーとWindsurfの接続

Zoho MCPサーバーを作成し、MCP URLをコピーしていることを確認してください。

Windsurfと接続するには：

1. 設定オプションに移動します。

2. 次に、設定の検索バーで「mcp」と入力して検索し、管理 Pluginsをクリックします。

3. 続いて、表示する 生データ Configをクリックします。

4. mcp_config.jsonファイル画面に移動します。

以下のコードスニペットをこのファイルにコピー＆ペーストし、mcp-remotejsonキーの値としてご自身のMCP URLを入力してください。{

1. {
2. 'mcpServers': {
3. 'github': {
4. 'command': 'npx',
5. 'args': [
6. {
7. 'mcp-remote': 'your-MCP-URL'
8. }
9. ]
10. }
11. }
12. }
    

5. 保存をクリックすると、ローカルホスト上でZoho MCP認証画面に遷移します。Allowをクリックしてください。

これで、Windsurf を MCP クライアントとして動作させ、Zoho MCP サーバーを呼び出すことができます。

Zoho MCP サーバーを Cursor と接続する

Zoho MCP サーバーを作成し、MCP URL をコピーしていることを確認してください。

Cursor と接続するには:

1. Cursor の 設定 セクションにある ツール & 連携 タブに移動し、カスタム MCP を追加する をクリックします。

      

2. mcp_config.json ファイルに遷移します。以下のコードスニペットをファイルに貼り付けてください。

mcp-remote キーの値として、ご自身の MCP URL を入力してください。

1. {
2. 'mcpServers': {
3. 'command': 'npx',
4. 'args': [
5. {
6. 'mcp-remote': 'your-MCP-URL'
7. }
8. ]
9. }
10. }

3. 保存 をクリックすると、ローカルホスト上で Zoho MCP の認可画面に遷移します。許可 をクリックしてください。

      

これで、Cursor を MCP クライアントとして動作させ、Zoho MCP サーバーを呼び出すことができます。

Zoho MCPをCopilotと接続する

Zoho MCPサーバーを作成し、MCP URLをコピーしていることを確認してください。

Copilotと接続するには：

1. VSコードでCopilotを有効にし、VSコードの検索バーでMCPサーバーを検索し、+MCP Serverを追加をクリックします。

      

2. 次に、npxではなくHTTP経由でMCPサーバーを追加する方法を選択します。npx経由でも接続できますが、ここでは説明のためHTTP方式を使用しています。

      

3. 設定.jsonファイルが表示されますので、mcpjsonキーの値ペアに以下のコードを置き換えてください。

urlキーの値として、ご自身のMCP URLを入力してください。

1. {
2. 'mcp': {
3. 'servers': {
4. 'Zoho-mcp': {
5. '種類': 'http',
6. 'url': 'your-mcp-url'
7. }
8. }
9. }
10. }

4. ローカルホスト上のZoho MCP認可画面が表示されますので、Allowをクリックしてください。

これで、CopilotがMCPクライアントとして機能し、Zoho MCPサーバーを呼び出すことができるようになります。

サードパーティサービスからツールを追加

Zoho MCPは、950以上の事前定義されたアプリケーションからツールを追加することができます。このセクションでは、サードパーティサービスからツールを追加する手順について詳しく説明します。

サードパーティサービスから必要なツールを追加するには：

1. サイドバーのToolsタブをクリックし、Config Toolsをクリックして、必要なサードパーティサービスを選択します。

2. 必要なツールを選択し、追加する Nowをクリックします。

3. サードパーティサービスの設定iFrameで必要な選択を行い、完了をクリックします。

必要なツールがサードパーティサービスから追加されます。

Toolsの管理

Toolsは、必須サービスやアプリケーションでMCPサーバーを利用してMCPクライアントを処理する際に必要なコンテキストを提供します。

MCPサーバーに追加したすべてのツールは、Toolsセクションに一覧表示されます。

Config Toolsボタンを使うことで、同じサービスまたは別のサービスから他のツールをMCPサーバーにいつでも追加できます。

ツールをMCPサーバーに追加した後、不要になった場合は削除することも可能です。

ツールを削除する方法:

1. 必要なツールの横にある省略記号アイコンをクリックし、削除オプションをクリックします。

2. ポップアップで削除をクリックしてツールを削除します。

ツールが削除されます。

Zoho MCPサーバー外部連携の管理

サービスからツールをZoho MCPサービスに追加する際、サービス側でOAuth2.1プロトコルを用いた認証が必要です。Zoho MCPサービスでは、この認証を2つの方法で行うことができます。

1. Authorization オン Demand:
   
1. これは、Zoho MCP サーバーにツールを追加する際に使用される初期設定方法です。
   
2. この認証方法は、Zoho製品スイートからツールを追加する場合のみ許可されています。
   
3. この認証はアカウント単位で行われます。
   
4. たとえば、あなたと共同作業者が同じZoho MCPサーバーに接続する場合、必要な認証はそれぞれ個別に完了する必要があります。各自が自身のアクセスを認証し、個人の取引先で処理を認証する必要があります。
   
2. Authorization via Connection:
   
1. この認証オプションは、選択して有効化することができます。
   
2. この認証は、サードパーティサービスからツールを追加する際に使用されます。
   
3. この認証は組織単位で行われます。
   
4. 組織内のメンバーと認証コントロールを共有することが可能です。
   
5. たとえば、あなたが組織内の信頼されたユーザーのSuper Adminであり、全員が同じZoho MCPサーバーに接続している場合、各ユーザーが個別に認証・認可を行う代わりに、OAuthのAccess Tokensや更新する Tokensを利用して認証を行わせることができます。これにより、共同作業者はあなたのトークンを使って処理の認証が可能となります。
   

Authorization via Connection を有効化する

Authorization via 外部連携を有効にするには：

1. MCPサーバーコンソールの外部連携セクションに移動します。

2. 編集オプションをクリックし、Authorization via Connectionオプションを選択します。更新するをクリックします。

認証の種類が更新されます。

これ以降、このMCPサーバーで実行される処理はSuper AdminのAccessおよび更新するトークンを使用して認証されます。MCPサーバーに接続し、この認証方法を利用しているユーザーの詳細はこのセクションに表示されます。

Native Zoho 外部連携の取り消し

Zoho MCPサービスでは、ユーザーの接続を取り消すことができます。

接続を取り消すには：

1. 必要なユーザー詳細の横にある省略記号アイコンをクリックし、取り消すをクリックします。

2. ポップアップで取り消すをクリックして操作を確定します。

接続が取り消されます。

切断された接続の横にある省略記号アイコンをクリックし、認証をクリックすることで、いつでも再度認証できます。

外部連携の管理（Third-partyサービス）

サードパーティサービスとの連携は、Third Partyタブの外部連携セクションに一覧表示されます。

Zoho製品ツールで利用可能な取り消すや認証などの操作は、サードパーティサービスとの外部連携でも利用できます。また、サードパーティサービスとの連携を削除することも可能です。

連携を削除するには：

1. 必要なユーザー詳細の横にある三点リーダーアイコンをクリックし、削除をクリックします。

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

連携が削除されます。

Zoho MCPサーバーの管理

Zoho MCPサービスのホームページで、作成済みのすべてのMCPサーバー一覧を確認できます。

Zoho MCPサーバーを作成すると、無効化や削除などの操作が可能になります。

Zoho MCPサーバーの無効化

Zoho MCPサーバーを無効にするには：

1. 対象サーバーの横にある三点リーダーアイコンをクリックし、無効にするをクリックします。

2. ポップアップで無効にするをクリックし、Zoho MCPサーバーを無効化します。

サーバーが無効化されます。

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

Zoho MCPサーバーの削除

Zoho MCPサーバーを削除するには：

1. 必須サーバーの省略記号アイコンをクリックし、削除をクリックします。

2. ポップアップで削除をクリックして、Zoho MCPサーバーを削除します。

良いプロンプトを作成するためのベストプラクティス

MCPクライアントで入力するプロンプトは、必要なコンテキストを抽出し、必要な操作を実行するために非常に重要です。操作を1回のプロンプトで完了できるよう、できるだけ正確にプロンプトを入力してください。

コンテキストが豊富で正確なプロンプトを作成するために、プロンプト作成時は以下の点にご注意ください。

1. 必須サービス内に存在するタブのすべての識別項目が正しく記載されていることを確認してください。
   
2. 処理が必要な必須項目については、必ず固有IDを用いて指定・参照してください。
   
3. MCPクライアントに実行させたい操作をできるだけ明確に記述してください。
   
4. 例外ケースや再試行が必要な場合は、必ずプロンプト内に含めてください。
   
5. プロンプトは宣言的な意図として構成してください。
   

正確なプロンプトの良い例：
「ID 12345の編集コンテキストで、Slack手順（step_3）を新規チャンネル『#サポート』を使用するように更新し、タイムアウトを3秒追加してください。現在のアプリが『slack』の場合のみ更新してください。」

サービスに関するご質問やご利用中にお困りの点がございましたら、サポート@zohomcp.comまでお問い合わせください。