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