Roamer MCP

roamer-mcp-plugin

Plugin distribuível do Claude Code para o RoamerMcp — o servidor MCP de registro de projetos, banco de dados de especificações comportamentais e threads de engenharia do Roamer. Saiba mais em roamermcp.mathismeadows.com.

O plugin é um extra opcional sobre o servidor Roamer MCP hospedado (https://roamer-mcp.mathismeadows.com/mcp). Conectar-se a esse servidor por conta própria já fornece todas as ferramentas e fluxos de trabalho; instalar este plugin adiciona onze fluxos de trabalho como comandos de barra. Cada um é um comando de barra, mas o Claude também pode invocá-lo por conta própria quando a conversa pedir — você não precisa digitar o comando:

• /roamer:orient — briefing de início de sessão (registro de projetos + threads abertas)
• /roamer:breadcrumb — checkpoint de fim de sessão (atualizações de registro + threads)
• /roamer:feature — fluxo de trabalho de funcionalidade com sete etapas
• /roamer:bug — fluxo de trabalho de correção de bug com oito etapas
• /roamer:spec-audit — auditoria de cobertura de especificações
• /roamer:spec-check — checklist de higiene
• /roamer:thread-scrub — revisão guiada e disposição do backlog de threads abertas, sob demanda
• /roamer:release-notes — rascunho de notas de versão Internas/Externas para um intervalo de datas, somente revisão
• /roamer:login — entrar, ou alternar qual identidade esta sessão usa
• /roamer:logout — encerrar a conexão Roamer desta sessão
• /roamer:status — ver qual identidade esta conexão está usando

Instalação

/plugin marketplace add mathismeadows/roamer-mcp-plugin
/plugin install roamer@roamer

O plugin se conecta ao servidor hospedado via HTTP — sem Node.js ou instalação local. No primeiro uso, entre com /mcp: selecione o servidor Roamer do plugin e siga o login no navegador. Para trocar de conta depois, use /mcp → Reautenticar, ou Limpar autenticação para sair.

Mantenha uma conexão Roamer por cliente. Se você também adicionou o Roamer como conector do claude.ai ou com claude mcp add, o Claude Code trata um servidor de plugin e um conector na mesma URL como duplicados e classifica o do plugin primeiro. Desative qualquer outro servidor Roamer em /mcp para que fique claro qual está sendo usado em uma sessão.

Atualizando da versão 1.x

A versão 2.0 muda a forma como o plugin se conecta. A 1.x iniciava uma ponte local (npx @mathismeadows/roamer-device-auth) sob o nome de servidor roamer; a 2.0 conecta-se diretamente ao servidor hospedado sob o nome de servidor mcp, então suas ferramentas são nomeadas mcp__plugin_roamer_mcp__<tool>. Após atualizar:

• Entre novamente com /mcp (o login em cache da ponte não é usado pela 2.0).
• Se um servidor chamado roamer ainda estiver listado — em /mcp, ou na visualização de Servidores MCP do VS Code — remova-o e recarregue. Um servidor roamer remanescente pode mostrar um erro sem saída.
• As aprovações de ferramentas que você deu ao servidor roamer antigo não são transferidas para o novo nome.

Status

Este repositório é público — instale diretamente com os comandos acima. Novas contas são provisionadas automaticamente no primeiro login, mas atualmente precisam de aprovação manual antes de poderem usar as ferramentas do RoamerMcp (um portão de acesso beta); você será notificado quando a sua for ativada.

Estrutura

• .claude-plugin/plugin.json — manifesto do plugin
• .claude-plugin/marketplace.json — entrada de marketplace autorreferente
• .mcp.json — o servidor Roamer MCP hospedado via HTTP, sob o nome de servidor mcp
• skills/ — os comandos de fluxo de trabalho acima; cada um lê suas instruções atuais do servidor

Este repositório é apenas para distribuição — não tem código de servidor, testes, nem relação com a arquitetura interna do RoamerMcp além de consumir seu endpoint MCP público.