Pular para o conteúdo principal

​
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:
CampoPor que é importante
URL públicaEndpoint onde o manifesto MCP está hospedado (ex.: https://acme-internal-tools.com/mcp).
ProtocoloTipo de implementação MCP (HTTP ou SSE).
HospedagemDeve ser um servidor remoto acessível pelo Kodus (sem localhost ou endpoints MCP locais).
AutenticaçãoSe o plugin requer chaves de API, OAuth ou está aberto aos IPs do seu workspace.
Descrição / LogoAjuda outros engenheiros a entenderem o que o plugin faz ao navegar pelo catálogo.
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: 
    Plugin Name: Rótulo descritivo (ex.: "Security Runbooks MCP")
Description: Quais dados/ações ele expõe
Logo URL: Opcional, mas útil para identificação
URL: https://seu-dominio.com/mcp
Protocol: HTTP ou SSE
Authorization / Headers: Adicione se o seu host MCP exigir (ex.: chave de API, OAuth, etc.) (opcional)
  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. 
    @kody você consegue buscar o checklist de implantação do nosso MCP e confirmar se feature flags são necessárias?
  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.