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 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.

O que são conectores MCP?

Os 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 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 vitrine 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 do uso dos 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 tarefas 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 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

Uma vez habilitado para seu workspace, você encontrará as configurações MCP em Configurações > Data connectors.

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.

Navegue até Configurações > Data connectors.
Você verá uma seção intitulada "Adicionar Data Connectors de aplicativos populares — alimentado por servidores Model Context Protocol (MCP)."
Clique no bloco do aplicativo que deseja conectar (por exemplo, Linear).
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 Fin a acessar seus dados. Siga as instruções na tela (isso normalmente envolve um fluxo OAuth).
2. Caso contrário, um token de acesso pode ser criado ou um existente pode ser escolhido em Configurações > Authentication no seu workspace Fin.
Uma vez autorizado, você será redirecionado de volta ao Fin. O servidor MCP conectado agora aparecerá na sua lista de data connectors, 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:

Navegue até Configurações > Data connectors.
Clique no bloco Custom MCP.
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 seu provedor de servidor MCP.
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.
Clique em Adicionar Servidor MCP.
Uma vez autorizado, o servidor MCP personalizado será listado em seus data connectors.

Adicionando ferramentas de um servidor MCP conectado

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

Encontre seu servidor MCP recém-conectado na lista (por exemplo, "Linear (0)").
Clique no botão "+ Novo" localizado na seção desse servidor.
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").
Clique na ferramenta que deseja que o Fin use (por exemplo, "Listar Comentários").
A ferramenta agora será adicionada como um data connector na seção desse servidor MCP. A contagem ao lado do nome do servidor será atualizada (por exemplo, "Linear (1)").

Configurando uma ferramenta MCP (data connector)

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

Clique na ferramenta recém-adicionada (por exemplo, "Listar comentários") para abrir sua página de configuração.
Você verá abas familiares: Sobre, API Connection, Test response, Data access, e Object mapping.

A. Aba Sobre:
- Nome & Descrição: Normalmente, esses campos são preenchidos automaticamente pelo servidor MCP. Você pode editá-los se necessário.
- "Enable Fin to use this connector directly without adding it to a workflow or task": 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, será necessário adicionar esta ferramenta a um workflow ou tarefa do Fin.
- Regras de público: Defina para quem este conector está disponível (por exemplo, Users, Leads).
B. Aba de parâmetros de entrada:
- Esta aba mostra as entradas que a ferramenta requer (por exemplo, um "IssueID" para uma ferramenta "List Comments").
- 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: Extraia o valor de um atributo de usuário, empresa ou conversa.
  - Ignorar entrada: Parâmetros opcionais podem ser ignorados e não serão incluídos na solicitação.
C. Aba de resposta de teste:
- Teste a ferramenta para garantir que está funcionando corretamente.
- Resposta ao vivo: Faz uma chamada real de API para o servidor MCP.
- Resposta de exemplo: Forneça dados JSON de exemplo para simular uma resposta.
D. Acesso a dados:
- Atenção: Recomendamos extrema cautela com as ferramentas disponibilizadas ao Fin. Quaisquer dados retornados ao Fin a partir da resposta de uma 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 mais detalhes.
E. Definir ao vivo:
- Depois de configurar e testar a ferramenta, clique no botão Set live no topo da página.
- O status da ferramenta mudará de "Draft" para "Live", e o Fin poderá usá-la.

Atenção: 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 "Enable Fin to use this connector directly..." 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 e Procedimentos do Fin, 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 conectar a qualquer sistema que forneça um servidor MCP compatível usando a opção "Custom MCP". Você precisará da URL do servidor MCP do provedor desse sistema e dos detalhes de autenticação dependendo dos tipos de autenticação 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 da indústria para autorização.
Permissões Granulares: Durante o processo OAuth, você concede ao Fin permissões específicas para acessar dados ou realizar 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 Fin e usado para autenticar com o servidor MCP.

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

Perguntas frequentes

O que é o 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 da indústria 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 os detalhes de autenticação.

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

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

Quais conectores de dados prontos para uso estão disponíveis usando MCP?

Você pode importar conectores de dados prontos para uso para o Fin — alimentados por servidores Model Context Protocol (MCP) de:

Stripe: Importe conectores Stripe para gerenciamento de cobrança e assinaturas.
Linear: Importe conectores Linear para gerenciamento de issues e projetos.
Shopify: Conecte-se ao catálogo, carrinho e políticas de uma loja para ajudar os clientes a comprar com esse comerciante.

Ou, crie um MCP personalizado para conectar seu próprio servidor MCP e adicionar conectores personalizados.

Posso restringir os dados que o Fin acessa dos servidores MCP?

Sim, ao integrar conectores de dados MCP com o Fin, você tem controle total sobre os dados compartilhados entre esses servidores e o Fin. Essa flexibilidade permite ajustar o acesso aos dados para atender às suas necessidades específicas de privacidade e operação.

Use modelos de conectores de dados: O Fin fornece modelos pré-fabricados de conectores de dados para Stripe, Linear e Shopify, cada um projetado para buscar conjuntos específicos de dados. Esses modelos simplificam o processo de configuração ao pré-definir configurações comuns de dados.
Restrinja campos de dados específicos: Durante o processo de configuração, você pode:
1. Fornecer ao Fin acesso a todos os elementos de dados retornados pelo modelo de conector selecionado.
2. Restringir o acesso selecionando atributos ou campos específicos que o Fin pode usar na aba Data transformation. Isso garante que apenas dados relevantes ou essenciais estejam acessíveis.

Nota: Você não é obrigado a permitir acesso a todos os campos de dados. Revise cuidadosamente as opções durante a configuração para garantir que mantenha o nível desejado de controle sobre seus dados.

Como faço para acessar URLs de anexos de uma conversa?

A ferramenta fetch atualmente não inclui detalhes de anexos em sua resposta. Como alternativa, use a ferramenta get_conversation — ela retorna a resposta bruta da API, que inclui URLs de anexos na fonte da conversa e nas partes da conversa.

Adicione conectores MCP para aplicativos populares ou MCPs personalizados