Claude

Connect Tvix to Claude Desktop with mcp-remote (stdio bridge) and a Bearer token.

Claude Desktop’s claude_desktop_config.json only accepts stdio MCP servers (command / args). A bare url + headers entry is skipped with: “not valid MCP server configurations”. Use npx mcp-remote to bridge to Tvix’s HTTP MCP endpoint.

Claude Desktop Chat has no lifecycle hooks. Tvix archives completed Desktop conversations via the Desktop transcript watcher (scripts/install-tvix-hooks.sh + LaunchAgent). Prefer capture_memory for titled product-plan handoffs. For Claude Code (official hooks), see Claude Code.

Setup

Open the Agents wizard

In the Tvix dashboard, go to **Agents**, click **+ Add Agent**, and select **Claude**.

Paste the MCP config

Copy the generated JSON into `claude_desktop_config.json`:

- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`

Example shape:

```json
{
  "mcpServers": {
    "tvix": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.tvix.ai/mcp",
        "--header",
        "Authorization: Bearer <your-agent-token>"
      ]
    }
  }
}
```

Locally / Tvix for Mac, replace the URL with `http://127.0.0.1:8000/mcp`.

Restart Claude Desktop

Quit and reopen Claude Desktop. You should see **Tvix** connected with tools such as `search_memory`, `capture_memory`, `query_shared_brain`, and `create_wiki_note`. Approve **Always allow** for capture and search tools.

Paste shared brain instructions

Copy **Shared brain instructions** from the Agents wizard into Claude project or custom instructions so Claude calls `query_shared_brain` and `search_wiki` when recalling context (attribute Cursor vs Claude via `source_client`) and `capture_memory` for durable plans. Same MCP host as Cursor required — see [Shared agent memory](/features/shared-agent-memory).

Enable automatic conversation archive

Run `scripts/install-tvix-hooks.sh`, then load LaunchAgent `ai.tvix.claude-desktop-transcript-watch` (wizard copy). Completed Desktop turns post to `/api/v1/agents/ingest` with Claude Desktop provenance. Logs: `~/Library/Logs/Tvix/desktop-transcript-watch.log`.

Save a plan for Cursor

When a product plan is ready, ask Claude to save it:

`Save the complete product plan to Tvix for my other agents with title "Product plan: <name>" and collaboration_thread=product:<slug>.`

Claude should call `capture_memory` (and may also `create_wiki_note`). In Cursor, ask it to find that plan via Tvix (`query_shared_brain` / `search_wiki`) and implement it.

Tools available

See Tvix MCP for the full tool and resource list.

Troubleshooting

• If Claude says entries were skipped as invalid, you pasted a url / headers block. Replace it with the command / npx mcp-remote config above.
• Use Node.js 20.18.1 or newer. Node 18 + current mcp-remote/undici can crash with ReferenceError: File is not defined and drop the MCP connection.
• Confirm the Bearer token was copied fully and has not been revoked on the Agents page.
• Production MCP is on api.tvix.ai. On Mac, use 127.0.0.1:8000 or memories will not match on-device data.
• Cursor cannot find a Desktop plan — confirm the Desktop transcript watcher is running (or Claude called capture_memory / create_wiki_note), both clients use the same MCP host, and Cursor checked query_shared_brain (wiki + source_client) / search_wiki.
• Claude cannot find a Cursor plan — confirm Cursor hooks are installed; re-paste Shared brain instructions so Claude calls search_wiki / query_shared_brain.
• Agents wizard still “Waiting for connection…” — reload Claude after saving config so MCP initializes; or click I've finished setup.

Next Steps

Shared agent memory

Desktop plan → Cursor execute flow.

Claude Code

Automatic every-turn ingest via hooks.