AdminOrganization settingsConfigure AI features for your organization

Add MCP tools to Sigma

View as Markdown

You can use MCP servers with Sigma agents to add context to your conversation, retrieve ad hoc data, or permit the agent to take action in third-party tools.

The use of AI features is subject to the following disclaimer.

To allow a Sigma agent to use an MCP server:

  1. Add the server to Sigma as an MCP tool.
  2. Grant access to the MCP tool.
  3. Add the MCP tool to a Sigma agent.

Requirements

  • To add an MCP server as an MCP tool and grant access to the MCP tool, you must be assigned the Admin account type.
  • To add an MCP tool to a Sigma agent, you must have Can edit access to the workbook that contains the agent, and you must be granted Can use access to the MCP tool.

Add an MCP server to Sigma as an MCP tool

To add an MCP server to Sigma for agents to use as a tool:

  1. Go to Administration > MCP tools.

  2. Click Add MCP tool.

  3. For Name, enter a name for the MCP tool. For example, “Sigma documentation”. The agent uses the name of the tool as guidance to determine whether to use the tool.

  4. For Description, enter a description about the MCP tool. Sigma agents use the description to determine whether to use the tool. For example, “Use this tool to answer questions about Sigma’s features, functionality, and documentation. Consult it when users ask how to perform a task in Sigma, need troubleshooting help, or want to learn about a specific Sigma feature.”

  5. For Base URL, enter the URL for the MCP server. For example, https://help.sigmacomputing.com/mcp.

  6. For Prompt, enter additional instructions to share with the Sigma agent when using the MCP server, such as guidance for using specific tools. For example, “Use the search tool to search documentation pages and fetch to return details about documentation pages returned by search. Summarize responses to less than 500 characters and provide links to learn more and cite your sources every time.”

  7. For Authentication credential, choose the relevant option for the MCP server:

    • If the MCP server does not require authentication, leave the default of No authentication selected. For example, the Sigma documentation MCP server does not require authentication.
    • If the MCP server uses authentication, add an authentication credential. See Add a new API credential to Sigma for instructions.

  8. Click Submit.

    You can test the MCP tool to confirm the definition and authentication work successfully, and list the available tools for the MCP server that you added.

Grant access to the MCP tool

After adding an MCP tool, grant access to allow other users in Sigma to use the tool:

  1. Go to Administration > MCP tools.

  2. Select the MCP tool to which you want to grant access. For example, “Sigma documentation”.

  3. In the Connector access section, click Grant access.

  4. Search for and select users and teams to which you want to grant access:

    • To grant a user or team access to manage the MCP tool, such as updating the instructions or description, grant Can edit access.
    • To grant a user or team access to use the MCP tool, such as by adding the MCP tool to a Sigma agent, grant Can use access.

  5. (Optional) Add a message to include with an email notification, or deselect the checkbox to skip sending an email.

  6. Click Save.

Add an MCP tool to a Sigma agent

To add an MCP tool to a Sigma agent, do the following:

  1. Open a workbook for editing.
  2. In the editor panel, select Agents.
  3. For the relevant agent, select More > Edit.
  4. For MCP tools, click Add MCP tool (+).
  5. Search for and select the relevant MCP tool.
  6. Update the instructions for the agent with guidance for using the MCP tool.
  7. (Optional) Select Preview and enter a prompt to test the agent’s ability to use the new MCP tool.
  8. Click Save.

For more details about setting up Sigma agents, see Create and manage Sigma agents.