Behavry Integration — Claude Desktop App

Claude Desktop supports MCP servers natively via a JSON configuration file. The setup is nearly identical to Claude Code but targets the Desktop app's config path instead.

After any config change, you must restart Claude Desktop for it to take effect.

---

Prerequisites

• Behavry stack running (make dev or docker compose up)
• Claude Desktop installed
• Python 3.11+ with uv available

---

Config File Locations

OS	Path
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

---

Quick Setup

make setup

This detects Claude Desktop, provisions a claude-desktop-local agent, and merges the MCP server config into the Claude Desktop config file — all in one step.

Then restart Claude Desktop (quit and reopen the app).

To connect only Claude Desktop:

cd backend && poetry run python ../demos/setup/create_dev_agent.py --client claude-desktop

---

Verify

1. In Claude Desktop, open a new conversation
2. Click the plug icon (MCP) — the Behavry servers should be listed
3. Ask Claude to read a file or list a directory
4. Check http://localhost:5173 → Live Activity for the event

---

Token Refresh

Tokens expire in ~8 hours. Refresh all enrolled editors at once:

make tokens

Then restart Claude Desktop.

---

Troubleshooting

MCP servers not appearing in Claude Desktop

• Make sure you restarted Claude Desktop after applying the config
• Check the config file was written: open claude_desktop_config.json and verify it contains the mcpServers key

"Connection refused" errors

The Behavry backend isn't running. Start it: make dev

Token expired

Re-run mcp_config.py --apply-claude-desktop and restart Claude Desktop.