独自の MCP-server を追加する
独自の MCP-server を使うと、AI-Public をケース管理システム、アーカイブ、データソース、またはその他の専門サービスに接続できます。まず、利用場所に合ったトランスポートを選択してください。
適切なトランスポートを選ぶ
| Transport | Web | モバイル | Desktop | 用途 |
|---|---|---|---|---|
| Streamable HTTP | はい | はい | はい | ホストされたサーバーに推奨 |
| stdio | いいえ | いいえ | はい | ローカルプロセスとデスクトップ統合 |
| SSE | 既存の設定のみ | 既存の設定のみ | はい | 旧式のトランスポート。新しいサーバーには Streamable HTTP を選択してください |
Streamable HTTP の要件
MCP パスを含む完全な公開エンドポイントを使用してください。例:
https://mcp.organisatie.nl/mcp
エンドポイントは HTTPS を使用し、リダイレクトなしで公開 DNS から到達可能で、正しい MCP initialize ハンドシェイクに応答する必要があります。ユーザー名とパスワードは URL に含めないでください。ローカルアドレス、プライベートネットワークアドレス、クラウドメタデータエンドポイントはブロックされます。
サーバーを追加する
- Voorkeuren → Tools を開きます。
- Tools toevoegen または MCP-server toevoegen を選択します。このボタンは MCP アクセス権がある場合にのみ表示されます。
- 利用可能なプリセットを確認します。
- Zelf een MCP-server toevoegen を選択します。
- 名前、完全なエンドポイント、認証方法を入力します。
- 設定を保存し、接続チェックを待ちます。
- サーバーを標準ツールセットで有効にします。
管理者は Beheer → Tools → MCP から、環境全体向けにサーバーを登録できます。
認証と secrets
AI-Public は connector-OAuth と静的 secrets をサポートします。OAuth トークン、refresh token、API キー、パスワードはサーバー専用の保存領域に保管されます。チャットには登録済みの connectorId のみが渡され、秘密設定は渡されません。
URL または認証が変更された場合、新しい設定はまず再検証されます。その検証に失敗しても、以前に承認された設定は問題が解決するまで有効なままにできます。
ツール権限と情報セキュリティ
ユーザーが実際に必要とするツールだけを公開してください。MCP-server は読み取りおよび書き込み操作を提供できます。AI-Public は、検出されたツールをサーバー側の allowlist と照合し、利用のたびに環境、所有者、ロールを確認します。組織は、適切なスコープ、ログ、保持期間、ならびに元システムでの認可について責任を負います。
ローカルデスクトップサーバー
ローカルの stdio-server はデスクトップアプリにインストールします。Command、引数、environmentkeys、要求されるアクセス権は制限され、承認前に表示されます。secrets はローカルで暗号化されます。
トラブルシューティング
- Endpoint niet bereikbaar: HTTPS、DNS、ファイアウォール、そして完全な
/mcpパスを確認してください。 - Opnieuw verbinden vereist: OAuth の許可または保存された secret を更新してください。
- Hoort bij een andere omgeving: 現在の環境内で connector を再登録してください。
- Geen tools zichtbaar: allowlist、ロールアクセス、アクティブ状態を確認してください。
- Werkt alleen op desktop: おそらくサーバーは stdio またはローカルアドレスを使用しています。
開発リソース
関連項目
編集時には、登録済みのサーバー設定が取得されます。保存されたキーは非表示のままです。保持するにはキー欄を空欄にしてください。URL または認証方法が異なる場合は、再接続が必要です。1 つの MCP-tool にエラーがあっても、そのサーバーのすべての tools にアクセスできなくなるわけではありません。