MCP Server Connection Management

Overview

MCP Server Connection Management lets you register server information so that QueryPie can connect to external MCP (Model Context Protocol) servers and manage connection settings, credential settings, audit settings, and tool synchronization status.

You can perform the following tasks on this screen.

• View the MCP Server list.
• Register a new MCP Server.
• Modify Basic Information, Connection Settings, and Audit Settings for a registered MCP Server.
• Synchronize and view the list of Tools provided by a server.
• Delete a registered MCP Server when necessary.

Viewing the MCP Server list

View the list of registered MCP Servers.

1. Go to Admin > MCP Servers > Connection Management > MCP Servers.
2. Review the server information in the list.
3. Click Create Server in the upper-right corner to register a new server.
4. Click the refresh button to reload the list.
5. Click a server in the list to go to its detail page.

The list contains the following columns.

• Name: Display name of the server
• Identifier: Internal server name
• Endpoint: MCP Server address
• Transport: Transport type used for the connection
• Tools: Number of synchronized tools
• Audit: Whether Request Audit is enabled
• Updated: Time of the last update

Adding an MCP Server

Register a new MCP Server.

1. Click Create Server.
2. Enter the following information in Basic Information.
   • Identifier: Identifier used internally for the remote MCP Server. Uppercase letters are not allowed. It cannot be changed after creation.
   • Name: Display name of the remote MCP Server.
   • Icon: Upload and register an icon of your choice.
   • Description: Description of the remote MCP Server.
3. Enter the following information in Connection Settings.
   • Endpoint URL: Endpoint URL for connecting to the remote MCP Server.
   • Transport: Select the transport type of the remote MCP Server. Select either SSE or Streamable HTTP.
   • Credential Mode: Select None, QueryPie Registered Credential, or User OAuth.
     • None: Use this when the remote MCP Server does not require authentication.
     • QueryPie Registered Credential: Select this to manage the authentication token in QueryPie MAC. When you select QueryPie Registered Credential, the QueryPie Upstream Access Token field appears. Enter the MCP Server authentication token in this field. MAC does not generate an MCP Server authentication token. You must generate a token for MCP use in the corresponding service. For detailed instructions, refer to that service’s guide.
     • User OAuth: Use this when the remote MCP Server uses OAuth authentication. The administrator must authenticate with OAuth on behalf of a user to retrieve the list of tools available from the MCP Server. This is unrelated to the user’s OAuth authentication and is used only to retrieve the tool list.
4. If necessary, run Test Connection to check whether QueryPie can connect using the values currently entered.
5. Configure the request audit options in Audit Settings.
   • Refer to “Understanding Audit Settings” below.
6. Click Save.

Understanding Audit Settings

Audit settings in MCP Access Control are divided into two audit scopes.

• Audit Settings on each MCP Server detail page: Per-server audit settings for requests forwarded to a specific upstream MCP Server
• Audit settings in Admin > MCP Servers > General > Configurations: Global audit settings for requests sent from an MCP client to QueryPie MAC

Therefore, when interpreting request audits, check which setting applies to each log scope.

Audit scope: QueryPie MAC to Remote MCP Server

• When Enable Request Audit is enabled in Audit Settings for an MCP Server,
  QueryPie MAC records upstream requests forwarded to that Remote MCP Server in the request audit log.
  • The Audit column on the MCP Server list also reflects this value.
  • When this option is turned off, upstream request audit logs for that server are not recorded.
  • View request audit logs in Admin > Audit > MCP > Request Audit.
• When Include payload in Request Audit is enabled in Audit Settings for an MCP Server,
  the payload and response are stored with request audit logs for that MCP Server.
  • In addition to recording the upstream request itself, the audit record includes the payload and response.
  • This option is available only when Enable Request Audit is enabled.
  • When Enable Request Audit is turned off, this option is disabled and its value is also turned off when you save.

Audit scope: MCP Client to QueryPie MAC

The Admin > MCP Servers > General > Configurations screen contains global settings for client-originated audits.

• Client Request Audit: When enabled, MCP requests sent from a client to QueryPie MAC are recorded in the audit log.
  • The audit subject is a client-originated MCP request, not an individual upstream MCP Server.
  • When disabled, no client request audit event is created.
• Include payload in Client Request Audit: When enabled, the payload and response are stored with the client-originated MCP request audit log.
  • This option appears only when Client Request Audit is enabled.
  • When disabled, the client request audit event is recorded, but the payload and response bodies are excluded.

Modifying an MCP Server

Change the settings of an existing MCP Server. You can synchronize Tools for an MCP Server only from the edit detail screen after registering the server.

1. Click the server to modify in the MCP Server list.
2. On the detail page, review and modify the following sections.
   • Basic Information
   • Connection Settings
   • Audit Settings
   • Tools
     Synchronize the list of tools provided by the registered MCP Server.
     If authentication is required, you must authenticate before synchronization.
     • Click Sync Tools.
     • When synchronization is complete, you can see the number of detected tools and the last synchronization time.
     • The Tools table shows the following information.
       • Tool Name: Name of the tool.
       • Description: Detailed description of the tool.
       • Last Synced: Time of the last synchronization.
3. Click Save Changes after making changes.

Deleting an MCP Server

Delete a registered MCP Server.

1. Select one or more servers in the list.
2. Run the delete action.
3. Approve the confirmation message to delete the selected servers.

You can also delete a single server from its detail page.