# Add Mosyn to Warp

MCP URL: https://mosyn.lycatra.com/mcp

## Steps

1. Open Settings → Agents → MCP servers → + Add, and add a server with the Mosyn MCP URL.
2. Start it; Warp opens the sign-in the first time.

## Config file

`Settings → Agents → MCP servers (or ~/.warp/.mcp.json)`:

```json
{
  "mcpServers": {
    "mosyn": {
      "url": "https://mosyn.lycatra.com/mcp"
    }
  }
}
```

## Sign in

Warp opens Mosyn's approval page in the browser when the server first starts.

## Approve on your phone

A browser page from Mosyn opens with an eight-character code and a QR code. Open the Mosyn app on your phone and approve the request there (scan the QR code, tap the link on the phone, or type the code in Settings → Connect an assistant → Have a code?).

Never paste the code into a chat; it goes into the Mosyn app only.

## Check that it worked

The MCP servers page shows mosyn running with its tools.

## If something goes wrong

| What you see | What to do |
| --- | --- |
| Stuck signing in, or signed in to the wrong account. | Remove ~/.mcp-auth (this clears every local MCP sign-in), then restart the server. |
| A project-level .warp/.mcp.json server doesn't start. | Project servers don't start on their own. Turn mosyn on in the MCP servers page. |

## Sources

- https://docs.warp.dev/knowledge-and-collaboration/mcp

Last checked 2026-09-26. All assistants: https://mosyn.lycatra.com/connect.md
