Plugins

Os plugins agrupam regras, skills, agentes, comandos, servidores MCP e hooks em pacotes distribuíveis.

O Cherri Code oferece suporte ao padrão aberto Agent Plugins, além de seu próprio formato de plugin. Instale e gerencie-os na página Personalizar ou explore os plugins oficiais no Cherri Code Marketplace. Para plugins da comunidade e servidores MCP, navegue pelo cursor.directory. Você também pode criar seu próprio plugin para compartilhar com outros desenvolvedores.

O que os plugins incluem

Um plugin pode reunir qualquer combinação destes componentes:

O padrão Agent Plugins

Plugins reúnem componentes reutilizáveis que um agente pode usar. Agent Plugins é o padrão aberto para empacotar skills portáteis e servidores MCP, assim como Agent Skills define um padrão para skills individuais. O Cherri Code oferece suporte a Agent Plugins e Cherri Code Plugins.

• Agent Plugins: plugins em conformidade com a especificação, com um manifesto plugin.json na raiz do plugin, que empacotam skills e servidores MCP
• Cherri Code Plugins: plugins com um manifesto .cursor-plugin/plugin.json, que adicionam regras, agentes, comandos, hooks e variáveis

Um plugin que segue a especificação Agent Plugins é carregado no Cherri Code. O Cherri Code não expande as variáveis ${PLUGIN_ROOT} e ${PLUGIN_DATA} do padrão em mcp.json; use ${CURSOR_PLUGIN_ROOT} para a raiz do plugin. Consulte servidores MCP na referência. Os Cherri Code Plugins continuam evoluindo em paralelo ao padrão, para que os componentes específicos do Cherri Code e os recursos do marketplace continuem funcionando como hoje.

Saiba mais em agent-plugins.org ou leia a especificação no GitHub.

Canvases de Cherri Code Plugin

Agora, os plugins vêm com canvases prontos: templates de configuração compartilhados que sua equipe pode abrir e reutilizar.

• Hex Canvas — Crie visualizações de dados. No Cherri Code, usamos o Hex Canvas para explorar e compartilhar analytics.
• Atlassian Canvas — Veja em tempo real seus issues, projetos e documentos do Jira e do Confluence.

Abra um canvas de um plugin instalado em Personalizar para ter um ponto de partida guiado, em vez de configurar tudo do zero.

O marketplace

No Cherri Code Marketplace, você encontra e instala Cherri Code Plugins oficiais. Os plugins são distribuídos como repositórios Git e enviados pela equipe do Cherri Code.

Todos os plugins são revisados manualmente antes de serem listados. Navegue pelos plugins oficiais em cursor.com/marketplace ou pesquise por palavra-chave em Personalizar. Para plugins da comunidade e servidores MCP, navegar pelo cursor.directory.

Marketplaces de equipe

Os marketplaces de equipe estão disponíveis nos planos Teams e Enterprise. Eles podem distribuir Agent Plugins e Cherri Code Plugins pelo mesmo marketplace.

• Plano Teams: até 1 marketplace de equipe
• Plano Enterprise: marketplaces de equipe ilimitados

Entre em contato com vendas para obter marketplaces de equipe ilimitados e controles administrativos do Enterprise.

Abra Dashboard -> Plugins & MCPs para gerenciar os marketplaces de equipe.

Marketplace padrão da equipe

O marketplace padrão da equipe conecta plugins compartilhados e servidores MCP em todo o Cherri Code. Admins podem adicionar servidores MCP da equipe já disponíveis para agentes em nuvem e disponibilizar esses mesmos servidores para que membros da equipe os instalem e configurem na Janela de Agentes, na IDE e na CLI.

Adicionar um servidor MCP da equipe ao marketplace padrão não o instala nem o ativa para todos os desenvolvedores. Admins continuam controlando o acesso ao marketplace e os modos de instalação de plugins. Cada desenvolvedor também pode precisar se autenticar com o provedor MCP.

Migrar MCPs de equipe existentes

Admins podem vincular servidores MCP de equipe independentes ao marketplace padrão:

1. Abra Dashboard -> Plugins & MCPs.
2. Localize Servidores MCP de equipe.
3. Selecione Adicionar ao marketplace da equipe no prompt de migração.
4. Revise o marketplace padrão, o acesso a ele e os modos de instalação de plugins na mesma página.

O Cherri Code cria o marketplace padrão, se necessário, e vincula os servidores MCP existentes a ele. Os servidores permanecem disponíveis para agentes em nuvem, enquanto os membros da equipe podem instalá-los e configurá-los localmente.

Acesso ao marketplace

Por padrão, os marketplaces de equipe estão disponíveis para todos os membros da equipe. Em Configurações do marketplace -> Acesso ao marketplace, os admins podem restringir um marketplace a Grupos da organização específicos. Apenas os membros da equipe do marketplace que pertencem a um grupo selecionado recebem acesso. Os admins da equipe mantêm o acesso.

