Instale e configure o Metricool MCP no Claude Desktop
Instalação e configuração do MCP no Claude Desktop
🎬 Vídeo tutorial disponível em inglês e espanhol.
Segue estes passos para integrares o Metricool na aplicação Claude Desktop.
⚠️ Nota que os passos podem variar ligeiramente consoante a versão do Claude Desktop que estiveres a utilizar.
Passo 1: Descarregar o Claude Desktop e aceder ao repositório da Metricool
Descarrega o Claude Desktop: Vai a claude.ai/download e descarrega a versão compatível com o teu sistema operativo.
Acede ao repositório MCP da Metricool: Abre https://github.com/metricool/mcp-metricool
Clica no link UV: Desce até à secção UV e clica.
Copia o comando de instalação: No novo separador, vais ver uma secção chamada Installing uv. Copia a primeira linha do comando consoante o teu sistema operativo.
Passo 2: Instalar o MCP da Metricool
Abre o terminal do teu sistema operativo
macOS: abre a aplicação Terminal via Launchpad
Windows: abre CMD ou o Prompt de Comando
Cola e executa o comando: Cola o comando que copiaste e carrega em Enter
Fecha o terminal: Quando vires a mensagem de instalação concluída, podes fechar a janela
Passo 3: Configurar o Claude Desktop
Para garantires que estás a usar a versão mais recente, adiciona este código no teu ficheiro claude_desktop_config.json:
{
"mcpServers": {
"mcp-metricool": {
"command": "uvx",
"args": [
"--upgrade",
"mcp-metricool"
],
"env": {
"METRICOOL_USER_TOKEN": "<METRICOOL_USER_TOKEN>",
"METRICOOL_USER_ID": "<METRICOOL_USER_ID>"
}
}
}
}Copie o código de configuração.
Abre a configuração do Claude Desktop:
Inicie o seu aplicativo Claude Desktop (você deve ter a versão Pro).
Aceda a Definições.
Selecione Desenvolvedor.
Clique em Editar configuração. Isto abrirá o ficheiro de configuração do Claude Desktop.
Cole o código de configuração: cole o código que você copiou no arquivo de configuração aberto.
Actualize as suas credenciais Metri: No código que colou, terá de encontrar e substituir os marcadores de posição pelo seu Token de utilizador Metricool e ID de utilizador. Certifique-se de que insere as credenciais corretas.
Guarde as suas alterações: Guarde o ficheiro de configuração.
Passo 4: Reiniciar o Claude Desktop e resolver erros (se necessário)
Reinicia a aplicação Claude Desktop
Tratamento de erros de ligação: Se, ao reiniciar, receber um erro do tipo “não foi possível ligar ao servidor MCP” ou semelhante, siga estes passos:
Vai novamente a Settings > Developer > Edit configuration
Abre o ficheiro
cloud/desktop/config.jsonExecuta novamente o comando UV para o teu sistema
Copia a nova linha gerada (a verde)
Substitui a linha antiga por esta nova
Verifica se termina com uma barra
/Guarda e volta a abrir a aplicação
Passo 5: Verificar a instalação
Depois de reiniciar a app, o MCP deverá estar a funcionar corretamente.
Agora já podes começar a usar: pesquisar marcas, agendar conteúdo ou analisar os teus dados no Claude Desktop com a integração da Metricool.