Instale e configure o Metricool MCP no Claude Desktop
Instalação e configuração do MCP no Claude Desktop
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.json
- Executa 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.
Actualizado em: 30/07/2025
Obrigado!