UTM Mind MCP

Automatize a criação, validação e governança de links UTM com comandos em linguagem natural.

Ver em utmmind.comExperimente este MCPPatrocinado

Documentação

Como Integrar o UTM Mind com Agentes de IA via MCP para Automação Completa

Em um mundo onde equipes de marketing executam centenas de campanhas em dezenas de canais, o gerenciamento manual de UTM não é mais apenas tedioso — é uma ameaça direta à qualidade dos dados. O UTM Mind resolve isso com suas poderosas ferramentas de governança e, agora, com a introdução do nosso Servidor Model-Context Protocol (MCP), você pode automatizar todo o seu fluxo de trabalho de UTM integrando diretamente com agentes de IA como Manus, Claude ou Cursor.

Este guia vai te acompanhar pelo processo de conectar o UTM Mind ao seu agente de IA, explicar os cenários de automação de alto impacto que isso desbloqueia e fornecer a configuração exata que você precisa para começar.

O que é MCP e Por Que Isso Importa para Automação de UTM?

O Model-Context Protocol (MCP) é um padrão aberto que permite que agentes de IA descubram e interajam com ferramentas e APIs externas de forma estruturada e previsível. Pense nele como uma linguagem universal para agentes de IA conversarem com serviços como o UTM Mind.

Em vez de escrever código de integração de API personalizado para cada ferramenta, você simplesmente fornece ao agente a URL do Servidor MCP e sua chave de API. O agente então entende automaticamente quais ferramentas estão disponíveis, quais entradas elas precisam e como chamá-las.

Para o UTM Mind, isso significa que seu agente de IA pode:

Criar e gerenciar links UTM — individuais, em massa ou em lote entre canais
Validar URLs contra suas convenções de nomenclatura — detectar erros antes que eles poluam seus dados
Listar e criar templates, regras e atributos — gerenciar toda a sua configuração de governança programaticamente
Executar operações em massa — gerar 50 links para o lançamento de uma campanha em um único comando

...tudo através de comandos em linguagem natural dentro do seu fluxo de trabalho de agente existente.

A URL do Servidor MCP do UTM Mind

O Servidor MCP do UTM Mind está disponível em:

https://www.utmmind.com/api/mcp

Esta é a URL que você fornecerá ao seu agente de IA. A autenticação é feita via token Bearer (sua chave de API) nos cabeçalhos da requisição. Não há fluxo OAuth separado necessário — basta gerar uma chave e começar.

Conectando o UTM Mind ao Seu Agente de IA

Começar é um processo simples de duas etapas.

Etapa 1: Gere Sua Chave de API

Primeiro, você precisa de uma chave de API do UTM Mind. Esta chave autentica seu agente e garante que ele tenha as permissões corretas.

Navegue até Workspace → 🔑 API & Integrations no seu painel do UTM Mind.
Clique na aba API Keys.
Clique em + Generate New Key.
Dê um nome descritivo à sua chave (ex.: "Manus Agent - Prod").
Conceda os escopos necessários. Para automação completa, selecione todos os escopos de leitura e escrita.
Clique em Generate Key e copie a chave para um local seguro. Você não poderá vê-la novamente.

Etapa 2: Configure Seu Agente com o Servidor MCP

Agora, informe ao seu agente de IA onde encontrar o servidor MCP do UTM Mind e como autenticar. Adicione o seguinte bloco JSON à configuração MCP do seu agente:

