Assign Model Context Protocol (MCP) servers to an assistant

  • Release version: Zurich
  • Updated March 18, 2025
  • 1 minute to read
  • Assign configured Model Context Protocol (MCP) servers to enable users to access external data sources and tools. Assigning an MCP server to an assistant is only available when using premium chat.

    Before you begin

    See Add a Knowledge Graph schema to a chat assistant.

    Before assigning an MCP server to an assistant, make sure that:
    • The MCP server is created and available on the instance. For more information, see Add an MCP server in AI Agent Studio.
    • You know which users or roles should have access to the MCP-provided capabilities through the assistant.

    Role required: virtual_agent_admin or admin

    About this task

    Control which MCP servers are available to an assistant. After an MCP server is configured in AI Agent Studio, you can assign it to an assistant and configure role-based access for that assignment.

    MCP server assignments are configured at the assistant level. This lets you control which assistants can use specific MCP servers, and which users can access MCP-provided capabilities through each assistant. An assistant can only use the MCP servers that are assigned to it.

    Procedure

    1. Select the Add MCP server drop-down list to add an MCP server to your assistant.
      Figure 1. Add an MCP server
      Select an MCP server from the drop down list.

      Upon selection of an MCP server, the server populates in the list.

      Figure 2. MCP server list
      Edit or remove an MCP server by selecting the ellipsis.
      1. Select the ellipsis to add, edit, or remove a role.
        Figure 3. Add, edit, or remove a role
        Add roles.
        If roles aren't added, then all roles can access the specific MCP server.
      2. Select Manage MCP servers to add an MCP server.
    2. Select Save and continue.

    What to do next

    See Add assets to a chat assistant.