MCP server record

  • Release version: Australia
  • Updated November 23, 2025
  • 3 minutes to read
  • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of MCP server record

    The MCP server record in ServiceNow provides a comprehensive view and management capabilities for MCP servers integrated with the AI Gateway and AI Control Tower. It enables tracking of server details, approval workflows, observability metrics, AI Gateway setup, client integrations, and variant mappings.

    Show full answer Show less

    Tabs and Their Functions

    • Details: Displays all asset details including the MCP server URL.
    • Approvals: Shows approval requests related to the MCP server. Note that with the AI Control Tower Pro license, the approval start button may not appear after synchronization; a manual script update is required to set lifecycle phase and status correctly.
    • KPIs & Metrics: Presents observability metrics such as total requests, success rates, and latency for approved, running servers. Similar usage data is also available on the AI Gateway tab in AI Control Tower.
    • AI Gateway setup: Visible after MCP server approval, this tab allows pausing/resuming AI Gateway transactions for the server and adding MCP Client integrations. It shows automatically generated, unmodifiable URLs for the gateway endpoint and OAuth authorization/token endpoints.
    • MCP Client Integration: Lists registered clients for the server, each requiring its own client ID and secret. New client integrations can be added here to enable features like AI Agent Studio for linear MCP servers.
    • Related Variants: Provides a one-to-one mapping of MCP server entries from AI Agent Studio, enabling multiple servers of the same variant to be tracked and managed. Includes the option to activate PII checks to block transactions sharing sensitive data.

    Key Practical Insights for Customers

    • Use the Approvals tab to monitor and manage MCP server approval workflows; be aware of license-based behavior differences and manual status updates when needed.
    • The KPIs & Metrics tab equips AI stewards with essential server performance data to monitor health and usage effectively.
    • The AI Gateway setup tab enables control over AI Gateway transactions, including pausing problematic servers and managing client integrations seamlessly.
    • Global MCP Clients can be configured once on the AI Control Tower Configurations page and reused across all servers, reducing administrative overhead.
    • The Related Variants tab ensures full visibility and governance over multiple MCP servers of the same variant and helps enforce sensitive data protection through PII checks.

    Explore the MCP server record and its associated tabs.

    The MCP server record has the following tabs:

    1. Details: Displays all the asset details along with the MCP server URL at the bottom of the page.
    2. Approvals: Displays all the approval requests for the MCP server.
      Note:

      When MCP servers are synced to the AI Gateway with the AI Control Tower Core (with Now Assist), an option appears in AI Control Tower to start the approval process. However, with the AI Control Tower Pro license version, the button doesn’t appear after the synchronization job runs, and the Lifecycle status is shown as None.

      This behavior is known. As a workaround, verify that the lifecycle phase is set to New and the lifecycle status is set to AI steward review for the relevant sn_ai_governance_asset_governance_details record.

      Manually run a script to verify.

      var assetGovernanceRecord = new GlideRecord('sn_ai_governance_asset_governance_details');
      
      if (assetGovernanceRecord.get('<sys_id of asset governance record>')) {
      
          assetGovernanceRecord.setValue('status', 5);
      
          assetGovernanceRecord.setDisplayValue('lifecycle_phase','New');
      
          assetGovernanceRecord.update();
      
      }

      For more information on workflow of MCP server approval request, see Explore the MCP server approval workflow.

    3. KPIs & Metrics: Displays the MCP tools observability metrics for each server, which is approved and running. In the KPIs & Metrics tab, the AI steward can view different tools, which have been invoked across gateway usage from different hosts. The tab shows the total number of requests sent, the success rate, and any latency observed.
      Note:
      The AI Gateway tab in AI Control Tower tab on the AI Control Tower landing page also displays server usage. It shows the total number of requests or transactions and the corresponding success rate.
    4. AI Gateway setup: The AI Gateway setup tab appears only after an MCP server request is approved. From the AI Gateway setup tab, you can pause the AI Gateway transaction of the MCP server and add an MCP Client integration. The AI Gateway setup tab is accessible for all AI Control Tower workspace users.

      The AI Gateway setup tab has these sections:

      • AI Gateway MCP server details: Displays the following URLs:
        • AI Gateway MCP server URL: The Gateway endpoint that clients connect to.
        • Authorization endpoint URL: OAuth authorization endpoint.
        • Token endpoint URL: OAuth token exchange endpoint.
        Note:
        All these URLs are generated automatically and can’t be modified.

        If an MCP server is identified as malicious for a certain period, the AI stewards can pause all transactions directed to that server through the AI Gateway. Once the risk is resolved, transactions can be resumed. Similarly, at the AI Gateway level, it’s possible to pause all transactions across all servers from the AI Gateway page in the Configurations section of AI Control Tower.

      • MCP Client Integration: Displays Registered clients for the server. Each agent builder requires its own client registration and MCP client Integration generates a client ID and client secret. If you want to enable AI Agent Studio for a linear MCP server, you can create an MCP client integration by selecting Add.
        Note:
        For more information Gateway setup and MCP Client Integration, see Set up the AI Gateway and Client registration.
      • Global MCP Clients: Global MCP clients are set up separately from server records. You can configure them on the Configurations page of AI Control Tower in the AI Gateway section. Once they're created, they're automatically available across all MCP servers, so there's no need to set up individual client integrations for each server.
    5. Related Variants: The Related Variants tab provides a one-to-one mapping of all the MCP server entries from AI Agent Studio, so that each entry is visible and trackable in AI Control Tower. In the Related Variants tab, you can have multiple MCP servers of the same variant.
    Note:
    The AI steward can activate sensitive data protection for any transaction across servers by selecting Activate PII check. By activating, the AI gateway blocks those transactions, which involve sharing sensitive information to the MCP server.