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

Add Custom Plugin form

Em Plugins, o botão Add Plugin do card Add Custom Plugin abre este formulário

  1. Na barra lateral, abra Plugins (Beta) no seu workspace do Kodus.
  2. No card Add Custom Plugin, clique em Add 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. Verifique a resposta do Kody: ela deve incluir dados retornados pelo seu novo plugin. Se não incluir, confirme a URL, o protocolo e a autorização do plugin na página Plugins.
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.