Connect Warplet to Claude

How to add your Warplet MCP URL as a custom connector in Claude, and how to fix the authorization and stale 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. A connector you add in Claude works in Claude Desktop, the mobile apps, and claude.ai.

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://claude.ai/settings/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. Click Add.

  5. Find the connector in the list and click Connect. 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 shows an error right away: open Warplet and check that it shows as connected, then retry.
  • 401 error: the token was probably regenerated in Warplet after the connector was authorized. Disconnect the connector, click Connect, and paste the current token.
  • Claude does not use your tools: check that the connector is on in that chat's tools menu. New chats do not inherit the toggles from an old one.
  • A tool is missing or no longer exists: disconnect and reconnect 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: