# Add Mosyn to JetBrains AI Assistant

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

## Who can use it

Needs the AI Assistant plugin with a JetBrains AI plan and Node.js 18 or newer. AI Assistant doesn't sign in to remote servers itself, so Mosyn connects through the mcp-remote bridge. Junie signs in natively.

## Steps

1. Open Settings → Tools → AI Assistant → Model Context Protocol (MCP) → Add, and choose JSON.
2. Paste the entry below. The bridge opens the sign-in the first time it starts.

## Config file

`Settings → Tools → AI Assistant → Model Context Protocol (MCP)`:

```json
{
  "mcpServers": {
    "mosyn": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mosyn.lycatra.com/mcp"
      ]
    }
  }
}
```

## Sign in

mcp-remote opens Mosyn's approval page in the browser on first start.

## 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 Status column shows mosyn connected; click it to list the tools.

## If something goes wrong

| What you see | What to do |
| --- | --- |
| A plain {"url": …} entry connects, then fails with 401. | Use the mcp-remote entry above, or use Junie. |
| The bridge is stuck signing in. | Delete ~/.mcp-auth and restart the server. |

## Sources

- https://www.jetbrains.com/help/ai-assistant/mcp.html
- https://github.com/geelen/mcp-remote

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