O MCP do Matomo conecta assistentes de IA aos dados de analytics de acesso das aplicações da plataforma, hospedados no Matomo do Embrapa I/O. Diferentemente dos demais MCPs da plataforma (desenvolvidos internamente), este utiliza o plugin oficial MCP Server da Matomo, mantido pela própria Matomo, permitindo perguntar em linguagem natural sobre tráfego, origens de visitas, páginas mais acessadas, campanhas e comportamento dos usuários — sem precisar navegar pelos relatórios.

O servidor atua como uma camada de mediação: aceita as requisições via MCP, encaminha à API de Analytics do Matomo e retorna os dados de forma estruturada. Toda interpretação é feita pelo LLM — o Matomo não gera, analisa nem treina modelos com os dados. O acesso é limitado aos mesmos sites e relatórios que o usuário já enxerga no Matomo.

Conectar

A URL de conexão do MCP Server é:

mcp.hit.embrapa.io

A autenticação é feita via OAuth 2.0 com PKCE (plugin OAuth2 do Matomo). Ao conectar, o fluxo de login abre automaticamente no browser para autenticação com a conta do Matomo da plataforma (hit.embrapa.io), seguida da tela de autorização do cliente.

Atenção! Por restrição do próprio MCP do Matomo, apenas contas com nível de acesso até Escrita (View ou Write) podem conectar. Superusuários não conseguem utilizar o MCP — quem for superusuário precisa usar uma conta secundária de menor privilégio.

Funcionalidades

O servidor é orientado a leitura (read-oriented) e expõe tools em torno dos seguintes domínios de analytics:

Sites — Listagem dos sites (aplicações) que o usuário pode acessar no Matomo, com seus identificadores (idSite) para uso nas demais consultas.

Relatórios — Descoberta dos relatórios disponíveis e seus metadados, e obtenção dos dados processados de qualquer relatório (visitas, páginas, origens de tráfego, dispositivos, localização, etc.), com período e segmentação configuráveis.

Metas (Goals) — Consulta das metas de conversão configuradas e seus resultados.

Segmentos (Segments) — Consulta dos segmentos definidos para filtrar os dados de analytics.

Dimensões (Dimensions) — Consulta das dimensões customizadas disponíveis para análise.

Nota! O acesso à API crua do Matomo (descoberta e execução genérica de métodos, incluindo operações de escrita) é um recurso separado e desativado por padrão — não está habilitado nesta instância. O escopo da conexão também é limitado a nível de leitura (scope matomo:read).

Exemplos de Prompts

Abaixo, exemplos do que pode ser solicitado em linguagem natural a um assistente de IA conectado a este MCP:

Quais foram as fontes de tráfego com mais visitas no site da minha aplicação
no último mês?

Quais páginas tiveram mais acessos ontem no site de ID 42?

Como está a tendência de acessos via dispositivos móveis neste mês
em relação ao anterior?

Liste os 10 países que mais geraram visitas à minha aplicação nos últimos 90 dias.

Qual campanha trouxe a maior taxa de conversão no último trimestre?

Gere um resumo executivo do desempenho de acessos da minha aplicação
nas últimas 4 semanas: visitas, visitantes únicos, páginas mais vistas
e principais origens.

Configuração em IDEs e CLIs

A configuração segue o mesmo padrão unificado descrito em Configuração em IDEs e CLIs. Basta usar a URL https://mcp.hit.embrapa.io. Exemplo no Claude Code:

claude mcp add --scope user --transport http matomo https://mcp.hit.embrapa.io

Dica! Ao configurar o conector no Claude Desktop/Web, ele fica disponível automaticamente no Claude Code.

Referência Técnica

A superfície de tools do plugin oficial é orientada a leitura e pode evoluir entre versões. Os domínios cobertos no momento:

Domínio Descrição
Sites Listagem dos sites/aplicações acessíveis ao usuário (com idSite).
Reports Descoberta de relatórios e metadados, e obtenção dos dados processados (matomo_report_processed) — visitas, páginas, origens, dispositivos, localização, etc.
Goals Metas de conversão configuradas e seus resultados.
Segments Segmentos definidos para filtragem dos dados.
Dimensions Dimensões (inclusive customizadas) disponíveis para análise.
API crua (desativada) matomo_api_list / matomo_api_get e execução genérica de métodos — recurso opcional, desabilitado por padrão e não ativo nesta instância.

Nota! Para a referência completa e sempre atualizada das tools, parâmetros e comportamento, consulte a documentação oficial da Matomo (links abaixo).

Documentação oficial (Matomo)