Skip to content
Mosyn

Add Mosyn to Claude Code

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
claude plugin marketplace add ponderingBGI/mosyn-plugin
Install the plugin
claude plugin install mosyn@mosyn
Or add only the connector
claude mcp add --transport http --scope user mosyn https://mosyn.lycatra.com/mcp
Check it
claude mcp list
Or add it to the config file
~/.claude.json (user scope), or .mcp.json in a project
{
  "mcpServers": {
    "mosyn": {
      "type": "http",
      "url": "https://mosyn.lycatra.com/mcp"
    }
  }
}

Sign in and approve

  1. On your computerSign inAuthenticating opens Mosyn's approval page in your browser; Claude Code waits on a local callback.
  2. On your phoneApprove on your phoneMosyn's approval page shows a QR code. Scan it with your phone, or in Mosyn open Settings → Connect an assistant → Have a code? and type the code shown.

Check that it worked

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

If something goes wrong

What you seeWhat 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.

[email protected]

Add Mosyn to Claude Code | Mosyn