Servidor MCP do registro

Busque e instale itens pedindo à sua ferramenta de IA, com um plano que você vê antes.

A documentação que vem no Ronne AI Marketplace 0.3.0, traduzida do inglês.

O que ele faz

O servidor MCP do registro, rmk-mcp, permite que a sua ferramenta de IA (Claude Code, Codex, Cursor ou qualquer ferramenta que fale MCP) faça o que o rmk faz, a partir da conversa. Peça a ela para encontrar uma skill para revisar SQL, explicar o que um item mudaria ou atualizar tudo, e o assistente usa as ferramentas do servidor.

Ele roda na sua máquina, iniciado pela ferramenta de IA na pasta do seu projeto, e lê este marketplace como você, com o token do rmk login. Ele usa o próprio código do rmk, então resolve, renderiza e grava exatamente como o rmk, e o rmk.lock e o arquivo de estado ficam iguais, seja qual for o que você usar.

Ele também pode enviar a este marketplace, como rascunho privado, um item que você escreveu na sua ferramenta de IA, como o rmk export faz. A revisão, o envio para revisão e o lançamento continuam neste site.

Como configurar

Instale. npm install --global @ronneai/rmk @ronneai/mcp instala o rmk e o rmk-mcp (Node.js 22.12 ou mais recente). Está rodando uma cópia do repositório? Depois do pnpm build, o servidor é o packages/mcp/dist/bin.js: registre-o pelo caminho com --command, abaixo.
Faça login com rmk login, se ainda não fez: o servidor usa esse token.
Registre-o em cada ferramenta de IA, a partir da pasta do projeto:

rmk mcp-setup                # for the tools this project uses
rmk mcp-setup --target all    # for every tool rmk knows
rmk mcp-setup --scope user    # in your home folder, for every project
rmk mcp-setup --command "node /path/to/packages/mcp/dist/bin.js"
rmk mcp-setup --remove

O rmk mcp-setup adiciona o servidor às configurações MCP de cada ferramenta como ronne-registry (.mcp.json para o Claude Code, .codex/config.toml para o Codex, .cursor/mcp.json para o Cursor), e o acompanha como qualquer configuração que o rmk grava: as instalações não mexem nele, --remove tira exatamente ele, e ele nunca substitui uma entrada que você criou.

Depois, reinicie a ferramenta ou recarregue os servidores MCP dela. O Claude Code pergunta uma vez antes de usar os servidores MCP de um projeto, e o Codex só lê o .codex/config.toml em um projeto em que você confia.

As ferramentas

Ferramenta	O que faz	Grava ou envia
search_items	Encontra itens por nome, descrição ou palavra-chave; também por tipo, escopo ou ferramenta de IA.	Nada
get_item	As tags e versões de um item, e as dependências de uma versão, as sinalizações de risco, as ferramentas em que ela funciona e o README.	Nada
list_installed	O que o lockfile contém, e quais itens você pediu.	Nada
check_outdated	Para cada item que você pediu: a versão fixada no lockfile, a mais nova que a faixa dele permite, a mais nova publicada.	Nada
plan_install	Planeja a instalação de itens, com @tag ou @range se você quiser.	Nada
plan_update	Planeja a atualização de itens, ou de todos, dentro das faixas deles.	Nada
plan_remove	Planeja a remoção de itens, e do que mais nada precisa.	Nada
apply_plan	Grava um plano feito nos últimos 10 minutos, uma vez.	Os arquivos do plano, o lockfile e o estado
list_local_items	As skills, agentes, comandos, regras e servidores MCP nas pastas do Claude Code, do Codex e do Cursor, com a ferramenta de cada um, e de quem cada um é: seu, instalado (editado ou não), uma cópia do registro ou gravado pelo rmk. Aceita type e from.	Nada
plan_export	Planeja enviar itens seus para este marketplace como rascunhos: cada arquivo, e o que fica de fora. Aceita type, from (a ferramenta), a descrição de um servidor MCP e dependencies (include ou omit) para os itens seus que eles usam. Uma instalação editada, ou um item cujo nome já foi publicado, entra no plano como proposta de mudança, a menos que new esteja definido.	Nada
export_items	Envia um plano de exportação feito nos últimos 10 minutos, uma vez, como rascunhos privados.	Envia os arquivos do plano para este marketplace
check_drafts	Diz quais dos seus rascunhos o Submit levaria agora, e o que impede os outros. Aceita items (nomes ou ids) ou all; os seus rascunhos de que eles dependem entram primeiro, a menos que dependencies seja false.	Nada
submit_drafts	Envia para revisão cada um desses rascunhos que estiver pronto, e diz por que os outros não foram.	Envia os rascunhos aos revisores

Três ferramentas agem, e a sua ferramenta de IA pergunta a você antes de usá-las: apply_plan nos seus arquivos, e export_items e submit_drafts neste marketplace. Todas as outras são marcadas como somente leitura. list_installed, check_outdated e as ferramentas de plano aceitam scope: user para a sua pasta pessoal, e as ferramentas de plano aceitam targets, como ["codex"], quando a pasta parece ser de várias ferramentas.

Planos

Planejar. Quando você pede para instalar, atualizar ou remover, o assistente primeiro faz um plano: as versões, cada arquivo e configuração que ele gravaria ou removeria, avisos sobre o que uma ferramenta não aceita, o que cada item novo pode fazer (as sinalizações de risco dele) e as variáveis de ambiente de que os servidores MCP dele precisam. Planejar não grava nada no seu projeto.
Aplicar. Depois que você tiver visto o plano, o assistente o aplica com apply_plan; a sua ferramenta pergunta a você antes de rodá-lo, a menos que você tenha permitido. Ele grava exatamente esse plano, depois o lockfile e o arquivo de estado, e diz o que gravou.

Um plano dura 10 minutos e é aplicado uma vez.
Se algo que o plano afeta mudar nesse meio-tempo, como uma instalação pelo terminal ou por outra ferramenta de IA, ele é recusado como desatualizado, e o assistente planeja de novo.
Um plano com conflitos (um arquivo ou configuração que o rmk não gravou, ou que mudou desde que ele gravou) não pode ser aplicado pela ferramenta de IA: tire-os do caminho, ou use rmk install --force no terminal, de propósito.

Os planos de exportação funcionam do mesmo jeito: plan_export mostra cada arquivo que seria enviado e não envia nada, e export_items envia exatamente esse plano, uma vez, em até 10 minutos. Se você editar a skill nesse meio-tempo, o plano é recusado como desatualizado. Planos de instalação e de exportação ficam separados: nenhuma das duas ferramentas aceita o plano da outra.

O que ele pode alcançar

Ele pode fazer o que o seu token pode: ler o que está publicado e baixá-lo, criar rascunhos em seu nome e enviá-los para revisão quando você pedir. Ele nunca mostra o token e não consegue entrar neste site.
Ele só envia itens que encontrou nas pastas das suas ferramentas de IA e que são seus, nunca uma pasta que você indicar, nunca os arquivos que a exportação deixa de fora nem as credenciais de um servidor MCP, e só quando você aprova export_items. O que chega é um rascunho que só você vê.
Ele só grava na pasta do projeto (ou na sua pasta pessoal, com scope: user), passando pelas mesmas verificações do rmk, e nunca roda o código de um item: hooks e scripts são gravados, não executados.
Sem um token, toda ferramenta que acessa o marketplace diz para rodar rmk login. Se o marketplace estiver inacessível, list_installed e list_local_items continuam funcionando: elas só leem os seus arquivos.