Conexões MCP para agentes personalizados

As conexões MCP (Model Context Protocol) permitem que seus agentes personalizados se conectem com segurança a aplicativos externos. Com as conexões de MCP, seus agentes podem ler informações e executar ações usando conexões pré-configuradas com aplicativos como Linear, Ramp, Canva e outros, ou conectar-se a qualquer aplicativo configurando conexões de MCP personalizadas.

Observação: as conexões MCP estão disponíveis apenas nos Planos Business e Enterprise.

As conexões MCP permitem que os agentes personalizados interajam com ferramentas e serviços externos por meio do Model Context Protocol. As ferramentas de MCP funcionam com todos os tipos de acionadores, incluindo execuções agendadas, execuções acionadas com base em eventos do Notion ou do Slack e execuções manuais a partir de conversas ou @menções.

Principais recursos:

• Servidores pré-configurados: conecte-se rapidamente a aplicativos populares sem qualquer configuração adicional.

• Servidores personalizados: conecte-se a qualquer ferramenta que ofereça suporte a um servidor MCP hospedado usando URLs disponíveis publicamente.

• Personalização: as ferramentas para cada conexão podem ser ativadas ou desativadas, e você pode escolher se deseja exigir confirmação antes de executar ou executar automaticamente.

Cada conexão MCP é exclusiva de um único agente personalizado e usa as credenciais da pessoa que a autenticou. As conexões não são compartilhadas entre os agentes, mesmo que eles se conectem ao mesmo serviço.

Isso significa:

• Se você configurar uma conexão do Figma para o Agente A, o Agente B precisará da sua própria conexão do Figma separada.

• Você deve fazer login em cada servidor MCP para cada agente que configurar.

• A revogação de uma conexão em um agente não afeta outros agentes.

Você pode se conectar aos seguintes aplicativos sem nenhuma configuração adicional:

• Linear

• Ramp

• Figma

• GitHub

• Stripe

• Sentry

• Attio

• HubSpot

• Amplitude

• Intercom

• Wiz

1. Abra as Configurações do seu Agente personalizado.

2. Vá para Ferramentas e acesso.

3. Clique em Adicionar conexão → Adicionar.

4. Escolha um servidor pré-configurado.

5. Siga as instruções de autenticação para conectar sua conta.

6. Selecione quais ferramentas do servidor você deseja que seu agente use. Isso varia de acordo com o servidor que você escolher.

7. Clique em Salvar.

Se você quiser se conectar a um servidor MCP que não está na lista pré-configurada:

1. Para usar conexões personalizadas do agente MCP, um administrador do espaço de trabalho precisa habilitar isso em Configurações → IA do Notion → Conectores IA → Habilitar servidores MCP personalizados.

2. Depois que o administrador do espaço de trabalho permitir conexões personalizadas de MCP, abra as Configurações do seu Agente personalizado.

3. Vá para Ferramentas e acesso.

4. Clique em Adicionar conexão → Servidor MCP personalizado.

5. Insira o URL do servidor MCP.

6. Forneça um nome de exibição para a conexão.

7. Adicione os detalhes de autenticação necessários.

8. Clique em Salvar.

Os servidores MCP personalizados podem suportar um ou ambos os métodos de login a seguir:

• OAuth

• Autenticação baseada em cabeçalho

  (por exemplo, chaves de API ou tokens de portador)

Alguns servidores OAuth não oferecem suporte ao registro dinâmico de clientes (DCR). Sendo assim, o Notion deve pré-registrar um aplicativo cliente com o serviço de terceiros antes que o login OAuth possa funcionar. Se o servidor que você deseja usar não suportar DCR, verifique a documentação para entender se é possível usar uma chave de API ou um token de portador. Se nenhuma das opções estiver disponível, o servidor MCP não poderá ser usado com Agentes personalizados.

Você pode decidir como um agente personalizado deve usar uma conexão MCP nas ConfiguraçõessobFerramentas e acesso. Expanda a entrada de conexão do MCP para ver as ferramentas disponíveis e determinar como elas são executadas. As ferramentas podem ser ativadas ou desativadas usando o botão ao lado.

Ferramentas de leitura e escrita

• As ferramentas de leitura (ex.: busca, busca, listagem, visualização) permitem que o agente personalizado recupere ou visualize informações sem fazer alterações em sistemas externos.

