Skip to main content

Behavry Integration — Warp Terminal

Warp supports MCP servers via a YAML configuration file at ~/.warp/mcp_servers.yaml.

macOS only. Warp is not available on Windows or Linux.

Unlike other clients, Behavry cannot auto-apply the Warp config — you must paste the YAML snippet manually.

Prerequisites​

  • Behavry stack running (make dev or docker compose up)
  • Warp installed (macOS only)
  • uv installed: pip install uv
  • Python 3.11+

Quick Setup​

make setup provisions a warp-local agent automatically when Warp is detected (checks ~/.warp/).

Unlike other editors, Behavry cannot auto-write the Warp YAML config. After provisioning, generate the snippet manually:

cd backend && poetry run python ../demos/setup/mcp_config.py --apply-warp

Copy the printed YAML and paste it into ~/.warp/mcp_servers.yaml. If the file doesn't exist, create it.

The final file should look like:

behavry-filesystem:
  command: uvx
  args:
    - mcp-proxy
    - http://localhost:8000/mcp/v1/servers/demo-filesystem/mcp
    - --header
    - "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9..."

behavry-database:
  command: uvx
  args:
    - mcp-proxy
    - http://localhost:8000/mcp/v1/servers/demo-database/mcp
    - --header
    - "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9..."

Step 3 — Activate in Warp​

  1. Restart Warp (quit and reopen)
  2. Open the AI panel (Cmd+I)
  3. The Behavry servers should appear in the tool list

Step 4 — Verify​

  1. In Warp AI, ask: "List the files in /workspace using the filesystem tool"
  2. Check http://localhost:5173 → Live Activity

Token Refresh​

Tokens expire in ~8 hours. Run make tokens to refresh all editors, then re-generate the Warp snippet:

make tokens
cd backend && poetry run python ../demos/setup/mcp_config.py --apply-warp

Copy the new YAML, replace the old entries in ~/.warp/mcp_servers.yaml, and restart Warp.

How uvx mcp-proxy Works​

Warp uses stdio-based MCP, so the same mcp-proxy bridge used for Zed is needed here. uvx mcp-proxy is spawned as a subprocess by Warp and bridges the stdio ↔ HTTP transport.

Troubleshooting​

"uvx: command not found"

Install uv: brew install uv or pip install uv. Ensure ~/.local/bin is in PATH.

Servers not appearing after restart

Check the YAML syntax — indentation matters. Verify the file is at ~/.warp/mcp_servers.yaml.

"Connection refused"

The Behavry backend isn't running. Run make dev.