> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://help.sigmacomputing.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://help.sigmacomputing.com/_mcp/server.

# Add MCP tools to Sigma (Beta)

> Integrate MCP servers with Sigma agents to extend context, fetch ad hoc data, and trigger actions in third-party tools.

This documentation describes one or more public beta features that are in development. Beta features are subject to quick, iterative changes; therefore the current user experience in the Sigma service can differ from the information provided in this page.

This page should not be considered official published documentation until Sigma removes this notice and the beta flag on the corresponding feature(s) in the Sigma service. For the full beta feature disclaimer, see [Beta features](/docs/sigma-product-releases#beta-features).

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

For example, set up one or more of the following MCP servers in Sigma to provide context to a Sigma agent:

* The [Sigma MCP server](/docs/use-sigma-mcp-server) to retrieve information about documents in Sigma.
* The <a href="https://support.atlassian.com/atlassian-rovo-mcp-server/docs/getting-started-with-the-atlassian-remote-mcp-server/" target="_blank">Atlassian Rovo MCP Server</a> to retrieve and update Jira tickets.
* The <a href="https://slack.com/help/articles/48855576908307-Guide-to-the-Slack-MCP-server" target="_blank">Slack MCP server</a> to retrieve context from Slack conversations.
* The Microsoft <a href="https://learn.microsoft.com/en-us/microsoft-agent-365/mcp-server-reference/sharepoint" target="_blank">Work IQ SharePoint MCP server</a> to retrieve contents of small files in SharePoint sites for context.

The use of AI features is subject to the following [disclaimer](/docs/notice-for-enabling-ai-enabled-features-in-sigma).

To allow a Sigma agent to use an MCP server:

1. [Add the server to Sigma as an MCP tool](#add-an-mcp-server-to-sigma-as-an-mcp-tool).
2. [Grant access to the MCP tool](#grant-access-to-the-mcp-tool).
3. [Add the MCP tool to a Sigma agent](/docs/build-agents#add-an-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](/docs/create-and-manage-account-types) 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 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](/docs/configure-api-credentials-and-connectors-in-sigma#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**.

After you grant access, users can view MCP connectors available to them in **Profile** > **Integrations** under **Available MCP connectors**.

To add an MCP tool to a Sigma agent, see [Build Sigma agents](/docs/build-agents#add-an-mcp-tool-to-a-sigma-agent).

## Related resources

* [Build Sigma agents (Beta)](/docs/build-agents)