Segurança e privacidade

Princípios

As ferramentas dos plugins podem acessar dados de usuários, chamar APIs de terceiros e executar operações de escrita. Trate cada servidor MCP e cada componente de interface como software de produção.

• Privilégio mínimo: Solicite apenas os escopos, o acesso ao armazenamento e as permissões de rede de que você precisa.
• Consentimento explícito do usuário: Garanta que os usuários entendam quando estão vinculando contas ou concedendo acesso de escrita. Use os pedidos de confirmação do host para ações destrutivas.
• Defesa em profundidade: Parta do princípio de que tentativas de injeção de prompt e entradas maliciosas chegarão ao servidor. Verifique cada entrada e mantenha logs de auditoria.

Tratamento de dados

• Conteúdo estruturado: Inclua apenas os dados necessários para o prompt atual. Evite incluir segredos ou tokens nas propriedades dos componentes.
• Armazenamento: Defina por quanto tempo você manterá os dados dos usuários e publique uma política de retenção. Atenda às solicitações de exclusão.
• Logs: Oculte informações de identificação pessoal (PII) antes de gravar os dados nos logs. Guarde os IDs de correlação para depuração, mas evite armazenar o texto original dos prompts, salvo quando necessário.

Injeção de prompt e operações de escrita

Servidores MCP personalizados oferecem acesso completo ao MCP, inclusive às ferramentas de escrita. Para reduzir os riscos, adote as seguintes medidas.

• Revise regularmente as descrições das ferramentas para desestimular o uso indevido (“Não use esta ferramenta para excluir registros”).
• Valide todas as entradas no servidor, mesmo quando fornecidas pelo modelo.
• Exija confirmação humana para operações irreversíveis.

Compartilhe com a equipe de QA seus melhores prompts para testar ataques de injeção de prompt. Assim, a equipe poderá investigar possíveis vulnerabilidades desde cedo.

Acesso à rede

Os widgets são executados em um iframe isolado com uma política de segurança de conteúdo (CSP) rigorosa. Eles não podem acessar APIs privilegiadas do navegador, como window.alert, window.prompt, window.confirm ou navigator.clipboard. A CSP controla as requisições padrão feitas com fetch. Frames aninhados ficam indisponíveis por padrão. Para habilitá-los, especifique as origens permitidas nos metadados de CSP do recurso, como _meta.ui.csp.frameDomains. Os plugins podem incorporar páginas do próprio domínio registrável do servidor MCP, incluindo editores e interfaces de administração existentes. Consulte a política de iframes para saber mais sobre a titularidade do domínio, as justificativas necessárias e os requisitos de revisão.

A CSP do widget restringe os destinos que podem ser carregados em iframes. Cada página incorporada usa sua própria CSP. As listas de permissões connectDomains e resourceDomains do widget não restringem as requisições de rede feitas dentro dessa página. Permita apenas origens específicas para os iframes e inclua a experiência incorporada na revisão de segurança.

O código executado no servidor está sujeito apenas às restrições de rede impostas pelo ambiente de hospedagem. Siga as práticas recomendadas para chamadas de saída, como verificação de TLS, novas tentativas e limites de tempo.

Autenticação e autorização

• Ao integrar contas externas, use fluxos OAuth 2.1 com código de autorização. Dê preferência aos documentos de metadados de ID do cliente (CIMD) quando o servidor de autorização oferecer suporte a CIMD e o desenvolvedor do plugin escolher essa opção. Use none para a troca de tokens por clientes públicos ou private_key_jwt quando o servidor de autorização exigir a autenticação do cliente. Ofereça suporte a DCR quando o desenvolvedor do plugin escolher essa opção ou quando CIMD estiver indisponível.
• Verifique os escopos e aplique as restrições correspondentes em cada chamada de ferramenta. Retorne uma resposta 401 para tokens expirados ou malformados.
• Ao usar a identidade integrada, evite armazenar segredos de longa duração. Use o contexto de autenticação fornecido.

Preparação para operação

• Faça revisões de segurança antes do lançamento, especialmente se você lida com dados sujeitos a regulamentação.
• Monitore o tráfego em busca de padrões anômalos e configure alertas para erros recorrentes ou tentativas de autenticação malsucedidas.
• Mantenha as dependências de terceiros, as bibliotecas e as ferramentas de build em dia com as correções de segurança para reduzir os riscos na cadeia de suprimentos de software.

A segurança e a privacidade são fundamentais para a confiança dos usuários. Incorpore ambas desde o início aos fluxos de planejamento, implementação e implantação.