用途：把当前 Claude Code 会话接入用户自己的 Cognitum Music 账户（music.cognitum.one），通过 cogmusic MCP 桥完成一次性、按机器/项目的配置，之后才能调用 music-* 技能。
适用时机：用户要求生成或制作音乐，但尚看不到 mcp__cogmusic__* 工具；claude mcp get cogmusic 报告服务器缺失、断开或不健康；用户需要更换或轮换已过期/被吊销的令牌。
使用方式：先运行 claude mcp get cogmusic 检查是否已有可用注册，若显示 ✔ Connected 即已完成，无需继续。若无令牌，需用户自行在浏览器登录 https://music.cognitum.one/mcp，点击 Generate connection token 并复制只显示一次的原始令牌（以 cogmcp_ 开头），此步骤无法由助手代做。拿到令牌后注册：claude mcp add cogmusic --env COGMUSIC_TOKEN=cogmcp_... -- npx -y cogmusic@latest。应固定使用 cogmusic@0.1.1 或更高版本，0.1.0 没有 fetch 超时，超过 Node 约五分钟默认限制的 create_production 会失败。最后用 claude mcp get cogmusic 验证，期望 ✔ Connected。若出现 CONNECTION_CLOSED 或 404，可用 npm view cogmusic version 检查版本并用显式版本重试。若注册存在但不健康，应删除后重新添加：claude mcp remove cogmusic -s local，再执行上述 add 命令，不要手工编辑配置。连接后可用工具包括 list_productions、get_production、create_production、separate_stems、extract_midi、master，随后可进入 music-generate 或 music-list。
限制：令牌是绑定单个 Cognitum 账户的个人访问令牌，只能由用户在 music.cognitum.one/mcp 自行生成和吊销，本插件无法以程序方式生成或吊销，也不应尝试猜测、缓存到别处或传输到本地 claude mcp add 注册以外的任何位置。应把令牌视为机密，尽量避免在聊天中完整回显。新注册的 MCP 服务器工具可能要到下一次 Claude Code 会话才出现；若注册成功但工具仍未列出，需开启全新会话。