FeynmanLM Docs

Appearance

Setup MCP Server (Optional) ​

Most people don't need this

The easiest way to use your sources with AI is to drag & drop them directly from Studio into Claude, ChatGPT, Gemini, or Grok. The MCP server is an optional upgrade for power users who want a persistent connection — so your AI can search your full library and run Feynman sessions without dragging files each time.

FeynmanLM runs an MCP server locally on your Mac at http://127.0.0.1:8522. To connect Claude, ChatGPT, Gemini, or Grok you need a public HTTPS URL that forwards to that local server. We use Tailscale Funnel for this — it gives you a stable *.ts.net URL with zero configuration.

1. Install Tailscale ​

Download and install from tailscale.com/download, then sign in.

2. Start a Funnel ​

Open Terminal and run:

bash
tailscale funnel --bg 8522

Tailscale prints your public URL:

https://your-mac.your-tailnet.ts.net

This URL is stable — it stays the same across app restarts and reboots. You only need to run this command once.

3. Get Your Credentials ​

Open FeynmanLM → Studio → Connect MCP. If the Funnel is running, you'll see:

  • URL — your Tailscale URL with /mcp appended
  • OAuth Client ID
  • OAuth Secret

Copy these values — you'll need them in the next step.

4. Connect Your AI Assistant ​

Managing the Funnel ​

bash
# Check status
tailscale funnel status

# Stop the Funnel
tailscale funnel --https=443 off

Troubleshooting ​

Funnel command fails: Make sure Tailscale is installed, running, and you're signed in. Funnel also needs to be enabled in your Tailscale admin console — the command will show a link to enable it if needed.

Your AI says the server is offline: Make sure FeynmanLM is running and your Mac is awake. Open Studio → Connect MCP to verify the server status.

OAuth fails: Double-check that you copied the current OAuth Client ID and OAuth Secret from Connect MCP, and that the OAuth endpoint URLs point at your *.ts.net domain (not feynmanlm.com).

Gemini OAuth never finishes: Gemini CLI needs to open your local browser and receive the OAuth callback on http://localhost:7777/oauth/callback. This won't work in a headless terminal.