Add MCP tools to Sigma (Beta)

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.

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 either the Admin account type or an account type with the Manage MCP tools permission enabled.

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 MCP server URL, enter the URL for the MCP server. For example, https://help.sigmacomputing.com/mcp.

   Sigma automatically validates the URL. If the MCP server uses OAuth and supports Dynamic Client Registration, you can click Authorize to authorize the MCP server.

   📘

   When chatting with a Sigma agent that uses the MCP tool, if the user's OAuth token for the MCP server is expired, the user is prompted to authorize to the MCP tool, ensuring that MCP tools use the correct permissions.

6. For Instructions, enter additional guidance to share with a 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 OAuth for authentication and supports Dynamic Client Registration, click Authorize in step 5 to automatically add an OAuth API credential for the server.
   • If the MCP server uses another method for authentication, including an OAuth connection that does not support Dynamic Client Registration, add an authentication credential. See Add a new API credential to Sigma for instructions.

8. (Optional) Click Test to test the MCP tool and confirm the definition and authentication work successfully. After testing, you can review the list of available tools for the MCP server that you added.

9. Click Save.

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. To grant all users in your organization access to use the tool, search for and add All members of your Sigma organization.

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

6. Click Save.

To add an MCP tool to a Sigma agent, see Sigma agents.