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