Strategy SAMCentral de Ajuda
    Falar com o suporte
    Agentes de IA

    Como configurar e usar o servidor MCP

    O servidor MCP permite que agentes de IA e clientes compatíveis com MCP se conectem com segurança às ferramentas e serviços. Com o MCP, os assistentes de IA podem recuperar registros, atualizar dados, enviar mensagens, buscar oportunidades, acessar informações de calendário e automatizar tarefas por meio de uma conexão HTTP padronizada.

    Atualizado em

    O servidor MCP permite que agentes de IA e clientes compatíveis com MCP se conectem com segurança às ferramentas e serviços. Com o MCP, os assistentes de IA podem recuperar registros, atualizar dados, enviar mensagens, buscar oportunidades, acessar informações de calendário e automatizar tarefas por meio de uma conexão HTTP padronizada.

    O que é um servidor MCP?

    O servidor MCP utiliza o Protocolo de Contexto de Modelo (MCP) para permitir que agentes de IA interajam com segurança com os serviços. O MCP atua como uma ponte entre um cliente de IA e o sistema, permitindo que o cliente de IA descubra ferramentas disponíveis, consulte dados e execute ações aprovadas.

    O servidor MCP pode ser usado com clientes de IA e ferramentas de desenvolvimento compatíveis para interagir com serviços, como Contatos, Conversas, Calendários, Oportunidades, Pagamentos, Locais e Campos Personalizados.

    Ponto final MCP de alto nível: https://services.leadconnectorhq.com/mcp/

    Principais benefícios do servidor MCP

    • Acesso centralizado à IA: Conecte agentes de IA a vários serviços por meio de um único endpoint MCP.
    • Autenticação segura: utilize tokens de integração privados e permissões com escopo definido para controlar o acesso.
    • Automação em linguagem natural: permita que assistentes de IA executem ações compatíveis a partir de comandos em linguagem natural.
    • Conectividade Multisserviços: Trabalhe com contatos, conversas, calendários, oportunidades, pagamentos, locais e muito mais.
    • Flexibilidade compatível com MCP: Conecte clientes compatíveis, como Cursor, Windsurf, OpenAI Playground, clientes compatíveis com Claude e aplicativos MCP personalizados.
    • Não é necessário SDK: utilize uma conexão MCP padronizada baseada em HTTP em vez de criar uma integração totalmente personalizada.

    Exemplo de clientes MCP suportados

    Clientes compatíveis com MCP permitem que agentes de IA descubram e executem ferramentas por meio de um servidor conectado. O suporte depende da capacidade do cliente de se conectar a servidores MCP baseados em HTTP e de transmitir os cabeçalhos de autenticação necessários.

    Exemplos de clientes atendidos incluem:

    • Cursor
    • Windsurf
    • Playground da OpenAI
    • Clientes MCP compatíveis com Claude
    • Aplicações personalizadas compatíveis com MCP
    • Outros clientes MCP baseados em HTTP

    Pré-requisitos

    Uma configuração correta ajuda a garantir que o cliente de IA possa acessar apenas os dados e ações de alto nível de que precisa. Antes de se conectar ao servidor MCP, certifique-se de ter:

    • Acesso à subconta/localização desejada
    • Um token de integração privado
    • Escopos obrigatórios ativados para o token
    • O ID da subconta/localização
    • Um cliente compatível com MCP

    Como configurar o servidor MCP

    Para conectar um cliente MCP, é necessário um Token de Integração Privado, o endpoint MCP de alto nível e o ID de localização. Uma vez conectado, o cliente de IA pode descobrir as ferramentas disponíveis com base nos escopos concedidos ao token.

    1. 1

      Crie um token de integração privado: Faça login no sistema, abra a subconta/localização desejada, acesse as Configurações, selecione Integrações Privadas, clique em Criar nova integração, selecione os escopos necessários, clique em Criar integração e copie o token gerado.

    2. 2

      Adicione o servidor MCP ao seu cliente: Adicione o endpoint MCP e os cabeçalhos de autenticação ao seu cliente compatível com MCP, substituindo <your-token> pelo seu Token de Integração Privado e <your-location-id> pelo ID de subconta/localização.

    3. 3

      Selecione as ferramentas necessárias: Após a conexão do cliente, as ferramentas disponíveis aparecem com base nos escopos atribuídos ao Token de Integração Privada. Selecione apenas as ferramentas que seu agente de IA precisa para o fluxo de trabalho.

    Escopos recomendados

    Os escopos controlam quais recursos de alto nível o cliente MCP pode ler ou modificar. Conceda apenas as permissões necessárias para o seu fluxo de trabalho. Os escopos recomendados podem incluir:

    • Contatos: Visualizar contatos, Editar contatos
    • Conversas: Ver conversas, Editar conversas
    • Mensagens da conversa: Visualizar mensagens da conversa, Editar mensagens da conversa
    • Oportunidades: Visualizar Oportunidades, Editar Oportunidades
    • Calendários: Visualizar calendários, Editar calendários
    • Eventos do calendário: visualizar eventos do calendário, editar eventos do calendário
    • Pagamentos: Visualizar Ordens de Pagamento, Visualizar Transações de Pagamento
    • Outros: Visualizar campos personalizados, Visualizar formulários, Visualizar locais

    Ferramentas de calendário

    As ferramentas de calendário ajudam os agentes de IA a obter informações de agendamento e detalhes de compromissos.

    • calendars_get-calendar-events
    • calendars_get-appointment-notes

    Ferramentas de contato

    As ferramentas de contato permitem que agentes de IA encontrem, criem, atualizem e gerenciem registros de contato.

    • contacts_get-all-tasks
    • contacts_add-tags
    • contacts_remove-tags
    • contacts_get-contact
    • contacts_update-contact
    • contacts_upsert-contact
    • contacts_create-contact
    • contacts_get-contacts

    Ferramentas de Conversação

    As ferramentas de conversação permitem que agentes de IA pesquisem conversas, revisem o histórico de mensagens e enviem mensagens compatíveis.

    • conversations_search-conversation
    • conversations_get-messages
    • conversations_send-a-new-message

    Ferramentas de localização

    As ferramentas de localização permitem que agentes de IA recuperem detalhes de localização e informações de campos personalizados.

    • locations_get-location
    • locations_get-custom-fields

    Ferramentas de Oportunidade

    As ferramentas de oportunidade permitem que agentes de IA pesquisem, recuperem e atualizem oportunidades no pipeline.

    • opportunities_search-opportunity
    • opportunities_get-pipelines
    • opportunities_get-opportunity
    • opportunities_update-opportunity

    Ferramentas de pagamento

    As ferramentas de pagamento permitem que agentes de IA recuperem dados de pedidos e transações.

    • payments_get-order-by-id
    • payments_list-transactions

    Exemplos de fluxos de trabalho MCP

    O MCP permite que agentes de IA interajam com o sistema usando linguagem natural, enquanto executam ferramentas aprovadas em segundo plano. Os fluxos de trabalho comuns incluem:

    • Procurar um contato por nome, e-mail ou número de telefone.
    • Criar ou atualizar um contato
    • Adicionar ou remover etiquetas de contato
    • Pesquisando histórico de conversas
    • Enviar uma mensagem para um contato
    • Recuperando eventos do calendário
    • Em busca de oportunidades
    • Atualizando detalhes da oportunidade
    • Analisando os dados da ordem de pagamento ou da transação.

    Segurança e Autenticação

    O servidor MCP utiliza autenticação baseada em token para proteger o acesso aos dados do sistema. Cada solicitação deve incluir um token de integração privado válido e um ID de localização.

    Detalhes de autenticação necessários: Token de integração privado, locationId e escopos necessários para as ferramentas solicitadas. Mantenha os tokens em sigilo e nunca os exponha em repositórios públicos, capturas de tela, prompts compartilhados ou código do lado do cliente.

    Melhores práticas

    Seguir as melhores práticas de MCP ajuda a manter os fluxos de trabalho de IA seguros, confiáveis e mais fáceis de gerenciar.

    • Utilize o princípio do menor privilégio: habilite apenas os escopos necessários para o fluxo de trabalho de IA.
    • Armazene os tokens com segurança: mantenha os tokens de integração privados em um local seguro e evite compartilhá-los publicamente.
    • Analise cuidadosamente as permissões de escrita: conceda permissões de edição somente quando o agente de IA precisar criar ou atualizar dados.
    • Teste antes do uso em produção: Confirme se o cliente de IA está chamando as ferramentas corretas e retornando os resultados esperados.
    • Monitore a atividade da IA: revise as ações controladas por IA ao habilitar o acesso de gravação.
    • Rotacionar tokens periodicamente: Substituir tokens regularmente ou quando o acesso precisar ser revogado.
    • Use instruções claras: Forneça ao agente de IA instruções específicas sobre quando ele deve ler dados, atualizar registros ou solicitar confirmação.