# Add Mosyn to Claude Code

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

## Steps

1. Install the Mosyn plugin. It adds Mosyn and a skill that teaches Claude how to build a good study set.
2. Or add only the connector, for every project on this computer.
3. Sign in: run `/mcp` in a Claude Code session, choose mosyn, then Authenticate.

## Commands

Add the Mosyn plugin catalog:

```sh
claude plugin marketplace add ponderingBGI/mosyn-plugin
```

Install the plugin:

```sh
claude plugin install mosyn@mosyn
```

Or add only the connector:

```sh
claude mcp add --transport http --scope user mosyn https://mosyn.lycatra.com/mcp
```

Check it:

```sh
claude mcp list
```

## Config file

`~/.claude.json (user scope), or .mcp.json in a project`:

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

## Sign in

Authenticating opens Mosyn's approval page in your browser; Claude Code waits on a local callback.

## 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

`claude mcp list` shows mosyn as ✔ Connected (before sign-in it shows “Needs authentication”).

## If something goes wrong

| What you see | What to do |
| --- | --- |
| `MCP server mosyn already exists` | Run `claude mcp remove mosyn`, then add it again with the same --scope. |
| The browser doesn't open. | Copy the URL Claude Code prints and open it yourself. |
| After approving, the browser shows a connection error on localhost. | Paste the full URL from the browser's address bar into Claude Code's prompt. |

## Sources

- https://code.claude.com/docs/en/mcp
- https://code.claude.com/docs/en/plugin-marketplaces
- https://github.com/ponderingBGI/mosyn-plugin

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