Servidor Microsoft Clarity MCP

O que faz o Servidor “Microsoft Clarity” MCP?

O Servidor Microsoft Clarity MCP é um servidor Model Context Protocol (MCP) projetado para interface com a API de exportação de dados do Microsoft Clarity. Ele atua como uma ponte entre assistentes de IA (como o Claude for Desktop e outros clientes compatíveis com MCP) e o serviço de análise Clarity. Ao expor os dados de análise do Clarity via protocolo padrão, esse servidor permite fluxos de trabalho baseados em IA, como consulta de análises do site, filtragem por dimensões específicas (por exemplo, Navegador, Dispositivo, País/Região) e recuperação de diversas métricas web (por exemplo, Profundidade de Rolagem, Tempo de Engajamento, Tráfego). Essa integração simplifica tarefas como monitoramento de desempenho do site e análise de engajamento de usuários, permitindo que desenvolvedores e analistas acessem insights acionáveis diretamente por suas ferramentas de IA.

Lista de Prompts

Nenhum template de prompt explícito foi mencionado nas informações fornecidas.

Lista de Recursos

Nenhum “recurso” MCP específico é descrito no conteúdo do repositório.

Lista de Ferramentas

• get-clarity-data
  Fornece acesso aos dados de análise do Clarity. Permite consultas especificando o número de dias (1-3), selecionando até três dimensões (como Navegador, Dispositivo, País/Região) e escolhendo métricas (como Profundidade de Rolagem, Tempo de Engajamento, Tráfego). Requer um token de API do Clarity.

Casos de Uso deste Servidor MCP

• Recuperação de Análise de Sites
  Busque instantaneamente dados analíticos importantes do Microsoft Clarity, como sessões de usuários, engajamento e profundidade de rolagem, para monitorar o desempenho do site diretamente pelo seu assistente de IA.
• Filtragem Analítica Personalizada
  Filtre resultados de análise por até três dimensões (por exemplo, tipo de dispositivo, região geográfica, navegador) para focar em segmentos de usuários específicos para análises direcionadas.
• Relatórios Automatizados
  Gere e recupere relatórios diários ou de múltiplos dias de análise de um site, agilizando tarefas regulares de relatório para gerentes de produto ou analistas.
• Integração com Fluxos de IA
  Incorpore perfeitamente a análise de sites em fluxos de trabalho de IA maiores, permitindo que agentes obtenham estatísticas de uso e tomem decisões ou acionem ações baseadas em dados em tempo real.

Como configurar

Windsurf

1. Certifique-se de que o Node.js v16 ou superior está instalado.
2. Obtenha seu token de API do Microsoft Clarity.
3. Abra o arquivo de configuração MCP do Windsurf.
4. Adicione a configuração do Servidor Microsoft Clarity MCP conforme mostrado abaixo.
5. Salve a configuração e reinicie o Windsurf.

{
  "mcpServers": {
    "@microsoft/clarity-mcp-server": {
      "command": "npx",
      "args": [
        "@microsoft/clarity-mcp-server",
        "--clarity_api_token=your-api-token-here"
      ]
    }
  }
}

Protegendo as Chaves de API:

{
  "mcpServers": {
    "@microsoft/clarity-mcp-server": {
      "command": "npx",
      "args": [
        "@microsoft/clarity-mcp-server"
      ],
      "env": {
        "CLARITY_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Claude

1. Instale o Node.js v16 ou superior.
2. Gere seu token de API do Clarity.
3. Abra a configuração do Claude for Desktop:
   • Windows: %AppData%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
4. Adicione a configuração do servidor MCP.
5. Salve e reinicie o Claude for Desktop.

{
  "mcpServers": {
    "@microsoft/clarity-mcp-server": {
      "command": "npx",
      "args": [
        "@microsoft/clarity-mcp-server",
        "--clarity_api_token=your-api-token-here"
      ]
    }
  }
}

Protegendo as Chaves de API:

{
  "mcpServers": {
    "@microsoft/clarity-mcp-server": {
      "command": "npx",
      "args": [
        "@microsoft/clarity-mcp-server"
      ],
      "env": {
        "CLARITY_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Cursor

1. Confirme que o Node.js v16+ está disponível.
2. Obtenha seu token de API do Clarity no painel do Clarity.
3. Localize a configuração MCP do Cursor.
4. Adicione a configuração do servidor conforme mostrado.
5. Salve as alterações e reinicie o Cursor.

{
  "mcpServers": {
    "@microsoft/clarity-mcp-server": {
      "command": "npx",
      "args": [
        "@microsoft/clarity-mcp-server",
        "--clarity_api_token=your-api-token-here"
      ]
    }
  }
}

Protegendo as Chaves de API:

{
  "mcpServers": {
    "@microsoft/clarity-mcp-server": {
      "command": "npx",
      "args": [
        "@microsoft/clarity-mcp-server"
      ],
      "env": {
        "CLARITY_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Cline

1. Instale o Node.js v16 ou superior.
2. Obtenha seu token de API do Clarity.
3. Abra o arquivo de configuração MCP do Cline.
4. Insira a seguinte configuração do servidor MCP.
5. Salve e reinicie o Cline.

{
  "mcpServers": {
    "@microsoft/clarity-mcp-server": {
      "command": "npx",
      "args": [
        "@microsoft/clarity-mcp-server",
        "--clarity_api_token=your-api-token-here"
      ]
    }
  }
}

Protegendo as Chaves de API:

{
  "mcpServers": {
    "@microsoft/clarity-mcp-server": {
      "command": "npx",
      "args": [
        "@microsoft/clarity-mcp-server"
      ],
      "env": {
        "CLARITY_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Como usar este MCP em fluxos

Usando MCP no FlowHunt

Para integrar servidores MCP ao seu fluxo de trabalho do FlowHunt, comece adicionando o componente MCP ao seu fluxo e conectando-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração MCP do sistema, insira os detalhes do seu servidor MCP usando este formato JSON:

{
  "clarity-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Uma vez configurado, o agente de IA poderá usar este MCP como uma ferramenta com acesso a todas as suas funções e capacidades. Lembre-se de alterar “clarity-mcp” para o nome real do seu servidor MCP (por exemplo, “clarity-mcp”) e substituir a URL pela URL do seu próprio servidor MCP.

Visão Geral

Com base no exposto, o Servidor Microsoft Clarity MCP fornece uma integração clara e direta com a API de análise do Clarity, mas é focado e um tanto mínimo em escopo. Ele cobre as etapas essenciais de configuração e uso, mas não possui recursos MCP avançados como templates de prompt, recursos MCP adicionais, roots e amostragem.

Pontuação MCP

Nossa opinião:
Este servidor MCP é funcional, bem documentado para configuração e expõe uma ferramenta útil para integração de análise. No entanto, falta recursos MCP mais ricos, como templates de prompt, exposição de recursos ou capacidades avançadas como amostragem e roots — tornando-o mais utilitário do que completo. Ele recebe uma nota 5/10 por cobrir o básico com clareza, mas sem explorar todo o potencial do protocolo MCP.