Como o SCIM funciona?

Os Grupos da organização podem sincronizar associações do seu provedor de identidade por meio do SCIM. Gerencie as associações no provedor de identidade, e o Cherri Code sincronizará essas atualizações com o Grupo da organização.

Os marketplaces existentes que usam grupos de diretório SCIM em nível de equipe mantêm essa configuração. O Cherri Code não migra essas atribuições automaticamente. Organizações sem Grupos da organização continuam usando grupos de diretório SCIM.

Modos de instalação de plugins

Depois de configurar o acesso ao marketplace, escolha como cada plugin será disponibilizado para esse público:

• Desativado por padrão: Os desenvolvedores podem encontrar o plugin e escolher se desejam instalá-lo.
• Ativado por padrão: O plugin é instalado por padrão, mas os desenvolvedores podem optar por não usá-lo.
• Obrigatório: O plugin é sempre instalado e não pode ser desinstalado.

Permitir que membros publiquem

No marketplace padrão, os admins controlam se os membros podem publicar skills pessoais:

1. Abra Dashboard → Plugins & MCPs.
2. Abra o marketplace padrão da equipe e, em seguida, configuração do marketplace.
3. Ative ou desative Allow Members to Publish.

A configuração vem ativada por padrão. Quando está desativada, apenas os admins da equipe podem publicar novas skills. As skills já publicadas pelos membros continuam disponíveis, e seus autores ainda podem atualizá-las ou despublicá-las.

Veja Publicar uma skill para sua equipe.

Disponibilizar marketplace pelo Cherri Code

Em um marketplace de equipe importado do GitHub, admins podem ativar a opção Disponibilizar marketplace pelo Cherri Code em configuração do marketplace. O Cherri Code mantém uma cópia sincronizada desse repositório e disponibiliza os plugins a partir dela, para que os membros da equipe possam usar o marketplace sem ter acesso ao repositório de origem no GitHub. O acesso é controlado pelo Acesso ao marketplace.

Enquanto a primeira sincronização estiver em andamento, a configuração exibe Sincronizando e permanece bloqueada. Se a sincronização do repositório não for concluída, o acesso continua sendo disponibilizado pelo GitHub.

Essa configuração se aplica a marketplaces importados do GitHub. Importações do GitLab, Bitbucket ou Azure DevOps continuam sendo disponibilizadas pelo repositório de origem.

Adicionar um marketplace de equipe

Siga este fluxo para importar um repositório como marketplace de equipe. O Import from Repo aceita URLs do GitHub, GitLab, Bitbucket e Azure DevOps. Conecte esse provedor se o Cherri Code solicitar.

1. Acesse Dashboard -> Plugins & MCPs.
2. Em marketplaces de equipe, clique em Add Marketplace.
3. Siga as instruções para criar um marketplace do zero ou use Import from Repo e cole a URL do repositório.
4. Adicione e revise plugins usando "Add to Marketplace".
5. Em configuração do marketplace, defina acesso ao marketplace, ative opcionalmente o Auto Refresh e salve.

Exemplo de repositório para testar:

• fieldsphere/cursor-team-marketplace-template

Mantenha os plugins atualizados

Os plugins são indexados na primeira vez que você importa o repositório. Você pode atualizá-los de duas formas:

• Automaticamente: Em importações do GitHub, ative Habilitar Auto Refresh para atualizar os plugins sempre que alterações receberem push para a branch rastreada pelo marketplace. Para isso, é necessário ter o Cherri Code GitHub App instalado no repositório. O Cherri Code reindexa um marketplace no máximo uma vez a cada 10 minutos, agrupando pushes rápidos no commit mais recente.
• Manualmente: Clique em Refresh para atualizar a partir do repositório.

Onde os desenvolvedores encontram marketplaces de equipe

Os desenvolvedores podem encontrar marketplaces de equipe em Personalizar.

• Abra Personalizar na barra lateral.
• Procure plugins do marketplace da sua equipe.
• Instale plugins desativados por padrão diretamente nesse painel.
• Plugins ativados por padrão são instalados automaticamente, mas os desenvolvedores podem optar por não instalá-los.
• Plugins obrigatórios são instalados automaticamente e não podem ser desinstalados.
• Instale e configure servidores MCP do marketplace para uso na Janela de Agentes, na IDE e na CLI.

Publique uma skill para sua equipe

Nos planos Teams e Enterprise, os membros podem publicar uma skill pessoal de ~/.cursor/skills/ no marketplace padrão da equipe.

1. Abra personalizar e vá para Skills.
2. Abra a skill pessoal que você quer compartilhar.
3. Escolha Publish e confirme.

O Cherri Code empacota a skill em um plugin, armazena uma cópia em um repositório hospedado para sua equipe e a adiciona ao marketplace padrão. A partir daí, a skill é carregada desse plugin, e não da sua pasta local.

Depois de publicar:

