---
title: Cloudflare Quick Tunnels - Beeper Developer Docs
description: Use Cloudflare's TryCloudflare tunnels to share the Beeper Desktop API or MCP server over HTTPS in a few commands.
lastUpdated: 2026-02-23T00:29:17.000Z
---

Understand the risks

Beeper Desktop API is designed to be used locally on your computer. Exposing it to the internet can expose chat history and might allow others to send messages on your behalf. Please only continue if you understand the risks.

Beeper is not responsible for any consequences arising from exposing Beeper Desktop API to the internet.

Also note that Beeper has no affiliation with Cloudflare and this guide is for educational purposes only.

Cloudflare’s Quick Tunnels spin up an HTTPS endpoint that forwards traffic straight to your local Beeper Desktop API. The tunnel lives only as long as the `cloudflared` process runs, making it ideal for testing and personal usage.

Before you begin, make sure **Remote Access** is enabled in **Settings** → **Developers** → **Beeper Desktop API** → **Advanced settings** so the server listens on all interfaces.

Cloudflare Quick Tunnels do not support Server-Sent Events (SSE) (`/v0/sse`), so if you are using the MCP server you must use the Streamable HTTP transport (`/v0/mcp`).

[Read more about Remote Access](/desktop-api/advanced/remote-access/index.md)

## Install `cloudflared`

- [macOS](#tab-panel-48)
- [Windows](#tab-panel-49)
- [Linux](#tab-panel-50)

Install via Homebrew:

macOS

```
brew install cloudflare/cloudflare/cloudflared
```

Use Windows Package Manager:

Windows

```
winget install Cloudflare.cloudflared
```

Download the latest release and install it manually:

Debian/Ubuntu

```
curl -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64.deb -o cloudflared.deb
sudo dpkg -i cloudflared.deb
```

Make sure to check Cloudflare’s [Downloads page](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/) for the most up-to-date instructions.

## Launch a quick tunnel

1. **Start the tunnel**

   Forward Beeper Desktop

   ```
   cloudflared tunnel --url http://localhost:23373
   ```

2. **Copy the forwarding URL**

   `cloudflared` prints a line similar to `https://example.trycloudflare.com`. Append `/v0/mcp` for the MCP server.

3. **Authenticate from your remote tool**

   Use the standard OAuth or token flow. Cloudflare preserves forwarded headers, so the Desktop API generates redirect URLs based on the public hostname automatically.

### Keep the tunnel online

The URL is only valid while the `cloudflared` process runs. Use a session manager such as `screen`, `tmux`, or a background service if you need to keep it available. Press `Ctrl` + `C` to close the tunnel immediately.

## Harden for stable deployments

Cloudflare Quick Tunnels has request limits and no authentication. For persistent deployments on Cloudflare, you can use Cloudflare Zero Trust:

[Set up a named Cloudflare Tunnel](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/get-started/)

Zero Trust tunnels let you pin a hostname, enforce identity checks, and restrict IP ranges—all without changing your local Beeper Desktop configuration.