> ## Documentation Index > Fetch the complete documentation index at: https://manus.im/docs/llms.txt > Use this file to discover all available pages before exploring further. # カスタム MCP サーバー > 内部ツールおよび独自のシステムとの連携を構築します ## カスタム MCP サーバーとは何ですか？ カスタム MCP サーバーを使用すると、事前に構築されたコネクタを超えて Manus の統合機能を拡張できます。組織が標準の MCP コネクタでカバーされていない内部ツール、独自の API、または特殊なサービスを使用している場合は、Manus をそれらのシステムに接続するカスタムサーバーを構築できます。 カスタム MCP サーバーは、Manus と内部インフラストラクチャ間のブリッジとして機能し、事前に構築されたコネクタで得られるのと同じシームレスなマルチアプリワークフローを可能にします。ただし、これは特定のツールと要件に合わせて調整されます。 ## カスタム MCP サーバーを構築する理由 ### 内部システム 多くの組織は、カスタム構築されたツール、内部データベース、または独自のソフトウェアに依存しています。カスタム MCP サーバーにより、Manus はこれらのシステムと統合し、内部データを AI ワークフローに取り込むことができます。 **例**： * 内部 CRM または顧客データベース * 独自のプロジェクト管理ツール * カスタム分析プラットフォーム * API を持つレガシーシステム ### 特殊なサービス 一部のサードパーティサービスには、事前に構築された MCP コネクタがありません。特殊なツールやニッチなサービスを使用している場合は、カスタムサーバーを構築して Manus に接続できます。 **例**： * 業界固有のソフトウェア * 標準コネクタでカバーされていない地域サービス * 公式な統合がない新しいプラットフォーム ### カスタムビジネスロジック カスタム MCP サーバーは、単純な API 呼び出しを超えた、ビジネス固有のロジック、データ変換、または検証ルールを実装できます。これにより、Manus の統合内で組織のポリシーとワークフローを適用できます。 **例**： * データ更新前の承認ワークフロー * 内部標準に対するデータ検証 * カスタム認証またはセキュリティ要件 * 組織固有のマルチステッププロセス ## カスタム MCP サーバーの仕組み カスタム MCP サーバーは、モデルコンテキストプロトコル仕様を実装する軽量サービスです。これは、Manus がデータを読み取ったり、アクションを実行したり、システム内でカスタムロジックを実行したりするために呼び出すことができるエンドポイントを公開します。 ### アーキテクチャ **あなたの内部システム** ↔**カスタム MCP サーバー** ↔**Manus** MCP サーバーは Manus と内部システムの間に入り、Manus のリクエストをツール内のアクションに変換し、Manus が理解できる形式で結果を返します。 ### プロトコル カスタム MCP サーバーは、以下を定義する標準化されたプロトコルを実装しています。 * **ツール**：Manus が実行できるアクション（例：「get\_customer\_data」、「update\_project\_status」） * **リソース**：Manus が読み取ることができるデータ（例：ドキュメント、レコード、ファイル） * **プロンプト**：一般的な操作のための事前定義されたテンプレート ## カスタム MCP サーバーの構築 ### 前提条件 * **API アクセス**を統合したいシステムへのアクセス * **開発環境** (Node.js、Python、または Web サーバーを実行できる任意の言語) * **MCP 仕様の理解** (Manus ドキュメントで入手可能) ### 基本的な実装 最小限のカスタム MCP サーバーには以下が含まれます: 1. **サーバーエンドポイント**: MCP プロトコルリクエストに応答する Web サービス 2. **ツール定義**: Manus が実行できるアクションの説明 3. **認証**: 資格情報と API キーの安全な処理 4. **リクエストハンドラー**: アクションを実行し、結果を返すロジック ### 例: 内部 CRM 統合 以下は、内部 CRM 用のカスタム MCP サーバーの概念的な例です: **公開されるツール**: * `get_customer_info(customer_id)`: 顧客の詳細を取得 * `update_customer_notes(customer_id, notes)`: 顧客レコードにメモを追加 * `search_customers(query)`: 顧客データベースを検索 * `create_follow_up_task(customer_id, task_description, due_date)`: タスクを作成 **認証**: 内部 CRM の API キーまたは OAuth トークン **デプロイ**: 独自のインフラストラクチャまたは安全なクラウド環境でホストされます デプロイ後、このカスタムサーバーを Manus に接続すると、事前に構築されたコネクタと並んで表示されます。その後、次のような自然言語プロンプトを使用できます: * "顧客 ID 12345 の顧客情報を取得して" * "サンフランシスコ地域の顧客を検索して" * "顧客 67890 のメモを、最近の会話で更新して" ## カスタム MCP サーバーの接続 ### ステップ 1: サーバーをデプロイする カスタム MCP サーバーを、管理下のインフラストラクチャでホストします。HTTPS 経由でアクセス可能であり、適切なセキュリティ対策が講じられていることを確認してください。 ### ステップ 2: Manus に追加する Manus で、「**設定 → 統合 → カスタム MCP サーバー**」に移動し、「**サーバーを追加**」をクリックします。 ### ステップ 3: サーバーの詳細を提供する 以下の情報を入力してください: * **サーバー名**: 説明的な名前 (例: 「内部 CRM」、「分析プラットフォーム」) * **サーバー URL**: MCP サーバーがホストされている HTTPS エンドポイント * **認証**: 必要なAPIキー、Bearerトークン、またはその他の資格情報 ### ステップ4：接続のテスト Manusは、サーバーと通信し、利用可能なツールのリストを取得できることを確認します。 ### ステップ5：使用開始 接続されると、カスタムツールはManusの利用可能な集成に表示されます。事前に構築された接続器と同様に、Promptでそれらを参照できます。 ## セキュリティに関する考慮事項 ### 認証 カスタムMCPサーバーは、堅牢な認証を実装する必要があります。 * APIキー、OAuthトークン、またはその他の安全な方法を使用する * URLまたはログに資格情報を公開しない * 資格情報を定期的にローテーションする ### 認可 適切な認可チェックを実装します。 * 要求元のユーザーがデータにアクセスする権限を持っていることを確認する * 該当する場合は、ロールベースのアクセス制御 (RBAC) を強制する * 監査目的ですべてのアクセス試行をログに記録する ### データ転送 * すべての通信にHTTPSを使用する * 機密データを保存時および転送時に暗号化する * 乱用を防ぐためにレート制限を実装する ### ネットワークセキュリティ * MCPサーバーを安全なネットワーク境界内にデプロイする * ファイアウォールとアクセス制御を使用して、サーバーにアクセスできるユーザーを制限する * 機密性の高い集成には、VPNまたはプライベートネットワーク接続を検討する ## ベストプラクティス ### ツール設計 **ツールの焦点を絞る**: 各ツールは1つの明確なアクションを実行する必要があります。単一の「manage\_customer」ツールではなく、「get\_customer」、「update\_customer」、「delete\_customer」用に個別のツールを作成します。 **明確な説明を提供する**: Manusはツールの説明を使用して、各ツールをいつ使用するかを理解します。ツールが何を行い、いつ適切であるかを説明する、明確で具体的な説明を記述します。 **エラーを適切に処理する**: Manus（およびユーザー）が何が問題で、それを修正する方法を理解するのに役立つ、意味のあるエラーメッセージを返します。 ### パフォーマンス **応答時間を最適化する**: ManusはMCPサーバーの応答を待ちます。データのキャッシュ、効率的なクエリの使用、不要な処理の回避により、操作を高速に保ちます。 **タイムアウトを実装する**: 内部システムが遅い、または応答しない場合にManusが無限に待機するのを防ぐために、API呼び出しに妥当なタイムアウトを設定します。 **時間のかかるタスクには非同期操作を使用する**: 操作に数秒以上かかる場合は、タスクIDをすぐに返し、ステータスを確認するための別のツールを提供することを検討してください。 ### モニタリング **すべてのリクエストをログに記録する**: Manusが何を要求しているか、サーバーがどのように応答しているかを追跡します。これは、デバッグと使用パターンの理解に役立ちます。 **パフォーマンスを監視する**: 応答時間、エラー率、使用量を追跡して、ユーザーに影響を与える前に問題を特定します。 **アラートを設定する**: MCPサーバーが応答しなくなった場合、またはエラーを返し始めた場合に通知を受け取ります。 ## 使用例 ### 社内ナレッジベース **シナリオ**: あなたの組織には、会社のポリシー、手順、ドキュメントを含む社内Wikiまたはナレッジベースがあります。 **Custom MCP Server**: ナレッジベースを検索し、特定の記事を取得し、関連ドキュメントを見つけるためのツールを提供します。 **Manus Workflow**: "社内ナレッジベースで経費精算ポリシーを検索し、要点を要約してください。" *** ### カスタム分析プラットフォーム **シナリオ**: 標準ツールでは利用できないビジネス指標を追跡する独自の分析プラットフォームがあります。 **Custom MCP Server**: メトリクスを照会し、レポートを生成し、履歴データを取得するためのツールを公開します。 **Manus Workflow**: "第4四半期の顧客獲得コストデータを取得し、第3四半期と比較したトレンド分析を作成してください。" *** ### レガシーシステム統合 **シナリオ**: あなたの組織は、最新の API や統合機能を持たないレガシーシステムに依存しています。 **Custom MCP Server**: レガシーシステムのラッパーとして機能し、最新の API 呼び出しをレガシーシステムが理解できる形式に変換します。 **Manus Workflow**: "レガシーシステムで製品 SKU 98765 の在庫レベルを確認し、在庫が100ユニット未満の場合は再注文リクエストを作成してください。" *** ### 多段階承認ワークフロー **シナリオ**: あなたの組織は、特定の操作（例：予算要求、データアクセス）に対して承認ワークフローを必要とします。 **Custom MCP Server**: 承認リクエストを作成し、承認ステータスを確認し、承認されたアクションを実行するツールを実装します。 **Manus Workflow**: "マーケティングキャンペーンのために\$50,000の予算リクエストを作成し、承認のために財務チームに通知してください。" ## よくある質問 カスタム MCP サーバーの構築には開発スキルが必要です。ただし、MCP の仕様は簡単であり、開始に役立つ実装例が利用可能です。 サービスに十分に文書化された REST API がある場合、カスタム MCP サーバーなしで Manus の一般的な API 呼び出し機能を使用できる可能性があります。ただし、カスタムサーバーは、より優れた統合、より明確なツール定義、およびより信頼性の高いワークフローを提供します。 カスタム MCP サーバーは、ほとんどの操作で数秒以内に応答する必要があります。より長い操作には非同期パターンを使用する必要があります。時間がかかりすぎるリクエストは Manus によってタイムアウトされます。 カスタム MCP サーバーは、他のすべての内部サービスと同様に扱ってください。バージョン管理、自動テスト、監視、定期的な更新を行います。サーバーを内部システムの API の変更と同期させてください。