• Ferramentas de escrita (ex: criar, atualizar, excluir, enviar, publicar) fazem alterações nos dados em sistemas externos. Por padrão, elas

  exigem confirmação antes que o agente execute a ação.

Executar automaticamente ou sempre perguntar

• A execução automática permite que a ferramenta seja executada sem exigir a confirmação

  do usuário. Esta configuração é melhor para ferramentas de leitura (busca, busca, lista, visualização), pois elas não modificam os dados.

• Sempre perguntart exige que um usuário aprove ou cancele uma ação antes que ela seja executada. Esta é a configuração padrão para ferramentas de escrita (criar, atualizar, excluir, enviar) para evitar alterações não intencionais.

Para remover uma conexão MCP

1. Abra as Configuraçõesdo seu agente.

2. Vá para Ferramentas e acesso.

3. Encontre a conexão MCP e clique em Remover.

4. Clique em Salvar.

5. Sempre teste seu agente depois de fazer alterações. Você pode se reconectar a qualquer momento autenticando novamente.

Observação: se você remover uma conexão, o agente não poderá mais acessar esse serviço e as execuções agendadas que dependem desse servidor poderão falhar. Os fluxos de trabalho do seu agente podem ser interrompidos se você remover uma conexão, mesmo antes de clicar em Salvar.

As conexões MCP respeitam os níveis de permissão do usuário definidos no seu Agente Personalizado. Veja o que cada nível de permissão pode fazer com as ferramentas conectadas ao MCP.

Os usuários com autorizações Acesso completo e Pode editar em um agente podem:

• Adicionar novas conexões de MCP ao agente

• Conversar com o agente e usar todas as ferramentas conectadas, mesmo que não tenham acesso à ferramenta fora do agente personalizado

• Visualizar o registro de atividade do agente e o uso da ferramenta MCP

• Remover conexões MCP existentes

• Reconectar ou atualizar as credenciais do servidor MCP

E, para as conexões de MCP que eles configuram, os usuários com autorizações Acesso completo e Pode editar podem:

• Configurar quais ferramentas estão habilitadas ou desabilitadas e alterar as configurações de execução da ferramenta (executar automaticamente ou sempre perguntar)

Observação: depois que uma conexão MCP é estabelecida, apenas a pessoa que autentica a conexão MCP pode configurar e atualizar as configurações da ferramenta, mesmo que outras pessoas tenham permissões de acesso total ou de edição para o agente. O agente usa as credenciais e permissões dessa pessoa ao acessar o serviço externo.

Usuários com o nível de autorização Pode visualizar e interagir com um agente podem:

• Conversar com o agente e usar todas as ferramentas conectadas, mesmo que não tenham acesso às ferramentas fora do agente personalizado.

• Acionar ações de leitura e escrita por meio do agente

• Aprovar ou cancelar ações de escrita quando a confirmação for necessária

• Ver quais servidores MCP estão conectados (nas configurações do agente)

Os usuários com autorizações do tipo Pode visualizar e interagir não podem:

• Adicionar ou remover conexões MCP

• Alterar quais ferramentas estão habilitadas

• Modificar as configurações de execução da ferramenta

• Ver o registro de atividade completo do agente

Observação: as ações de gravação (p. ex., criar ou atualizar itens) exigem confirmação por padrão para evitar alterações não intencionais. Os usuários verão um prompt mostrando exatamente qual ação o agente executará antes de executá-la.

Se as ferramentas não aparecerem após a conexão:

• Atualize a página de configurações do agente.

• Verifique se o servidor MCP foi autenticado (procure uma marca de seleção verde ou o status “Conectado”).

• Verifique se o servidor está on-line e retornando os metadados da ferramenta.

• Tente reconectar o servidor ou desconectá-lo e adicioná-lo novamente.

Se as execuções do agente falharem com erros de MCP:

• Verifique mensagens de erro específicas na guia Atividade .

• Verifique se a sua conexão ainda é válida (os tokens podem ter vencido).

• Confira se a conexão ainda está habilitada nas configurações do agente.

• Tente reconectar o servidor MCP para atualizar as credenciais.

• Atualize as instruções do seu agente para mencionar o nome do servidor ou da ferramenta que você deseja usar. Por exemplo: “use o Linear MCP para recuperar metadados para este mock”.