独自のMCPサーバーを追加する
独自のMCPサーバーを使うことで、AI-Schoolを独自のアプリケーション、データソース、または専門サービスと接続できます。まず、使用場所に適したトランスポートを選択してください。
適切なトランスポートを選ぶ
| トランスポート | Web | モバイル | デスクトップ | 用途 |
|---|---|---|---|---|
| Streamable HTTP | はい | はい | はい | ホスティングされたサーバーに推奨 |
| stdio | いいえ | いいえ | はい | ローカルプロセスおよびデスクトップ統合 |
| SSE | 既存の設定のみ | 既存の設定のみ | はい | 廃止予定のトランスポート；新規サーバーはStreamable HTTPを選択 |
Streamable HTTPの要件
完全な公開エンドポイント（MCPパスを含む）を使用してください。例：
https://mcp.example.nl/mcp
エンドポイントは以下を満たす必要があります：
- HTTPSを使用していること；
- URLにユーザー名やパスワードを含まないこと；
- リダイレクトが不要であること；
- 公開DNS経由でアクセス可能であること；
- 有効なMCPの
initializeハンドシェイクに応答すること； - 明示的に許可されたツールのセットを持つこと。
ローカルアドレス、プライベートネットワークアドレス、クラウドメタデータエンドポイントはブロックされます。そのため、localhost上のサーバーはWebアプリから登録できません。
サーバーを追加する
- 設定 → ツールを開きます。
- ツールを追加またはMCPサーバーを追加を選択します。
- まず利用可能なプリセットを確認します。
- 独自のMCPサーバーを追加を選びます。
- 名前、完全なエンドポイント、認証方法を入力します。
- 設定を保存し、接続チェックを待ちます。
- サーバーをオンにして標準ツールセットに設定します。
管理者は管理 → AI設定 → ツール → MCPから環境全体のサーバーを登録できます。
認証とシークレット
AI-SchoolはコネクターOAuthと静的シークレットをサポートします。OAuthトークン、リフレッシュトークン、APIキー、パスワードはサーバー専用ストレージに保存されます。チャットは登録されたconnectorIdのみを受け取り、秘密設定は受け取りません。
URLや認証が変更された場合、新しい設定はまず再検証されます。検証に失敗した場合、問題が解決するまで以前に承認された設定が有効のままになることがあります。
ツール権限
ユーザーが実際に必要とするツールのみを許可してください。MCPサーバーはファイル削除、メール送信、レコード変更などの読み書き操作を提供できます。AI-Schoolはサーバー側の許可リストと照合して検出されたツールをフィルタリングしますが、サーバー管理者は適切なスコープと認可の責任を負います。
ローカルテスト
ローカルのstdioサーバーはデスクトップアプリでテストできます。レンダラーは任意のシェルコマンドを起動できません：インストールは承認済みプリセットまたは安全なデスクトップフロー経由で行われます。コマンド、引数、環境キー、要求されたアクセスはインストール前に表示されます。
トラブルシューティング
- エンドポイントに接続できない：HTTPS、DNS、ファイアウォール、完全な
/mcpパスを確認してください。 - 再接続が必要：OAuth許可または保存されたシークレットを更新してください。
- 別の環境に属している：現在の環境内でコネクターを再登録してください。
- ツールが表示されない：ツール許可リスト、MCPアクセス、サーバーがアクティブか確認してください。
- デスクトップのみで動作する：サーバーがstdioまたはローカルアドレスを使用している可能性があります。
