Connect Warplet to Perplexity

How to add your Warplet MCP URL as a custom connector to Perplexity, and how to fix the authorization and tool list problems that come up.

Warplet connects hosted AI clients to MCP servers running on your Mac. If you have not set it up yet, start with How to use Warplet. Perplexity keeps connectors on your account page, so one you add is available in every conversation.

Add the connector

  1. In Warplet, copy the URL for the server you want from Use these URLs to connect your favorite LLM. Each MCP server has its own URL; add one connector per URL.

    The Warplet app showing connection details and per-server URLs

  2. Open https://www.perplexity.ai/account/connectors and click Add Custom Connector.

  3. Fill in:

    • Name: the name of the app you're exposing, like DEVONthink or Obsidian
    • Remote URL: your Warplet URL
  4. Save the connector.

  5. Click Connect or Authorize next to it. When the Warplet authorization page appears, paste the bearer token from the Warplet app and approve. The token works like a password for your tunnel, so paste it nowhere else.

    The Warplet authorization page asking for a bearer token

Troubleshooting

  • The connector saves but will not connect: open Warplet and check that it shows as connected, then click Connect again.
  • 401 error: the token was probably regenerated in Warplet after the connector was authorized. Reauthorize and paste the current token.
  • Perplexity answers from the web instead: name the source in your question, for example "search my DEVONthink archive for...".
  • A tool is missing or no longer exists: reauthorize the connector to refetch the tool list.
  • Calls fail even though the connector is connected: start the local app the URL points at. Warplet cannot launch it for you.

Now connect an actual app

What the AI can do depends on which local MCP server the URL points at: