Skip to main content

​
Por que plugins personalizados são importantes

Plugins MCP personalizados permitem que seu time fundamente o Kody em sistemas internos — bases de conhecimento, dashboards de incidentes, mecanismos de políticas e muito mais. Uma vez instalados, cada interação com o Kody pode chamar essas ferramentas com dados em tempo real, de modo que os revisores param de copiar capturas de tela ou trechos desatualizados em pull requests. Este guia mostra o fluxo recomendado para qualquer plugin personalizado, seja um endpoint simples somente leitura (como o Kodus Docs MCP) ou um pipeline mais avançado com autenticação.
O Kodus suporta apenas servidores MCP remotos — isso significa que o plugin precisa ser acessível a partir da infraestrutura do Kodus.

​
Prepare as informações do seu plugin

Reúna estes detalhes antes de abrir o catálogo de Plugins: Procurando servidores MCP remotos para experimentar?
  • Smithery.ai seleciona serviços MCP implantáveis além de um launcher fácil que pode ser direcionado à sua própria infraestrutura.
  • Awesome Remote MCP Servers lista endpoints mantidos pela comunidade cobrindo pesquisa em documentação, scanners de segurança e bots de fluxo de trabalho.

​
Instalar o plugin no Kodus

  1. Vá para Configurações de Code Review → Plugins (beta) no seu workspace do Kodus.
  2. Clique em Adicionar Plugin.
  3. Preencha o formulário:
  4. Clique em Criar Plugin. Assim que aparecer na lista, estará disponível instantaneamente para todo o workspace.
Plugins personalizados são executados com as mesmas permissões do workspace. Instale apenas endpoints que sua organização confia e monitora.

​
Verificar a conexão

  1. Abra qualquer pull request onde o Kody está habilitado.
  2. Mencione @kody e inclua uma pergunta que force o plugin a responder.
  3. No painel lateral, verifique a seção Plugins. Você deve ver uma chamada ao seu novo plugin. Se falhar, expanda o erro para inspecionar o código de status ou a mensagem de validação.
O Kodus Docs MCP (https://docs.kodus.io/mcp) é um teste rápido de sanidade — você pode instalá-lo primeiro para garantir que seu workspace consegue alcançar hosts externos.

​
Checklist rápido

  • O manifesto do plugin está hospedado e acessível.
  • O modelo de autenticação (se houver) está documentado e testado.
  • O plugin foi instalado via Adicionar Plugin Personalizado com a URL e headers corretos.
  • Um PR de exemplo comprovou que o Kody consegue chamar o plugin.
  • Os responsáveis sabem como monitorar e atualizar a integração.