Passar para o conteúdo principal

Adicione conectores MCP para apps populares ou MCPs personalizados

Potencialize o Fin com mais dados e ações para resoluções de clientes mais rápidas e precisas com o poder dos conectores MCP.

Escrito por Davy Malone

Fin agora pode se conectar diretamente às suas outras ferramentas de negócios, como gerenciamento de projetos (Linear), sistemas de cobrança (Stripe) ou plataformas de ecommerce (Shopify), usando um novo recurso chamado conectores MCP (Model Context Protocol). Isso permite que o Fin acesse informações em tempo real e até execute ações nesses sistemas externos, levando a resoluções mais completas e eficientes para seus clientes.

Nota: Para ferramentas como Linear, atributos do app não podem ser usados em relatórios do Intercom. Uma solução é criar atributos personalizados no Intercom e usá-los como coluna nos relatórios.


O que são conectores MCP?

Conectores MCP são uma forma poderosa para o Fin interagir com suas aplicações externas e fontes de dados. Pense nisso como dar ao Fin uma chave segura para acessar informações e capacidades específicas de outros softwares que você usa. Em vez de o Fin conhecer apenas o que está no Intercom ou no seu Help Center, ele agora pode acessar dados como:

  • Stripe - A integração MCP para Fin importa conectores Stripe para gerenciamento de cobrança e assinaturas.

  • Shopify - A integração MCP para storefront do Fin conecta ao catálogo, carrinho e políticas de uma loja Shopify para ajudar os clientes a comprar com esse comerciante.

  • Linear - A integração MCP para Fin importa conectores Linear para gerenciamento de problemas e projetos.

Isso torna o Fin muito mais inteligente e capaz de lidar com consultas complexas de clientes sem precisar transferir para um agente humano.

Principais benefícios de usar conectores MCP

  • Acesse Mais Dados: O Fin obtém acesso em tempo real às informações dos seus sistemas conectados.

  • Automatize Mais Ações: Permita que o Fin execute ações em ferramentas externas (por exemplo, criar um ticket, atualizar um status) se a ferramenta suportar.

  • Resoluções Mais Rápidas e Precisas: Os clientes obtêm as respostas que precisam mais rapidamente, diretamente do Fin.

  • Redução de Transferências para Agentes: O Fin pode lidar com mais consultas de forma independente, liberando sua equipe.

  • Configuração Fácil e Segura: Conecte suas ferramentas em poucos passos usando autenticação padrão do setor.

Importante: O servidor MCP do Intercom atualmente é suportado apenas para workspaces hospedados nos EUA. Regiões de hospedagem de dados na UE e AU não são suportadas no momento, e tentativas de usar o servidor MCP nessas regiões resultarão em erros.


Configurando conectores MCP para o Fin

Uma vez habilitado para seu workspace, você encontrará as configurações MCP em Configurações > Integrações > Conectores de dados.

Conectando um servidor MCP

Você pode conectar um servidor MCP de duas maneiras:

1. Conectar usando um modelo

Para aplicativos populares, fornecemos modelos pré-construídos para uma configuração mais rápida, incluindo Stripe, Shopify e Linear.

  1. Você verá uma seção intitulada "Adicionar Conectores de Dados de apps populares — alimentado por servidores Model Context Protocol (MCP)."

  2. Clique no bloco do app que deseja conectar (por exemplo, Linear).

    Nota: O app deve estar instalado no seu workspace para usar um modelo de Conector de Dados.

  3. Autorizar acesso ao servidor MCP

    1. Se o servidor MCP de terceiros suportar OAuth, você será redirecionado para o site do aplicativo para autorizar o Intercom Fin a acessar seus dados. Siga as instruções na tela (normalmente envolve um fluxo OAuth).

    2. Caso contrário, um token de acesso pode ser criado ou um existente pode ser escolhido na página de Configurações de Autenticação no Intercom.

  4. Uma vez autorizado, você será redirecionado de volta ao Intercom. O servidor MCP conectado agora aparecerá na sua lista de conectores de dados, geralmente com "(0)" indicando que nenhuma ferramenta foi adicionada ainda (por exemplo, "Linear (0)")

