独自の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 上のサーバーをウェブアプリから登録することはできません。
サーバーを追加する
- 設定 → ツール を開きます。
- ツールを追加 または MCPサーバーを追加 を選びます。このボタンは、MCPアクセス権がある場合のみ表示されます。
- まず利用可能なプリセットを確認します。
- 自分でMCPサーバーを追加 を選びます。
- 名前、完全なエンドポイント、認証方法を入力します。
- 設定を保存し、接続チェックを待ちます。
- サーバーを既定のツールセットで有効にします。
管理者は 管理 → AI設定 → ツール → MCP から、環境全体用のサーバーを登録することもできます。
認証とシークレット
AI-School は connector-OAuth と静的シークレットをサポートしています。OAuthトークン、リフレッシュトークン、APIキー、パスワードはサーバー側のみの保存領域に保管されます。チャットには登録された connectorId のみが渡され、秘密の設定は渡されません。
URL または認証が変更された場合、新しい設定はまず再検証されます。この検証に失敗しても、問題が解決されるまで、以前に承認された設定を有効のままにできる場合があります。
ツール権限
ユーザーが本当に必要とするツールだけを許可してください。MCPサーバーは、ファイル削除、メール送信、レコード更新など、読み取りと書き込みの両方の操作を提供できます。AI-School は検出されたツールをサーバー側の許可リストでフィルタリングしますが、適切なスコープと認可についてはサーバー管理者が責任を負います。
ローカルでテストする
ローカルの stdio サーバーはデスクトップアプリでテストします。レンダラーは任意のシェルコマンドを起動できません。インストールは、承認済みプリセットまたは安全なデスクトップフローを通じて行われます。コマンド、引数、環境キー、要求されたアクセス権は、インストール前に表示されます。
トラブルシューティング
- エンドポイントに到達できない: HTTPS、DNS、ファイアウォール、および完全な
/mcpパスを確認してください。 - 再接続が必要: OAuth の許可または保存済みシークレットを更新してください。
- 別の環境に属している: 現在の環境内でコネクタを再登録してください。
- ツールが表示されない: ツールの許可リスト、MCPアクセス権、サーバーが有効になっているかを確認してください。
- デスクトップでのみ動作する: サーバーが stdio またはローカルアドレスを使用している可能性があります。
開発リソース
関連項目
編集時には、登録済みのサーバー設定が取得されます。保存済みのキーは非表示のままです。保持するにはキー欄を空欄にしてください。URL または認証方法が異なる場合は、再接続が必要です。1つのMCPツールでエラーが発生しても、そのサーバーのすべてのツールにアクセスできなくなるとは限りません。