ChatGPT

Connect Tvix to ChatGPT as a custom MCP app using OAuth.

ChatGPT requires a public HTTPS MCP URL (it rejects localhost and plain HTTP). Use Agents → + Add Agent → ChatGPT — the wizard shows simple steps, and only asks you to paste a URL once HTTPS is ready.

Setup (cloud / production)

1. Agents → + Add Agent → ChatGPT.
2. In ChatGPT: Settings → Apps → Advanced Settings → Developer mode → Create app.
3. Fill in:
   • Name: Tvix
   • Description: Tvix MCP server
   • URL: https://api.tvix.ai/mcp (or the HTTPS URL the wizard shows)
   • Authentication: OAuth
4. Complete the browser consent flow.

ChatGPT discovers OAuth from the MCP host (/.well-known/oauth-*). You do not paste a Bearer agent token.

Setup (Tvix for Mac / local)

Memories live on your Mac. ChatGPT can’t reach 127.0.0.1, so share the API once:

1. Agents → + Add Agent → ChatGPT → Enable remote agents (Tvix starts a Cloudflare quick tunnel and sets MCP_PUBLIC_URL).
2. Copy the HTTPS MCP URL the wizard shows.
3. In ChatGPT: create the app with that URL and OAuth, then complete consent.

CLI alternative: ./local/scripts/tvix-local.sh start-mcp-tunnel (or paste a tunnel origin with set-mcp-public-url).

Connecting ChatGPT to cloud api.tvix.ai will not see Mac-local memories. See Tvix for Mac.

Shared brain with Gemini / Claude / Cursor

After MCP is connected, paste the wizard’s Shared brain instructions into ChatGPT custom instructions. Then ChatGPT will call sync_memory_context at the start of each turn, capture_memory for facts other agents should know, and search_memory for deeper recall.

All agents must use the same MCP host. Demo and details: Shared agent memory.

Troubleshooting

• Wizard still asks to enable remote agents — tunnel isn’t up or API hasn’t reloaded; tap Enable again, or check ./local/scripts/tvix-local.sh mcp-tunnel-status.
• OAuth consent loops — confirm the tunnel origin matches the URL you entered in ChatGPT and that MCP OAuth is enabled (start-mcp-tunnel / set-mcp-public-url turns it on for HTTPS).
• Tools missing after connect — reconnect the app in ChatGPT and confirm Agents → connections shows a recent heartbeat.

See Tvix MCP for tools.