MCPサーバーを手動で追加する

接続詳細と資格情報を手動で入力して、Model Context Protocol(MCP)サーバーを追加します。

始める前に

  • スーパー管理者ロール、またはサードパーティ製MCPサーバーの管理(Manage third-party MCP Servers)権限とリソースタイプのカスタムロールを持っている。「カスタム管理者ロールを使用する」を参照してください。
  • MCPサーバーをカスタム認可サーバーで保護する場合は、認可サーバーを作成済みであること。「認可サーバーを作成する」を参照してください。

手順

  1. Admin Consoleで、Applications and Resources > MCPサーバー(MCP Servers)に移動します。
  2. カスタムMCPを追加(Add custom MCP)をクリックします。
    MCPサーバーを追加する(Add MCP server)ページが開きます。
  3. MCPサーバーの名前、説明、リソース識別子URLを入力します。
  4. 保存(Save)をクリックします。
  5. 認可サーバーを追加します。

    Oktaがリソース識別子URLから認可サーバーを検出した場合、ページに表示されます。構成(Configure)をクリックすると、詳細が確認され、サーバーを追加するサブステップはスキップされます。

    1. 認可サーバーを追加(Add authorization server)をクリックします。
    2. 認可サーバーのタイプを選択します。
    3. 外部サーバー(External server)を選択する場合は、発行者(Issuer)、認可エンドポイントURL(Authorization endpoint URL)、トークンエンドポイントURL(Token endpoint URL)を入力します。認可サーバーが動的クライアント登録(DCR)をサポートしている場合は、DCR登録URLを入力します。
    4. Oktaカスタム認可サーバー(Okta custom authorization server)を選択する場合は、リストから使用したい認可サーバーを選択します。

      Oktaはカスタム認可サーバー向けのアプリ間アクセス(XAA)をサポートするため、資格情報は必要ありません。保存したら、完了して閉じる(Done and close)をクリックします。

  6. 保存(Save)をクリックします。
  7. 外部認可サーバーを使用している場合は、MCPサーバーの資格情報を追加します。
    1. クライアント資格情報名(Client credentials name)を入力します。
    2. クライアント登録タイプを選択します。

      保存後に別の登録タイプに切り替えることはできません。

    3. 静的資格情報(クライアントIDとシークレット)(Static credentials(client ID and secret))を選択した場合は、クライアントID(Client ID)とクライアントシークレット(Client secret)を入力します。

      クライアントは、クライアントIDとクライアントシークレットを必要とする認可コードフローを使用して、機密クライアントとして構成する必要があります。

    4. 動的クライアント登録(Dynamic Client Registration)を選択した場合、Oktaはクライアントをプロバイダーに登録し、資格情報を事前入力します。

      このオプションは、DCR登録URLを指定した場合のみ利用できます。

    5. スコープを選択または追加します。スコープは、メタデータ検出を通じて利用可能な場合、自動的に入力されます。
    6. さらにスコープを追加するには、追加(Add)をクリックします。
    7. 保存(Save)をクリックします。
  8. 資格情報を追加し、エージェントゲートウェイが有効になっている場合は、資格情報をテストしてツールを検出(Test credentials and discover tools)をクリックして、資格情報を検証し、利用可能なツールを表示します。
  9. 外部認可サーバー用にさらにクライアント資格情報セットを作成するには、追加(Add)をクリックして前の手順を繰り返します。
  10. 完了して閉じる(Done and close)をクリックします。

    MCPサーバーはMCPサーバー(MCP Servers)ページに表示され、次のいずれかのステータスになります。

    • アクティブ(ACTIVE): 新しく追加されたMCPサーバーのデフォルトステータスです。
    • 非アクティブ(INACTIVE):管理者がMCPサーバーを非アクティブ化しており、管理対象接続には使用できません。
    • 無効(INVALID): MCPサーバーに認可サーバー情報がないか、破損したメタデータが含まれています。
  11. さらに認可サーバーを追加するには、認可サーバーを追加(Add authorization server)をクリックして前の手順を繰り返します。

次のタスク

MCPサーバーとAIエージェントの間にリソース接続を作成します。「AIエージェントをリソースに接続する」を参照してください。