Como conectar o MCP da Metricool
As capturas de ecrã deste guia estão em inglês.
Este guia explica os métodos disponíveis para conectar o MCP (Metricool Connector Protocol) com diferentes plataformas e ferramentas de IA. O MCP é uma ferramenta inteligente que se integra com a tua conta Metricool para otimizar a gestão das tuas redes sociais, permitindo-te agendar conteúdo com os melhores horários de publicação, oferecer recomendações personalizadas com base nos teus dados, analisar as tuas métricas automaticamente e ajudar-te a poupar tempo enquanto melhoras os teus resultados.
Podes usar o MCP da Metricool com qualquer plano da Metricool, incluindo a conta gratuita. As limitações que se aplicam são as do teu plano atual. Por exemplo, com uma conta gratuita não podes consultar dados com mais de 3 meses nem agendar mais de 20 publicações. Os planos pagos alargam estes limites.
O que precisas antes de começar
Antes de conectar o MCP, certifica-te de que tens o seguinte:
Uma conta Metricool: O MCP funciona com qualquer plano, incluindo a conta gratuita. As limitações do teu plano aplicam-se ao uso do MCP (por exemplo, contas gratuitas não podem consultar dados com mais de 3 meses nem agendar mais de 20 publicações).
Conta ativa na ferramenta que queres conectar (ChatGPT, Make, Zapier, etc.), com acesso a funcionalidades avançadas, como a capacidade de se conectar a fontes externas ou executar ações via URL. 👉 Se tiveres dúvidas sobre os requisitos específicos de cada ferramenta, verifica diretamente com o fornecedor do cliente de IA.
URL de produção do MCP da Metricool:
https://ai.metricool.com/mcp
Recomendamos que revejas a política de privacidade da app que vais conectar antes de autorizar o acesso ao MCP.
Métodos de conexão disponíveis
Método de conexão | Descrição | Ferramentas suportadas |
|---|---|---|
Conexão baseada em URL (HTTP/OAuth) | O método mais comum e simples. | ChatGPT, Make, Zapier, Smithery, Mistral Vibe, Cursor |
Conexão com token no cabeçalho | Método avançado que requer tokens de autenticação em cabeçalhos HTTP. | N8N |
Conexão CLI | Para developers que preferem trabalhar a partir do terminal. | Claude Code, Gemini CLI |
Além disso, podes conectar o Claude Desktop usando mcp-remote.
Se não és um utilizador técnico, recomendamos usar conexões baseadas em URL, porque são as mais fáceis e visuais.
Que permissões o MCP concede
Quando conectas o MCP, a ferramenta de IA poderá aceder aos seguintes dados e funcionalidades da tua conta Metricool:
Ver e gerir as tuas marcas e conexões de redes sociais
Ver e descarregar métricas e Analíticas
Ver, criar e publicar publicações (tanto agendadas como já publicadas)
Estas permissões concedem acesso total à tua conta Metricool, de forma semelhante a iniciares sessão diretamente. Autoriza o MCP apenas em ferramentas em que confies. Podes revogar o acesso a qualquer momento nas definições da tua conta.
Como conectar o MCP da Metricool passo a passo
Para te ajudar a conectar o MCP da Metricool usando o método que melhor se adapta ao teu fluxo de trabalho, as secções seguintes guiam-te por cada passo para todos os clientes suportados — incluindo ChatGPT, Make, Zapier, Smithery, Mistral Vibe, Cursor, N8N, Claude Code e Gemini CLI — quer estejas a usar conexões baseadas em URL, autenticação com token no cabeçalho ou ferramentas de linha de comandos.
ChatGPT
A Metricool está disponível como um conector verificado na secção Apps do ChatGPT. Abre o ChatGPT, vai a Apps, procura Metricool, conecta e autoriza o acesso para tornar o MCP da Metricool disponível nas tuas conversas.
Claude
Podes conectar o MCP da Metricool ao Claude Desktop (via mcp-remote) e ao Claude Code (via a CLI). Cada caminho inclui autorização no browser e uma verificação de que o conector está ativo.
Make
Vai para um novo cenário em Make.com
Adiciona um novo módulo e procura MCP
Cria uma conexão
Adiciona um novo MCP Server e insere o URL da Metricool. Clica em Guardar
Automaticamente, vai abrir uma nova janela para iniciares sessão na Metricool e autorizar o acesso
Agora, podes usar o MCP da Metricool de duas formas: selecionando uma ferramenta e usando-a, ou adicionando a tarefa como prompt, e o MCP fará as ações.
Zapier
Vai a Zapier.com e começa um novo Zap
Adiciona uma nova Action e procura "MCP" e usa "MCP Client"
Vai a Sign In. Adiciona o URL do MCP da Metricool e continua
Inicia sessão na Metricool e autoriza o acesso
Agora, podes usar o MCP da Metricool dentro do Zapier.
Smithery
Vai à página do Smithery (plano gratuito) → https://smithery.ai/playground
Na parte de baixo, na caixa de texto, clica em 'Add tool'.
Introduz o URL na barra de pesquisa e clica em 'Connect to MCP server.
O passo seguinte é conceder ao MCP acesso para usar a tua conta Metricool.
Assim que a conexão for estabelecida, vais conseguir ver as ferramentas disponíveis e tudo ficará pronto para interação.
Mistral Vibe
Conecta o MCP da Metricool no Mistral Vibe adicionando um conector personalizado com OAuth 2.1.
Vai à página do Mistral Vibe (plano gratuito) → Vibe.
Vai a Vibe → Connectors (painel do lado esquerdo) → + Add Connector.
Vais ver conectores em destaque. Para adicionar o conector da Metricool, clica no botão Add connector.
Em Custom MCP Connector, adiciona o seguinte: nome do conector, servidor do conector (URL), descrição (opcional) e o método de autenticação, que é OAuth2.1, depois clica em Connect.
Concede ao MCP acesso para usar a tua conta Metricool.
Na parte de baixo, vais ter os teus conectores disponíveis, prontos a usar numa conversa ou para veres as ferramentas disponíveis.
Cursor
Para poderes adicionar MCPs ao Cursor, precisas da app Cursor Desktop; podes transferi-la aqui: Download.
Depois de iniciares sessão na tua conta Cursor, tens duas opções:
Instalação do MCP da Metricool com link
Copia qualquer uma destas ligações para o teu browser:
Deep link:
cursor://anysphere.cursor-deeplink/mcp/install?name=metricool-mcp&config=eyJ1cmwiOiJodHRwczovL2FpLm1ldHJpY29vbC5jb20vbWNwIiwidHlwZSI6Imh0dHAifQ%3D%3DWeb link: Auth | Cursor - The AI Code Editor
Estas ligações vão abrir a tua app Cursor Desktop e perguntar se queres adicionar o servidor MCP:
Depois de clicares em Install, o servidor MCP vai aparecer no teu separador Installed MCP. No entanto, indica que precisa de autenticação, por isso clica em Connect:
Vai pedir-te para abrires um URL externo no teu browser para autorizar a conexão com a Metricool:
Depois de concederes acesso, a aplicação Cursor vai abrir novamente e o MCP ficará conectado.
Instalação do MCP da Metricool sem link do Cursor
O primeiro passo é clicares na engrenagem de definições no canto superior direito e ires para a secção Tools & MCP:
Assim que entrares na secção, clica em Add Custom MCP para abrir o ficheiro mcp.json:
Originalmente, se nenhum MCP estiver conectado, o ficheiro mcp.json tem a seguinte estrutura:
{ "mcpServers": {} }Para adicionar um servidor MCP, neste caso o da Metricool, precisas de inserir o seguinte trecho de código dentro de mcpServers:
"metricool-mcp": { "url": "https://ai.metricool.com/mcp", "type": "http" }O resultado final deve ser o seguinte:
{ "mcpServers": { "metricool-mcp": { "url": "https://ai.metricool.com/mcp", "type": "http" } } }Lembra-te de guardar o ficheiro clicando em Files > Save.
De volta à secção Tools & MCP, o MCP deve aparecer como não autenticado, por isso segue o mesmo processo clicando em Connect:
Vai pedir-te para abrires um URL externo no teu browser para autorizar a conexão com a Metricool:
Depois de concederes acesso, a aplicação Cursor vai abrir novamente e o MCP ficará conectado.
N8N
Vai ao N8N e cria um novo workflow
Adiciona um novo nó AI Agent
3. Dentro das ferramentas do AI Agent, procura MCP Client Tool
4. Adiciona o URL da Metricool no campo endpoint
5. Seleciona em Authentication → Header Auth
Cria uma nova credencial.
Adiciona o Name → X-Mc-Auth
E o value → A tua API Key da Metricool (podes encontrar em your account settings)
Guarda a Credential e vais ter algo como isto
10. Agora podes usar o MCP da Metricool dentro do N8N
Embora o seu uso esteja mais focado em tarefas específicas e num público mais especializado, também existem clientes de linha de comandos capazes de usar o MCP da Metricool.
Gemini CLI
Para transferires o Gemini CLI, precisas de abrir um terminal e executar o seguinte comando:
npm install -g @google/gemini-cliDepois de instalado, precisas de aceder ao ficheiro de configuração, localizado num dos seguintes caminhos:
/etc/gemini-cli/system-defaults.json(Linux)C:\ProgramData\gemini-cli\system-defaults.json(Windows)/Library/Application Support/GeminiCli/system-defaults.json(macOS).
O caminho pode ser substituído usando a variável de ambienteGEMINI_CLI_SYSTEM_DEFAULTS_PATH.
No ficheiro de configuração, adiciona este trecho de código:
{
"mcpServers": {
"metricool": {
"httpUrl": "https://ai.metricool.com/mcp"
}
},
"security": {
"auth": {
"selectedType": "oauth-personal"
}
}
}Guarda o ficheiro e abre um terminal Gemini CLI com o comando
gemini. Executa o seguinte comando:
/mcp auth metricoolVai abrir um separador do browser a pedir autorização:
Depois de concederes acesso, podes voltar ao teu terminal e o MCP ficará conectado.
Artigos relacionados