> For the complete documentation index, see [llms.txt](https://docs.zigpoll.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zigpoll.com/integrations/mcp/mcp-perplexity.md).

# Connect to Perplexity

Connect Zigpoll to Perplexity as a custom connector so it can analyze your survey data and create surveys in natural language.

Connect your Zigpoll surveys to **Perplexity** as a custom connector using the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/). Once connected, Perplexity can read your survey responses, run analytics, and create surveys — just ask in plain English.

For other AI clients, see the [MCP overview](/integrations/mcp.md).

{% hint style="warning" %}
**Plan requirement:** MCP uses the Zigpoll API, which is included on the **Premium** plan and higher.
{% endhint %}

{% hint style="info" %}
Custom connectors require a paid Perplexity plan (**Pro**, **Max**, or **Enterprise**) and are available in Perplexity on the web and in the desktop apps. The Comet browser currently only supports Perplexity's built-in connector catalog, not custom connectors.
{% endhint %}

{% hint style="info" %}
**How authorization works:** there's no API key to copy or paste. When you connect, Perplexity opens a browser window to authorize with Zigpoll. If you're already logged into Zigpoll in that browser, authorization completes automatically; if not, sign in with your email and password, Google, or Shopify. Perplexity then stores a secure token, so you only do this once.
{% endhint %}

## Step 1: Open Connectors

1. In Perplexity, open your account menu and go to **Settings** (may appear as **All settings**).
2. Select **Connectors**.
3. Click **+ Custom connector**.

## Step 2: Add the Zigpoll connector

1. Choose **Remote** as the connector type.
2. Enter the details:
   * **Name:** `Zigpoll`
   * **MCP Server URL:** `https://mcp.zigpoll.com/mcp`
   * **Authentication:** **OAuth 2.0**
3. Acknowledge the third-party connector notice and click **Add**.

{% hint style="warning" %}
Don't choose **API Key** authentication or enter a key into a header field. `mcp.zigpoll.com` uses a browser-based OAuth login tied to your Zigpoll account and does not accept a static API-key or `Authorization: Bearer` header. Your login is exchanged for a secure token in the next step.
{% endhint %}

## Step 3: Authorize with Zigpoll

When you add the connector (or first use a Zigpoll tool), a browser window opens to authorize with Zigpoll. If you're already logged into Zigpoll, authorization completes automatically after a brief loading screen. Otherwise, sign in with your email and password, Google, or Shopify. Perplexity stays connected for future sessions.

## Step 4: Use it

Ask Perplexity to work with your survey data. Being explicit helps it pick the right tool, e.g.:

> "Use Zigpoll to list my accounts"

> "Use Zigpoll to summarize the responses from my NPS survey"

## Example prompts

* "List all my surveys and their response counts"
* "Where are my survey respondents located?"
* "Compare order values for each answer on my attribution question"
* "Create a new customer satisfaction survey"

For the full list of tools and more examples, see the [MCP overview](/integrations/mcp.md). For ideas on what to build, see [Ideas for Using Zigpoll MCP](/tutorials/zigpoll-mcp-use-cases.md).

## Troubleshooting

* **No "+ Custom connector" option** — custom connectors require a Pro, Max, or Enterprise plan. On Enterprise, an admin may need to enable **Allow members to add custom connectors** in the organization's Connectors settings.
* **Connector won't verify or no tools load** — confirm the URL is exactly `https://mcp.zigpoll.com/mcp` and that authentication is set to **OAuth 2.0**.
* **No authorization window appears** — trigger a Zigpoll tool in a thread to start the login, or remove and re-add the connector from **Settings → Connectors**.
* **Connected to the wrong Zigpoll account** — authorization uses whichever Zigpoll login is signed in to your browser. Log in as the correct user at [app.zigpoll.com](https://app.zigpoll.com), then remove and re-add the connector.
* **Authentication errors** — the connection authenticates with an API key labeled "MCP" that Zigpoll creates automatically. If it was revoked under **Integrations → API Keys**, remove and re-add the connector to issue a new one. A static API-key header is not supported; authentication must go through the browser login flow.
* **"This account's plan does not include API access"** — the Zigpoll account is on a plan without API access. Upgrade to **Premium** or higher.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.zigpoll.com/integrations/mcp/mcp-perplexity.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.