Connect Warplet to ChatGPT

How to add your Warplet MCP URL to ChatGPT as a custom plugin, 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. ChatGPT adds a custom MCP server as a plugin, which then works in ChatGPT on desktop, mobile, and web.

Add the plugin

  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 plugin per URL.

    The Warplet app showing connection details and per-server URLs

  2. Open https://chatgpt.com/plugins, click Add, then choose Custom Connector.

  3. Fill in the Add custom MCP server form:

    • Name: the name of the app you're exposing, like DEVONthink or Obsidian
    • Description: optional
    • Connection: leave Server URL selected and paste your Warplet URL
    • Authentication: OAuth
  4. Check I understand and want to continue, then click Create as a plugin.

  5. 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 plugin fails to create, or the URL is rejected: open Warplet and check that it shows as connected, then try again.
  • 401 error: the token was probably regenerated in Warplet after the plugin was authorized. Reauthorize and paste the current token.
  • A tool is missing or no longer exists: remove and re-add the plugin to refetch the tool list.
  • Calls fail even though the plugin 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:

To use a connector from an OpenAI dot, see Connect OpenAI Dots to the apps on your Mac.