独自のMCPサーバーを追加する
独自のMCPサーバーを使うと、AI-Corporate を社内アプリケーション、データソース、または専門サービスに接続できます。まず、利用場所に合ったトランスポートを選択してください。
適切なトランスポートを選ぶ
| トランスポート | Web | モバイル | デスクトップ | 用途 |
|---|---|---|---|---|
| Streamable HTTP | はい | はい | はい | ホストされたサーバーに推奨 |
| stdio | いいえ | いいえ | はい | ローカルプロセスとデスクトップ統合 |
| SSE | 既存の構成のみ | 既存の構成のみ | はい | 旧式のトランスポート。新しいサーバーには Streamable HTTP を選択 |
Streamable HTTP の要件
MCP パスを含む完全な公開エンドポイントを使用してください。例:
https://mcp.example.com/mcp
エンドポイントは HTTPS を使用し、リダイレクトなしで公開 DNS から到達可能であり、有効な MCP initialize ハンドシェイクに応答する必要があります。ユーザー名とパスワードは URL に含めないでください。ローカルアドレス、プライベートネットワークアドレス、クラウドメタデータエンドポイントはブロックされます。
サーバーを追加する
- 設定 → Tools を開きます。
- Tools toevoegen または MCP-server toevoegen を選択します。このボタンは MCP アクセス権がある場合にのみ表示されます。
- 利用可能な組織向けプリセットを確認します。
- Zelf een MCP-server toevoegen を選択します。
- 名前、完全なエンドポイント、認証方式を入力します。
- 設定を保存し、接続チェックを待ちます。
- サーバーを既定のツールセットで有効にします。
管理者は Beheer → Tools → MCP から、環境全体向けにサーバーを登録できます。
認証とシークレット
AI-Corporate は connector-OAuth と静的シークレットをサポートします。OAuth トークン、リフレッシュトークン、API キー、パスワードはサーバー専用の保存領域に保管されます。チャットには登録済みの connectorId のみが渡され、秘密の設定は渡されません。
URL または認証が変更された場合、新しい設定はまず再検証されます。その検証に失敗しても、以前に承認された設定は問題が解決されるまで有効のままにできます。
ツール権限とガバナンス
従業員が本当に必要とするツールだけを公開してください。MCP サーバーは読み取りと書き込みの両方の操作を提供できます。AI-Corporate は検出されたツールをサーバー側の allowlist と照合し、利用時ごとにテナント、所有者、ロールを確認します。組織は、適切なスコープ、ログ記録、保持期間、およびソースシステムでの認可に責任を持ちます。
ローカルデスクトップサーバー
ローカルの stdio サーバーはデスクトップアプリにインストールします。レンダラーは任意のシェルコマンドを起動できません。command、引数、environmentkeys、要求されたアクセス権は制限され、承認前に表示されます。シークレットはローカルで暗号化されます。
トラブルシューティング
- エンドポイントに到達できない: HTTPS、DNS、ファイアウォール、および完全な
/mcpパスを確認してください。 - 再接続が必要: OAuth の同意または保存済みシークレットを更新してください。
- 別の環境に属している: 現在の環境内でコネクタを再登録してください。
- ツールが表示されない: allowlist、ロール権限、アクティブ状態を確認してください。
- デスクトップでのみ動作する: サーバーは stdio またはローカルアドレスを使用している可能性があります。
開発リソース
関連項目
編集時には、登録済みのサーバー設定が読み込まれます。保存済みのキーは非表示のままです。保持するにはキー欄を空のままにしてください。別の URL または認証方式の場合は、再接続が必要です。1 つの MCP ツールでエラーが発生しても、そのサーバーのすべてのツールにアクセスできなくなるわけではありません。