Dev Log: MCP, Rastreamento de E-mail e Estrutura de Menu

Passei o dia construindo servidores MCP, rastreamento automático de e-mails e menus de administração escaláveis.

Aqui estão as principais lições do trabalho.

Segurança de Servidor MCP

Lancei uma caixa de ferramentas MCP genérica e implantei servidores em vários aplicativos empresariais. Ao construir agentes que podem interagir com seus sistemas, siga estas regras:

  • Forneça ferramentas de leitura livremente aos agentes.
  • Forneça ferramentas de escrita com parcimônia.
  • Force cada ação de escrita através de um runbook com aprovação humana.
  • Faça o hash de senhas em suas ferramentas de criação de usuário. Nunca armazene em texto puro.
  • Use UUIDs públicos para logs de auditoria. Nunca exponha IDs internos do banco de dados.
  • Use um fallback para o contexto do usuário. Um agente pode usar HTTP ou STDIO. Garanta que seu código trate ambos.

Rastreamento de E-mail sem Trabalho Manual

Construí um sistema que rastreia aberturas e cliques de e-mails automaticamente. Não faça os desenvolvedores adicionarem pixels de rastreamento a cada e-mail. Em vez disso, use um listener de envio de e-mail.

  • O listener intercepta a mensagem.
  • Ele injeta o pixel de rastreamento no HTML.
  • Ele envolve todos os links para o rastreamento de cliques.
  • Ele adiciona um hash de metadados para facilitar a correlação.

Duas notas importantes:

  • Evite Mail::raw(). Ele pula o caminho de reescrita de HTML. Use Mailables HTML adequados para garantir que o rastreamento funcione.
  • Defina o rastreamento como "on" por padrão. Se os usuários tiverem que ativá-lo, eles esquecerão.

Menus de Administração Escaláveis

Quando você gerencia menus em vários aplicativos, não use um único arquivo gigante. Use pequenas classes construtoras para cada grupo.

  • C