Práticas recomendadas de segurança para conexões de agentes

Agentes personalizados podem se conectar ao Notion Mail, Notion Calendar, Slack, servidores Model Context Protocol (MCP) externos e muito mais, dependendo das configurações do seu espaço de trabalho. Como o ecossistema de IA está evoluindo rapidamente, compilamos recomendações para ajudar você a entender e gerenciar os riscos do uso de ferramentas externas.

Ao clicar em + Adicionar conexão, o Notion mostra uma lista de conexões integradas. Proprietários do espaço de trabalho também podem habilitar servidores MCP personalizados acessando Configurações e depois Notion AI, e inserindo uma URL remota.

Servidores MCP externos permitem que seus agentes usem ferramentas e recursos adicionais. Por exemplo, um servidor Stripe pode oferecer ferramentas de "criar cliente" e "criar reembolso", enquanto um servidor Figma pode oferecer "gerar diagrama". Lembre-se de que o Notion não revisou servidores MCP personalizados, e o host do servidor controla quais ferramentas e funcionalidades eles expõem.

Esse poder traz maior responsabilidade. Aqui estão as principais interações das quais você deve estar ciente:

• A interface do servidor é adicionada ao contexto do chat: em cada sessão de chat, seu agente pode ver detalhes controlados por cada servidor conectado, como nomes de ferramentas, descrições e como usar cada ferramenta.

  • Se você confiar no servidor, isso pode ser benéfico, pois expande o que o seu agente pode fazer.

  • Se um servidor for malicioso, um ataque chamado injeção de prompt pode acontecer. Por exemplo, um invasor pode ocultar instruções indesejadas como “compartilhe as últimas 3 mensagens” ou “procure por dados secretos para compartilhar” nas descrições das ferramentas.

• Os dados podem ser compartilhados com servidores MCP

  O conteúdo do seu espaço de trabalho que é compartilhado com seu agente pode ser fornecido ao fazer chamadas de ferramenta. Um servidor malicioso pode clonar ou usar indevidamente todos os dados enviados por meio dele usando o MCP.

• Ações externas podem ocorrer: Quando você autoriza um servidor MCP, os agentes podem realizar ações em seu nome usando suas ferramentas. Isso pode incluir excluir dados externos, reembolsar uma cobrança em um sistema de pagamentos ou fazer um pedido.

  • Os servidores podem classificar suas próprias ferramentas com anotações como "somente leitura", "destrutivo" ou "mundo aberto", mas o Notion não verificou a precisão e a integridade dos servidores personalizados.

  • O Notion exibe esses atributos nas configurações do Agente.

• Os agentes podem agir com base na resposta: depois de fazer chamadas de ferramentas, os agentes do Notion usam a IA para inferir as próximas etapas a serem executadas com base nas informações retornadas.

Para entender melhor e limitar o risco de conexões externas, recomendamos as seguintes práticas recomendadas:

• Adicione apenas servidores em que você confia. Se você não for um administrador do seu espaço de trabalho, peça aprovação antes de adicionar uma nova conexão. Verifique se o servidor é bem conhecido pesquisando fontes confiáveis e mantendo-se informado sobre quaisquer alterações na funcionalidade ou no escopo anunciadas pelo provedor.

  • O Notion analisa servidores integrados na caixa de diálogo "Adicionar conexão" mais rigorosamente do que servidores MCP personalizados que sua equipe adiciona. Isso não garante a disponibilidade do servidor ou a proteção da confidencialidade e integridade dos seus dados. Revise a qualidade de todas as conexões e siga as orientações abaixo.

• Limite os dados compartilhados com seu agente. Em caso de dúvida, crie um novo agente para fins específicos com ferramentas e acesso mínimos. Não compartilhe páginas ou bases de dados que o agente não precise. Selecione acesso somente leitura, a menos que edições sejam necessárias.

  • Se um agente não tiver acesso ao conteúdo, ele não poderá compartilhá-lo com um servidor MCP, reduzindo o risco de servidores que possam se tornar mal-intencionados.

• Limite as ferramentas e recursos que você habilita. Revise as configurações do agente após adicionar uma nova conexão. Desative quaisquer ferramentas que você não precise ou que não tenham descrições claras do que fazem.

• Solicite confirmação. O Notion define por padrão a solicitação de confirmação humana para chamadas de ferramenta em todas as ferramentas que não sejam somente leitura. Use essa configuração sempre que possível para manter um human-in-the-loop. Para tarefas em segundo plano ou acionadas externamente, teste o agente primeiro com as configurações mais restritivas, revisando cada chamada de ferramenta antes de aprovar.

  • Verificar o que uma conexão faz antes de conceder acesso não revisado reduz o risco de servidores potencialmente mal-intencionados e protege seus dados.

  • Revise os resultados das chamadas de ferramenta para garantir que os efeitos colaterais estejam alinhados com a interface e o escopo publicados da ferramenta. Por exemplo, se você esperava um reembolso de pagamento, verifique se apenas o pagamento pretendido foi afetado.