Integrations
Connect Telegram to ChatGPT
ChatGPT can read your Telegram archive through a custom connector. You run dotiphant mcp --http on your computer behind an HTTPS tunnel, add the tunnel address in ChatGPT, and approve the connection with a one-time pairing code.
Custom connectors need a paid ChatGPT plan, and your computer has to be on while you use it.
Why ChatGPT needs a tunnel
Claude Desktop, Claude Code, Codex and Cursor run on your computer and start Dotiphant themselves. ChatGPT runs on OpenAI's servers. It can only reach MCP servers on the internet over HTTPS, and your archive lives on your own computer, with no cloud service in between.
So you give your computer a public HTTPS address with a tunnel (ngrok, Tailscale Funnel or Cloudflare Tunnel). The tunnel forwards requests to Dotiphant on 127.0.0.1. Dotiphant itself never listens on your network.
The risk, plainly
- Remote access is the riskiest way to use Dotiphant. It exposes your archive through a tunnel you run, on a public HTTPS address.
- Every app needs your approval before it can read anything, in your terminal or with a one-time pairing code.
- Limit what AI apps can see with
dotiphant ai: hide single chats, or share only the chats you choose. - If you don't need a remote app, don't set it up. Claude Desktop, Claude Code, Codex and Cursor run on your computer and need no tunnel.
The trade-offs
- Anyone who finds the tunnel address still needs your approval. Approving takes a command in your terminal or a one-time pairing code that only appears on your computer.
- OpenAI sees the messages ChatGPT reads to answer you: text, sender names, chat names and dates. That is how every connector works.
- Your computer must be on, awake and running both Dotiphant and the tunnel. Stop both when you no longer need them.
- Custom connectors need a paid ChatGPT plan and work in ChatGPT on the web.
- A Cloudflare quick tunnel gets a new address every time it starts, so you have to update the connector each time. ngrok's free fixed domain and Tailscale Funnel keep the same address.
Step 1: start a tunnel
Install Dotiphant and finish the setup first (see Install). Then pick one tunnel and keep it running in its own terminal. Each prints an https:// address.
ngrok http 8766tailscale funnel 8766cloudflared tunnel --url http://127.0.0.1:8766ngrok needs a free account and its ngrok config add-authtoken step. Tailscale Funnel must be allowed for your tailnet. Cloudflare's quick tunnel needs no account.
Step 2: start Dotiphant
In another terminal, with your tunnel address:
dotiphant mcp --http --public-url https://abc.ngrok.appIt prints the pairing code. Leave it running. --public-url tells Dotiphant its public name, so its approval pages and host check use that address; it still listens only on 127.0.0.1.
Step 3: add the connector in ChatGPT
- Open Settings > Apps & Connectors > Advanced settings and turn on Developer mode.
- Back in Apps & Connectors, choose Create.
- Enter a name, like "Dotiphant", and your tunnel address with
/mcpat the end, likehttps://abc.ngrok.app/mcp. Choose OAuth as authentication and leave the client id and secret empty: ChatGPT registers itself. Confirm that you trust the connector. - The approval page opens. Check the return address: its host should be
chatgpt.com. Then enter the pairing code and choose Approve. - In a new chat, turn on the connector from the tools menu.
Menu names may differ between versions and plans.
Approving safely
The approval page shows the app's name and the full address your browser returns to, with the host highlighted. The app name is chosen by the app and proves nothing. The host is what counts.
The safer way is the terminal: the page shows a command like dotiphant mcp --approve K7QM-2XPA. Run it on your computer. It prints the app name and the exact return address and asks y/N. Then choose Continue on the page.
The pairing code works once and expires after 30 minutes. Five wrong codes close that approval request. Run dotiphant mcp --pair to see the current code or get a new one.
Managing access
dotiphant mcp --clients # apps you approveddotiphant mcp --revoke CLIENT_ID # remove one appdotiphant mcp --revoke all # remove every approved appA revoked app's tokens stop working at once. ChatGPT can search and read your archive and start a refresh, at most one sync per minute. It can never send anything to Telegram through Dotiphant.
If it does not connect
- "Invalid Host header": the address in
--public-urldoes not match the tunnel. Restart Dotiphant with the exact address. - ChatGPT cannot connect: check that both the tunnel and
dotiphant mcp --httpare running, and that the URL ends in/mcp. - The code expired: run
dotiphant mcp --pairfor a new one, or approve in the terminal.
Every detail, including Tailscale and Cloudflare setup, is in the remote access docs. What is stored and who can reach it: Security and privacy.
Install Dotiphant
Free and open source (MIT). macOS and Linux; Windows experimental. The command installs the latest GitHub release and opens the setup in your browser. It takes about five minutes.
The script is about 150 lines. Read it first, or see other ways to install. The installer verifies the download against the release checksums (SHA256SUMS) before installing. You can check signed build provenance with gh attestation verify; see Verify a download.
curl -fsSL https://dotiphant.com/install.sh | shdotiphant open # setup opens in your browser