{
  "mcpServers": {
    "utm-mind": {
      "url": "https://www.utmmind.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Substitua YOUR_API_KEY pela chave que você gerou na etapa anterior.

Pronto! Seu agente agora está conectado ao UTM Mind e tem acesso a todas as 10 ferramentas disponíveis.

Ferramentas MCP Disponíveis

Uma vez conectado, seu agente tem acesso às seguintes ferramentas:

Ferramenta	Descrição
`list_links`	Listar links UTM com filtros opcionais
`create_link`	Criar um link UTM único validado
`create_links_batch`	Criar múltiplos links em uma única chamada
`list_templates`	Listar todos os templates de UTM
`create_template`	Criar um novo template
`validate_url`	Validar uma URL contra seus conjuntos de regras
`list_rule_sets`	Listar todos os conjuntos de regras de validação
`create_rule_set`	Criar um novo conjunto de regras
`list_attributes`	Listar todas as categorias e valores de atributos
`upsert_attribute`	Adicionar ou atualizar valores de atributos

Cenários de Automação de Alto Impacto

1. Lançamento de Campanha em Tempo Real

Lançando uma promoção relâmpago? Em vez de criar links manualmente para cada canal, diga ao seu agente:

"Usando utm-mind, gere links UTM para nossa campanha 'Summer Sale 2024'. A URL de destino é https://acme.com/summer-sale. Crie links para Google (cpc), Meta (paid_social) e nossos três newsletters por e-mail (newsletter_weekly, newsletter_promo, newsletter_partners)."

O agente chama create_links_batch e gera todos os links em segundos — validados contra suas convenções de nomenclatura antes de serem criados.

2. Sindicância Automatizada de Conteúdo

Ao sindicalizar posts de blog para Medium, DEV.to ou Hacker News:

"Acabei de publicar um novo post em https://acme.com/blog/new-feature. Usando utm-mind, crie links de rastreamento para sindicância no Medium, DEV.to e Hacker News. A campanha é 'new_feature_launch'."

Três links distintos e corretamente etiquetados, prontos para colar. Sem planilha, sem trabalho manual.

3. Teste Dinâmico de Criativos de Anúncios

Executando testes A/B em criativos de anúncios? Automatize a etiquetagem UTM por criativo:

"Usando utm-mind, crie três links UTM para minha campanha do Google Ads 'q4_promo'. A URL base é https://acme.com/landing. Estou testando criativos: 'video_ad_01', 'image_ad_05', 'carousel_ad_03'. Adicione-os em utm_content."

Cada link recebe um valor único de utm_content, para que o GA4 mostre exatamente qual criativo gerou conversões.

4. Governança Proativa de Dados

Use agentes para verificações de qualidade de dados em tempo real antes que os links entrem no ar:

"Usando utm-mind, valide esta URL: https://acme.com?utm_source=google&utm_medium=PPC&utm_campaign=My%20Campaign. Ela viola alguma convenção de nomenclatura?"

O agente chama validate_url e responde:

"2 violações encontradas contra 'GA4 Best Practices': 1. Erro: utm_medium 'PPC' não é válido. Deveria ser 'cpc'. 2. Aviso: utm_campaign 'My Campaign' contém maiúsculas e espaços. Deveria ser 'my_campaign'."

5. Auditoria de Governança Noturna

Agende seu agente para executar uma auditoria noturna:

"Todas as noites à meia-noite, use utm-mind para listar todos os links criados hoje e validar cada um. Envie-me um resumo no Slack de quaisquer violações."

Isso transforma a governança de UTM de uma tarefa reativa em um sistema proativo e automatizado — detectando erros antes que eles se acumulem em semanas de dados ruins.

Limites do Plano e Uso da API

Chamadas de API e MCP estão sujeitas aos limites do seu plano UTM Mind:

Plano	Links/Mês	Acesso à API
Free	100	✅ Incluído
Starter	2.000	✅ Incluído
Pro	20.000	✅ Incluído
Agency / Scale	Ilimitado	✅ Incluído

Quando você excede seu limite mensal de criação de links, a API retorna uma resposta 429 Too Many Requests com detalhes sobre seu uso atual e um link para fazer upgrade.

O Futuro é Automatizado

Ao integrar o UTM Mind ao seu agente de IA, você transforma a governança de UTM de uma tarefa manual e propensa a erros em uma parte automatizada e integrada das suas operações de marketing. Sua equipe se move mais rápido, seus dados ficam mais limpos e você finalmente pode focar na estratégia em vez de planilhas.

Pronto para automatizar? Gere sua chave de API hoje e conecte seu agente em minutos.

🤖

Pronto para Automatizar Seu Fluxo de Trabalho de UTM?

Gere sua chave de API e conecte seu agente de IA ao UTM Mind em menos de 5 minutos.