Connecting Tugger to Cursor

# Connecting Tugger to Cursor

This guide walks you through connecting Tugger AI Insights to Cursor, so you can ask questions about your business data in natural language directly from your Cursor chat.

Setup takes around 5 minutes.

What you'll need

• A Tugger account with at least one active connector that has completed its first sync
• MCP access enabled by your Tugger admin - by default, users have no MCP access. Your admin needs to grant you access on the User Permissions tab in MCP Configuration before you can connect.
• Cursor installed on your computer - download it from cursor.com if you have not already. A free plan is sufficient to get started.

Step 1: Open Cursor Settings

1. Open Cursor
2. Click the cog icon (bottom-left of the window)
3. Select Settings from the dropdown menu
4. In the Settings sidebar, click Tools & MCP

You will see the Tools & MCP panel. If no MCP servers have been added yet, it will show "No MCP Tools" with an Add Custom MCP button.

Step 2: Add the Tugger MCP server

1. Click Add Custom MCP

This opens the mcp.json configuration file. Add the Tugger server entry so the file looks like this:

{
  "mcpServers": {
    "tugger": {
      "url": "https://mcp.tuggerapp.com/mcp"
    }
  }
}

2. Press Ctrl+S (or Cmd+S on Mac) to save the file

Step 3: Authorise the connection

After saving, go back to the Tools & MCP settings panel. Tugger will now appear under Installed MCP Servers with a yellow dot and a Connect button, indicating it needs authentication.

1. Click Connect
2. Your browser will open and you will see the Tugger login screen - log in with your Tugger credentials

3. Review the permissions and click Authorise
4. Once authorised, the browser window will remain open - you can close it manually and return to Cursor

Step 4: Restart Cursor

After authorising, you must restart Cursor for the changes to take effect.

1. Close Cursor completely
2. Reopen Cursor

Once restarted, go to Settings > Tools & MCP. Tugger should now show a green dot and display 8 tools enabled, confirming the connection is active.

Note: Your Tugger admin controls which connectors you can access through AI Insights. If you cannot see data from a particular connector, ask your admin to check your permissions in MCP Configuration.

Step 5: Start asking questions

You are all set. Open a new chat in Cursor and start asking about your data.

Try one of these to get started:

• "What connectors do I have access to in Tugger?" - a good first question to confirm what data is available
• "Show me a summary of my data" - lets the AI explore what is there
• "Can you give me a breakdown of customers by industry sector in a table?" - if you have a CRM connector like HubSpot

For more example prompts and tips on getting the best answers, see Tips for Getting the Best Results from AI Insights.

Troubleshooting

"Add Custom MCP" button does not appear

• Make sure you are in Settings > Tools & MCP. Access Settings by clicking the cog icon and selecting Settings from the dropdown.

Tugger shows "Needs authentication" but clicking Connect does nothing

• Check that your browser is not blocking popups from Cursor.

Tugger still shows "Needs authentication" after authorising

• Make sure you fully restarted Cursor after completing the OAuth flow. A full close and reopen is required.
• Remember to close the browser window that opened during authorisation before restarting Cursor.

Connected but no data showing

• Check that at least one connector has completed its first sync in Tugger.
• Ask your Tugger admin to check your access level on the User Permissions tab in MCP Configuration. By default, users have No Access and need to be granted permission.

Getting unexpected or incomplete results

• Try being more specific in your questions - see Tips for Getting the Best Results from AI Insights.
• Make sure the connector containing the data you are asking about is included in your MCP access permissions.

Need to disconnect or reconnect?

• In Cursor: open Settings > Tools & MCP, toggle Tugger off or remove it, then follow this guide again to reconnect.
• In Tugger: your admin can deactivate the OAuth client from the OAuth Clients tab in MCP Configuration.

Related articles:

• What is Tugger AI Insights?
• Tips for Getting the Best Results from AI Insights
• Tugger MCP Configuration