Conexões MCP para agentes personalizados

As conexões MCP (Model Context Protocol) permitem que seu Agente personalizado se conecte com segurança a aplicativos externos. Com as conexões MCP, seu agente pode ler informações e realizar ações usando conexões pré-configuradas com aplicativos como Linear, Ramp, Figma e outros — ou conectar-se a qualquer aplicativo configurando conexões MCP personalizadas.

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

As conexões MCP permitem que Agentes personalizados interajam com ferramentas e serviços externos por meio do Model Context Protocol. As ferramentas MCP funcionam com todos os tipos de gatilho, incluindo execuções agendadas, execuções acionadas com base em eventos do Notion ou Slack e execuções manuais a partir de chat 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 habilitadas ou desabilitadas, e você pode escolher se deseja exigir confirmação antes de executar, executar automaticamente ou permitir permanentemente todas as ferramentas de um servidor.

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

Isso significa:

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

• 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:

• Amplitude

• Attio

• Box

• ClickHouse

• Figma

• GitHub

• HubSpot

• Intercom

• Linear

• Mercury

• Miro

• Mixpanel

• n8n

• Ramp

• Stripe

• Sentry

• 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. Elas variarão com base no servidor que você escolher.

7. Clique em Conectar.

Para se conectar a um servidor MCP que não está na lista pré-configurada, um administrador do espaço de trabalho deve primeiro ativar esta opção. Existem duas configurações separadas: uma para permitir servidores MCP personalizados e outra para decidir se os membros podem instalar qualquer conexão ou apenas as que você aprovar.

Para permitir servidores MCP personalizados:

1. Como administrador do espaço de trabalho, vá para Configurações → Conexões.

2. Na guia Gerenciar, ative Habilitar servidores MCP personalizados.

Para escolher se os membros podem instalar qualquer conexão ou apenas conexões aprovadas pelo administrador:

1. Como administrador do espaço de trabalho, vá para Configurações → Conexões.

2. Na guia Gerenciar, encontre a seção Gerenciar permissões.

3. Ao lado de Limitar quais conexões os membros podem instalar, escolha uma opção:

   • Aprovadas e recomendadas: aprova automaticamente todas as conexões recomendadas pelo Notion.

   • Apenas aprovadas: selecione manualmente cada conexão que os membros podem instalar.

4. Selecione Conexões aprovadas para revisar o que os membros podem instalar.

5. Selecione Adicionar conexão aprovada e, em seguida, escolha o que deseja permitir:

   • Conexões: pesquise uma conexão por nome ou ID e adicione-a à lista de aprovadas.

   • Servidor MCP personalizado: adicione uma URL de servidor MCP personalizado específica que você deseja permitir.

6. Clique em Salvar.

Uma vez definido, qualquer pessoa no espaço de trabalho pode se conectar às opções aprovadas ao configurar um Agente personalizado. Eles se autenticarão com suas próprias credenciais.

Para adicionar um MCP personalizado a um Agente personalizado:

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

2. Vá para Ferramentas e Acesso.

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

4. Você precisará inserir a URL do servidor MCP da ferramenta ou provedor ao qual está se conectando (por exemplo: a equipe de ferramentas internas da sua empresa).

5. Forneça um Nome de exibição para a conexão (Opcional).

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

7. Clique em Conectar.

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 suportam registro dinâmico de cliente (DCR). Isso significa que 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 dele para ver se você pode usar uma chave de API ou um token de portador (bearer token) em vez disso. 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ções do seu agente em Ferramentas e Acesso. Expanda a entrada da conexão 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 de alternância adjacente.

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, postar) fazem alterações nos dados de sistemas externos. Por padrão, elas requerem confirmação antes que o agente execute a ação.

Executar automaticamente ou sempre perguntar

• Executar automaticamente permite que a ferramenta seja executada sem exigir confirmação do usuário. Esta configuração é ideal para ferramentas de leitura (pesquisar, buscar, listar, visualizar), já que elas não modificam dados.

• Sempre perguntar exige que o 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.

• Sempre permitir aprova permanentemente todas as ferramentas de um servidor e remove solicitações de confirmação futuras.

Para remover uma conexão MCP

1. Abra as Configurações do seu agente.

2. Vá para Ferramentas e Acesso.

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

4. Clique em Desconectar para confirmar.

5. Sempre teste seu agente após fazer alterações. Você pode reconectar a qualquer momento autenticando-se 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 assim que você desconectar. Você pode reconectar a qualquer momento autenticando-se novamente.

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 ferramentas conectadas via MCP.

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

• Adicionar novas conexões MCP ao agente personalizado.

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

• 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 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: Uma vez 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 outros tenham autorizações Acesso completo ou Pode editar no agente personalizado. O agente usa as credenciais e permissões dessa pessoa ao acessar o serviço externo.

Usuários com permissão para visualizar e interagir em um agente personalizado podem:

• Conversar com o agente personalizado 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 personalizado).

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.

Nota: Ações de escrita (como 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 realizará 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 personalizado 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 personalizado 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.”