Plugins

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

O Cursor 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 Cursor 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 Cursor oferece suporte a Agent Plugins e Cursor 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
• Cursor 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 Cursor sem alterações. Os Cursor Plugins continuam evoluindo em paralelo ao padrão, para que os componentes específicos do Cursor e os recursos do marketplace continuem funcionando como hoje.

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

Canvases de Cursor 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 Cursor, 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 Cursor Marketplace, você encontra e instala Cursor Plugins oficiais. Os plugins são distribuídos como repositórios Git e enviados pela equipe do Cursor.

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 Cursor 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 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 Cursor. 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 -> Integrações e MCP.
2. Localize Servidores MCP de equipe.
3. Selecione Adicionar ao marketplace da equipe no prompt de migração.
4. Abra Dashboard -> Plugins para revisar o marketplace padrão, o acesso a ele e os modos de instalação de plugins.

O Cursor 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 Cursor 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 Cursor 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.

Adicionar um marketplace de equipe

Siga este fluxo para importar um repositório do GitHub como marketplace de equipe:

1. Acesse Dashboard -> Plugins.
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" para importar do GitHub.
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

Ao importar do GitHub, os plugins são indexados na primeira vez que você importa o repositório. Você pode atualizar os plugins de duas formas:

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

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.

Instalando plugins

Instale Agent Plugins e Cursor Plugins a partir de um marketplace. O Cursor 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 Cursor 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 carregar qualquer um dos formatos diretamente de ~/.cursor/plugins/local durante o desenvolvimento de um plugin. Consulte Testar plugins localmente.

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 Cursor, 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 Cursor Plugins quando também precisar de componentes específicos do Cursor, 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 Cursor Plugin ou leia o guia de criação de Agent Plugins para criar um Agent Plugin.

Teste plugins localmente

Antes de publicar, carregue 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 Cursor Plugin.
3. Reinicie o Cursor ou execute Developer: Reload Window.
4. Verifique se os componentes do plugin são carregados no Cursor, como regras, skills ou servidores MCP.

Para iterar mais rapidamente, crie um link simbólico para o repositório do plugin:

ln -s /path/to/my-plugin ~/.cursor/plugins/local/my-plugin

Quando seu plugin estiver pronto, envie-o para revisão em cursor.com/marketplace/publish. Cursor 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