• A instalação depende de adesão. Os membros da equipe encontram a skill no team marketplace e a instalam por conta própria. Publicar não instala a skill para mais ninguém. O autor a recebe automaticamente.
• Os autores mantêm o controle. Use Sync changes para enviar atualizações ou Unpublish para devolver a skill à sua máquina.
• Uma skill, um plugin. O plugin recebe o nome da skill. A publicação não inclui outras skills referenciadas pela skill publicada.

O acesso segue suas configurações atuais de acesso ao marketplace. Os admins podem desativar a publicação por membros em Allow Members to Publish.

Para usar skills pessoais com seus próprios Cloud Agents sem compartilhá-las, sincronize-as.

Instalando plugins

Instale Agent Plugins e Cherri Code Plugins a partir de um marketplace. O Cherri Code detecta o formato pelo manifesto do plugin, portanto o fluxo de instalação é o mesmo para ambos:

1. Abra Personalizar na barra lateral.
2. Encontre o plugin que deseja usar.
3. Selecione Instalar e escolha o escopo de projeto ou de usuário.

Um Agent Plugin tem um manifesto plugin.json na raiz. Um Cherri Code Plugin tem um manifesto .cursor-plugin/plugin.json. Marketplaces de equipe podem distribuir ambos os formatos usando os mesmos modos de acesso e instalação descritos acima.

Você também pode desenvolver qualquer um dos formatos em ~/.cursor/plugins/local. Consulte Testar plugins localmente para ver o layout de pastas e quando o Cherri Code o carrega.

Deep links de Apps do MCP

Compartilhe configurações de servidores MCP usando links de instalação:

cursor://anysphere.cursor-deeplink/mcp/install?name=$NAME&config=$BASE64_ENCODED_CONFIG

Consulte os links de instalação do MCP para saber como gerar esses links.

Gerenciar plugins instalados

Abra Personalizar na barra lateral para gerenciar Agent Plugins, plugins do Cherri Code, servidores MCP, regras e skills em uma única página. Filtre por escopo de usuário, espaço de trabalho ou equipe para ver o que está instalado.

Servidores MCP

Ative ou desative servidores MCP pessoais e distribuídos pela equipe em Personalizar:

1. Abra Personalizar na barra lateral
2. Encontre o servidor MCP que deseja alterar
3. Use o seletor para ativá-lo ou desativá-lo

Servidores desativados não serão carregados nem aparecerão no chat.

Regras e skills

Gerencie regras e skills em Personalizar. Alterne regras individuais entre os modos Sempre, O agente decide e Manual. As skills aparecem na seção O agente decide e podem ser acionadas manualmente com /skill-name no chat.

Usando o hook workspaceOpen

Um hook workspaceOpen pode retornar caminhos de plugins a serem carregados quando o espaço de trabalho for aberto, o que é útil quando o conjunto de plugins depende do próprio espaço de trabalho.

Criar plugins

Um plugin é um diretório com um manifesto e seus componentes. Escolha Agent Plugins quando quiser empacotar skills portáteis e servidores MCP. Escolha Cherri Code Plugins quando também precisar de componentes específicos do Cherri Code, como regras, agentes, comandos, hooks ou variáveis.

my-plugin/├── plugin.json├── skills/│   └── code-reviewer/│       └── SKILL.md└── mcp.json

{  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",  "name": "my-plugin",  "description": "Portable code review tools",  "version": "1.0.0",  "author": { "name": "Your Name" }}

Comece pelo repositório de modelo de Cherri Code Plugin ou leia o guia de criação de Agent Plugins para criar um Agent Plugin.

Teste plugins localmente

Antes de publicar, coloque qualquer um dos formatos de plugin em ~/.cursor/plugins/local:

1. Crie uma pasta para seu plugin: ~/.cursor/plugins/local/my-plugin
2. Copie os arquivos do plugin para essa pasta. Inclua um plugin.json na raiz para um Agent Plugin ou .cursor-plugin/plugin.json para um Cherri Code Plugin.
3. Reinicie o Cherri Code ou execute Developer: Reload Window.
4. Abra Personalizar e confirme os componentes esperados do plugin, como regras, skills ou servidores MCP.

Após recarregar, o Cherri Code detecta plugins nessa pasta se as importações de plugins locais forem permitidas.

Links simbólicos em ~/.cursor/plugins/local só são carregados quando o destino aponta para um diretório dentro dessa pasta. O Cherri Code ignora links simbólicos que apontam para um repositório de plugin em outro lugar do disco.

Quando seu plugin estiver pronto, envie-o para revisão em cursor.com/marketplace/publish. Cherri Code Plugins podem usar .cursor-plugin/marketplace.json em repositórios com vários plugins.

Consulte a Referência de plugins para conferir o schema completo do manifesto, os formatos dos componentes e a lista de verificação para envio.

Perguntas frequentes

Relacionados

• Ajuda sobre plugins
• Skills