magus v0.4.3 is out. See what's new
¶ View markdown source · ✎ Suggest an edit
1 min read

MGS9016: operator token predates the class prefix

The operator token file ($XDG_STATE_HOME/magus/mcp_token) does not hold a well-formed mgo_ token. An older magus wrote a bare random string there, or the file was edited by hand. The server will not start on it, and every command that reads it stops with this error.

[MGS9016] auth: the operator token at /path/mcp_token is not an mgo_ token (it
predates the class prefix); re-issue it with `magus config token generate --force`
  see: .../MGS9016.md

Why

A token's class is its prefix, and the server routes a presented token to the one store that can hold its class. A file without the prefix could be matched against the wrong store, so it is refused rather than guessed at. There is no migration.

Resolution

Re-issue it, then restart anything that held the old one:

magus config token generate --force

Clients should not hold the operator token at all: give an MCP client a connector token (magus config mcp connector create) and a browser a console token.

See also

MGS9016authoperatortokenupgrademgo_
Last updated (95680f58)
Earlier changes on this page (1)

Full history ↗ · Blame source ↗

Glossary

Op

A single tool-native command a target composes (long form: operation); the middle of the work hierarchy (Spell to Op to Target). See operations.

Server

The background process a person starts with magus server start. It serves MCP, the console, background jobs and the warm knowledge graph, and adopts nested magus calls into one pool. See server.

Conventions

This page uses none of the site's convention markers. The full set is on the conventions page.