---
title: "Connecting Tugger to Perplexity"
slug: "connecting-tugger-to-perplexity"
updated: 2026-03-11T20:39:45Z
published: 2026-03-11T20:39:45Z
canonical: "docs.tuggerapp.com/connecting-tugger-to-perplexity"
---

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

# Connecting Tugger to Perplexity

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

Setup takes around 10 minutes.

> **Note:** Perplexity MCP is available through the Perplexity desktop app only, not the web version at perplexity.ai.

## What you'll need

- A **Tugger account** with at least one active connector that has completed its first sync
- **A Tugger API key** - your Tugger admin generates this from the API Keys tab in [MCP Configuration](/docs/tugger-mcp-configuration)
- The **Perplexity desktop app** installed on your computer - download from [perplexity.ai/hub/download](https://www.perplexity.ai/platforms)
- A **Perplexity Pro** account (MCP connectors are not available on the free plan)
- **Python** with `uv` package manager installed (used to install the MCP proxy tool)

## Step 1: Get your Server URL and API key from Tugger

Perplexity connects to Tugger using an API key rather than the OAuth login used by platforms like Claude and ChatGPT.

> **Note:** This step requires administrator access. If you're not an admin, ask your Tugger admin for the Server URL and an API key.

1. Log in to Tugger at [tuggerapp.com](https://tuggerapp.com)
2. Click **MCP Configuration** in the menu
3. On the **Setup Guides** tab, copy your **Server URL**

![Screenshot: MCP Configuration - Setup Guides tab showing Server URL with copy button](https://cdn.document360.io/915cfc9e-45d4-4924-af8d-4cea920ef985/Images/Documentation/mcsetupguides-server-url.jpg)

1. Switch to the **API Keys** tab
2. Click **Generate New API Key**
3. Enter a name (e.g. "Perplexity") and choose the integration scope and expiry as needed
4. Click **Generate Key**

![Screenshot: Generate New API Key dialogue with name and scope fields](https://cdn.document360.io/915cfc9e-45d4-4924-af8d-4cea920ef985/Images/Documentation/mcp-generate-new-api-key.jpg)

1. Copy the generated API key immediately - you won't be able to see the full key again

## Step 2: Install the MCP proxy tool

Perplexity's desktop app uses a local proxy to connect to remote MCP servers. Open a terminal and run:

```
uv tool install mcp-proxy
```

This installs the `mcp-proxy` bridge that allows Perplexity to communicate with Tugger's remote server.

> **Don't have `uv` installed?** You can install it by following the instructions at [docs.astral.sh/uv](https://docs.astral.sh/uv/getting-started/installation/).

## Step 3: Add the Tugger connector in Perplexity

1. Open the **Perplexity desktop app**
2. Go to **Settings** then **Connectors**
3. Click **Add connector** then **Advanced**

![Screenshot: Perplexity Settings - Connectors page with Add connector button](https://cdn.document360.io/915cfc9e-45d4-4924-af8d-4cea920ef985/Images/Documentation/perplexity-add-mcp-connector.jpg)

1. Enter a server name - for example: **Tugger**
2. Paste the following configuration, replacing the placeholder values with your Tugger details:

```
{
  "command": "mcp-proxy",
  "args": [
    "https://mcp.tuggerapp.com/mcp",
    "--transport=streamablehttp"
  ],
  "env": {
    "API_ACCESS_TOKEN": "YOUR_API_KEY"
  }
}
```

- Replace `YOUR_TUGGER_SERVER_URL` with the Server URL from Tugger's MCP Configuration page
- Replace `YOUR_API_KEY` with the API key you generated in Step 1

1. Click **Save**

## Step 4: Start asking questions

Open a new chat in Perplexity and start asking about your data. The Tugger connector should be active automatically.

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's there
- *"What are my top 10 customers by revenue?"* - if you have an accounting connector like Xero or QuickBooks

For more example prompts and tips on getting the best answers, see [Tips for Getting the Best Results from AI Insights](/docs/tips-for-getting-the-best-results-from-ai-insights).

## Troubleshooting

**"mcp-proxy: command not found"**

- Make sure `uv` is installed and the mcp-proxy tool was installed successfully. Try running `uv tool install mcp-proxy` again.

**Connector not appearing or failing to connect**

- Check that the Server URL and API key in your connector config are correct.
- Make sure the `mcp-proxy` command is available in your system PATH.
- Try restarting the Perplexity desktop app after adding the connector.

**Connected but no data showing**

- Check that at least one connector has completed its first sync in Tugger.
- Ask your Tugger admin to check the API key's scope in the API Keys tab. It may be restricted to specific connectors.

**Getting unexpected or incomplete results**

- Try being more specific in your questions - see [Tips for Getting the Best Results from AI Insights](/docs/tips-for-getting-the-best-results-from-ai-insights).
- Make sure the connector containing the data you're asking about is included in the API key's scope.

**API key stopped working**

- Check the API Keys tab in Tugger MCP Configuration. The key may have been revoked or expired.
- If revoked, your admin will need to generate a new key and you will need to update the connector config in Perplexity.

---

**Related articles:**

- [What is Tugger AI Insights?](/docs/what-is-tugger-ai-insights)
- [Tips for Getting the Best Results from AI Insights](/docs/tips-for-getting-the-best-results-from-ai-insights)
- [Tugger MCP Configuration](/docs/tugger-mcp-configuration)