MCPサーバーを手動で追加する
接続詳細と資格情報を手動で入力して、Model Context Protocol(MCP)サーバーを追加します。
始める前に
- スーパー管理者ロール、またはサードパーティ製MCPサーバーの管理(Manage third-party MCP Servers)権限とリソースタイプのカスタムロールを持っている。「カスタム管理者ロールを使用する」を参照してください。
- MCPサーバーをカスタム認可サーバーで保護する場合は、認可サーバーを作成済みであること。「認可サーバーを作成する」を参照してください。
手順
- Admin Consoleで、Applications and Resources > MCPサーバー(MCP Servers)に移動します。
-
カスタムMCPを追加(Add custom MCP)をクリックします。
MCPサーバーを追加する(Add MCP server)ページが開きます。
- MCPサーバーの名前、説明、リソース識別子URLを入力します。
- 保存(Save)をクリックします。
-
認可サーバーを追加します。
Oktaがリソース識別子URLから認可サーバーを検出した場合、ページに表示されます。構成(Configure)をクリックすると、詳細が確認され、サーバーを追加するサブステップはスキップされます。
- 認可サーバーを追加(Add authorization server)をクリックします。
- 認可サーバーのタイプを選択します。
- 外部サーバー(External server)を選択する場合は、発行者(Issuer)、認可エンドポイントURL(Authorization endpoint URL)、トークンエンドポイントURL(Token endpoint URL)を入力します。認可サーバーが動的クライアント登録(DCR)をサポートしている場合は、DCR登録URLを入力します。
-
Oktaカスタム認可サーバー(Okta custom authorization server)を選択する場合は、リストから使用したい認可サーバーを選択します。
Oktaはカスタム認可サーバー向けのアプリ間アクセス(XAA)をサポートするため、資格情報は必要ありません。保存したら、完了して閉じる(Done and close)をクリックします。
注:同じカスタム認可サーバーで複数のMCPサーバーを保護できます。
- 保存(Save)をクリックします。
-
外部認可サーバーを使用している場合は、MCPサーバーの資格情報を追加します。
- クライアント資格情報名(Client credentials name)を入力します。
-
クライアント登録タイプを選択します。
保存後に別の登録タイプに切り替えることはできません。
-
静的資格情報(クライアントIDとシークレット)(Static credentials(client ID and secret))を選択した場合は、クライアントID(Client ID)とクライアントシークレット(Client secret)を入力します。
クライアントは、クライアントIDとクライアントシークレットを必要とする認可コードフローを使用して、機密クライアントとして構成する必要があります。
-
動的クライアント登録(Dynamic Client Registration)を選択した場合、Oktaはクライアントをプロバイダーに登録し、資格情報を事前入力します。
このオプションは、DCR登録URLを指定した場合のみ利用できます。
- スコープを選択または追加します。スコープは、メタデータ検出を通じて利用可能な場合、自動的に入力されます。
- さらにスコープを追加するには、追加(Add)をクリックします。
- 保存(Save)をクリックします。
- 資格情報を追加し、エージェントゲートウェイが有効になっている場合は、資格情報をテストしてツールを検出(Test credentials and discover tools)をクリックして、資格情報を検証し、利用可能なツールを表示します。
- 外部認可サーバー用にさらにクライアント資格情報セットを作成するには、追加(Add)をクリックして前の手順を繰り返します。
-
完了して閉じる(Done and close)をクリックします。
MCPサーバーはMCPサーバー(MCP Servers)ページに表示され、次のいずれかのステータスになります。
- アクティブ(ACTIVE): 新しく追加されたMCPサーバーのデフォルトステータスです。
- 非アクティブ(INACTIVE):管理者がMCPサーバーを非アクティブ化しており、管理対象接続には使用できません。
- 無効(INVALID): MCPサーバーに認可サーバー情報がないか、破損したメタデータが含まれています。
- さらに認可サーバーを追加するには、認可サーバーを追加(Add authorization server)をクリックして前の手順を繰り返します。
次のタスク
MCPサーバーとAIエージェントの間にリソース接続を作成します。「AIエージェントをリソースに接続する」を参照してください。