> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withdovetail.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrations and MCP Connections

> How to connect integrations and add MCP servers.

Integrations allow the software and agent to work with third-party tools you use.

## Open Integrations

1. In Formly, open **User Settings**.
2. Go to **Integrations**.
3. Review the available built-in integrations and MCP connections.

## Built-In Integrations

Formly currently shows built-in cards for:

1. GitHub
2. Linear
3. Jira
4. Atlassian MCP
5. Slack

Depending on the integration, you can connect, disconnect, test the connection, or control **Agent Access**.

For information on connecting Formly's own first-party MCP server, see [MCP Server](/formly-for-ai/mcp-server).

## Add a Custom MCP Connection

1. Click **Add Integration**.
2. Enter a **Connection Name**.
3. Enter an **MCP Server URL** that starts with `https://`.
4. Leave **Access Token** empty to use OAuth, or provide a token for a manual bearer-token connection. We recommend using OAuth.

## Atlassian MCP Setup

Use the built-in **Atlassian MCP** card when you want to connect to Atlassian's hosted MCP server.

Before you click **Connect** in Formly, make sure your Atlassian admin has allowed our Formly callback domain:

1. Open `https://admin.atlassian.com`
2. Select your Atlassian organization
3. Go to **Apps -> AI settings -> Rovo MCP server**
4. Click **Add domain**
5. Add the Formly domain that receives the OAuth callback: `https://api.formly.ai/**`

## Manage Existing MCP Connections

For each MCP connection card, you can:

1. Run **Test**
2. Disconnect the connection
3. Toggle Agent Access to control whether the third-party system should be available to the agent. This allows you to control the number of tools available to the agent. We generally recommend only enabling the integrations you need for a specific task and disabling them if not needed.

## Troubleshooting

If an MCP connection fails:

1. Confirm the MCP URL is valid and starts with `https://`
2. Retry the OAuth flow and make sure popup windows are not blocked
3. Verify the provider account, permissions, and callback setup
4. For Atlassian MCP, confirm the callback domain is allowed in **Atlassian Administration -> Apps -> AI settings -> Rovo MCP server**

If the OAuth flow succeeds but the card does not update, refresh **User Settings** and retry once.