2. Conectar um servidor MCP personalizado

Se você tem seu próprio servidor MCP ou está conectando um serviço de terceiros que ainda não tem um modelo:

  1. Clique no bloco Custom MCP.

  2. Um modal aparecerá onde você precisará inserir:

    • Nome: Um nome descritivo para esta conexão (por exemplo, "Nosso CRM Interno", "Linear Dev").

    • URL: A URL base do servidor MCP (por exemplo, https://mcp.your-service.com/sse). Você obterá essa URL do provedor do seu servidor MCP.

  3. Você pode optar por fornecer um token de acesso se o servidor escolhido suportar autenticação baseada em token; se nenhum for fornecido, tentaremos iniciar um fluxo OAuth com o servidor MCP fornecido.

  4. Clique em Adicionar Servidor MCP.

  5. Uma vez autorizado, o servidor MCP personalizado será listado nos seus conectores de dados.

Adicionando ferramentas de um servidor MCP conectado

Uma vez que um servidor MCP está conectado, você precisa informar ao Fin quais "ferramentas" específicas (funções ou pontos de dados) desse servidor ele pode usar.

  1. Encontre seu servidor MCP recém-conectado na lista (por exemplo, "Linear (0)").

  2. Clique no botão "+ Novo" localizado na seção desse servidor.

  3. Um modal aparecerá (por exemplo, "Conectores Linear") listando todas as ferramentas disponíveis fornecidas por esse servidor MCP (por exemplo, "Listar Comentários", "Criar Problema", "Obter Detalhes do Pedido").

  4. Clique na ferramenta que deseja que o Fin use (por exemplo, "Listar Comentários").

  5. A ferramenta agora será adicionada como um Conector de Dados sob a seção desse servidor MCP. A contagem ao lado do nome do servidor será atualizada (por exemplo, "Linear (1)").

Configurando uma ferramenta MCP (Conector de Dados)

Cada ferramenta adicionada de um servidor MCP funciona como um Conector de Dados padrão e precisa ser configurada antes que o Fin possa usá-la.

  1. Clique na ferramenta recém-adicionada (por exemplo, "Listar comentários") para abrir sua página de configuração.

  2. Você verá abas familiares: Sobre, Parâmetros de Entrada, Testar resposta e Acesso a dados.

    A. Aba Sobre:

    • Nome e Descrição: Normalmente são preenchidos pelo servidor MCP. Você pode editá-los se necessário.

    • "Permitir que o Fin use este conector diretamente sem adicioná-lo a um workflow ou tarefa": Marque esta caixa se quiser que o Fin decida inteligentemente quando usar esta ferramenta com base na conversa, usando seu nome e descrição. Se desmarcado, você precisará adicionar esta ferramenta a um Workflow ou Procedimento do Fin.

    • Regras de público: Defina para quem este conector está disponível (por exemplo, Users, Leads).

    B. Aba Parâmetros de Entrada:

    • Esta aba mostra as entradas que a ferramenta requer (por exemplo, um "IssueID" para uma ferramenta "Listar Comentários").

    • Para cada entrada, você precisa especificar a Fonte de Dados:

      • Deixe o Fin decidir: O Fin tentará encontrar a informação na conversa, ações anteriores ou perguntará ao cliente.

      • Defina um valor personalizado: Defina um valor específico fixo.

      • Use um atributo: Puxe o valor de um atributo de usuário, empresa ou conversa do Intercom.

      • Ignorar Entrada: Parâmetros opcionais podem ser ignorados e não serão incluídos na solicitação.

    C. Aba Testar resposta:

    • Teste a ferramenta para garantir que está funcionando corretamente.

    • Resposta ao vivo: Faz uma chamada API real para o servidor MCP.

    • Resposta de exemplo: Fornece dados JSON de exemplo para simular uma resposta.

    D. Acesso a dados:

    • Nota: Recomendamos extrema cautela com as ferramentas disponibilizadas ao Fin. Quaisquer dados retornados ao Fin de uma resposta da ferramenta podem ser compartilhados com o cliente.

    • Configure esta aba como faria para conectores de dados padrão baseados em API. Aqui você pode definir como o Fin interpreta e usa os dados retornados pela ferramenta. Consulte nossa documentação geral de conectores de dados para detalhes.

    E. Definir ao vivo:

    • Depois de configurar e testar a ferramenta, clique no botão Definir ao vivo no topo da página.

    • O status da ferramenta mudará de "Rascunho" para "Ao vivo", e o Fin agora poderá usá-la.

Nota: O Fin só pode processar uma chamada de conector por vez, então se seu servidor MCP enviar duas respostas separadas pelo mesmo fluxo SSE, o Fin não poderá usar a primeira resposta de forma confiável para construir sua resposta.


Como o Fin usa ferramentas MCP

Uma vez que uma ferramenta MCP está ao vivo:

  • Se "Permitir que o Fin use este conector diretamente..." estiver marcado: O Fin analisará as conversas dos clientes. Se determinar que a ferramenta pode ajudar a resolver a consulta (com base no nome e descrição da ferramenta e nas entradas que ela requer), o Fin tentará automaticamente coletar as entradas necessárias e usar a ferramenta.

  • Se não estiver habilitado para uso direto, ou para cenários mais complexos: Você pode adicionar essas ferramentas MCP como etapas dentro dos seus Workflows Fin e Procedures, dando controle preciso sobre quando e como são usadas.

O Fin faz uma solicitação ao servidor MCP, recebe uma resposta e usa as informações (com base no seu mapeamento de objetos) para responder ao cliente ou realizar ações adicionais.

Apps suportados e conexões personalizadas

  • Modelos: Estamos lançando com um modelo para Linear, Stripe e Shopify. Continuaremos adicionando mais modelos para apps populares.

  • Custom MCP: Você pode se conectar a qualquer sistema que forneça um servidor compatível com MCP usando a opção "Custom MCP". Você precisará da URL do servidor MCP do provedor desse sistema e detalhes de autenticação dependendo dos tipos suportados (OAuth ou baseado em Token).

Segurança

Conectar o Fin a sistemas externos é feito de forma segura:

  • OAuth 2.0: Conexões a servidores MCP de terceiros são autenticadas usando OAuth 2.0, um protocolo padrão do setor para autorização.

  • Permissões Granulares: Durante o processo OAuth, você concede ao Intercom Fin permissões específicas para acessar dados ou executar ações. Você controla o que o Fin pode acessar.

  • Acesso baseado em Token: Quando suportado, um token de acesso de terceiros pode ser armazenado com segurança no Intercom e usado para autenticar com o servidor MCP.

Nota: MCP atualmente não suporta todos os mesmos tipos de token que conectores de dados padrão. MCP tem seu próprio fluxo de autenticação específico.


Perguntas frequentes

O que é Model Context Protocol (MCP)?

É uma forma padronizada para modelos de IA como o Fin descobrirem e interagirem com ferramentas externas e fontes de dados.

Conectar a servidores MCP é seguro?

Sim, as conexões usam OAuth 2.0 (um padrão do setor para autorização segura) ou acesso baseado em token.

E se o app que quero conectar não estiver listado como modelo?

Se o app ou sistema fornecer um servidor MCP, você pode conectá-lo usando a opção "Custom MCP" fornecendo a URL do servidor MCP e detalhes de autenticação.

Onde obtenho a URL do Servidor MCP para uma conexão personalizada?

Você precisará obter essa URL da documentação ou equipe de suporte do aplicativo ou sistema que está tentando conectar.


Respondeu à sua pergunta?