Metricool MCP

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.

Ver o guia completo →

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.

Ver o guia completo →

Make

  1. Vai para um novo cenário em Make.com

  2. Adiciona um novo módulo e procura MCP

  1. Cria uma conexão

  1. Adiciona um novo MCP Server e insere o URL da Metricool. Clica em Guardar

  1. Automaticamente, vai abrir uma nova janela para iniciares sessão na Metricool e autorizar o acesso

  2. 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

  1. Vai a Zapier.com e começa um novo Zap

  2. Adiciona uma nova Action e procura "MCP" e usa "MCP Client"

  1. Vai a Sign In. Adiciona o URL do MCP da Metricool e continua

  1. Inicia sessão na Metricool e autoriza o acesso

  2. Agora, podes usar o MCP da Metricool dentro do Zapier.

Smithery

  1. Vai à página do Smithery (plano gratuito) → https://smithery.ai/playground

  2. Na parte de baixo, na caixa de texto, clica em 'Add tool'.

  1. Introduz o URL na barra de pesquisa e clica em 'Connect to MCP server.

  1. O passo seguinte é conceder ao MCP acesso para usar a tua conta Metricool.

  2. 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.

  1. Vai à página do Mistral Vibe (plano gratuito) → Vibe.

  2. Vai a Vibe → Connectors (painel do lado esquerdo) → + Add Connector.

    Painel do lado esquerdo do Mistral Vibe com Connectors sob Intelligence
  3. Vais ver conectores em destaque. Para adicionar o conector da Metricool, clica no botão Add connector.

    Página de Featured Connectors com botão Add Connector
  4. 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.

    Formulário de Custom MCP Connector com URL do servidor Metricool e autenticação OAuth2.1
  5. Concede ao MCP acesso para usar a tua conta Metricool.

  6. Na parte de baixo, vais ter os teus conectores disponíveis, prontos a usar numa conversa ou para veres as ferramentas disponíveis.

    Lista de conectores disponíveis mostrando a Metricool como Connected
    Detalhe do conector da Metricool com estado Connected

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:

  1. Copia qualquer uma destas ligações para o teu browser:

    Deep link:

    cursor://anysphere.cursor-deeplink/mcp/install?name=metricool-mcp&config=eyJ1cmwiOiJodHRwczovL2FpLm1ldHJpY29vbC5jb20vbWNwIiwidHlwZSI6Imh0dHAifQ%3D%3D

    Web link: Auth | Cursor - The AI Code Editor

  2. Estas ligações vão abrir a tua app Cursor Desktop e perguntar se queres adicionar o servidor MCP:

  3. 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:

  4. Vai pedir-te para abrires um URL externo no teu browser para autorizar a conexão com a Metricool:

  5. Depois de concederes acesso, a aplicação Cursor vai abrir novamente e o MCP ficará conectado.

  1. O primeiro passo é clicares na engrenagem de definições no canto superior direito e ires para a secção Tools & MCP:

  2. 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.

  3. De volta à secção Tools & MCP, o MCP deve aparecer como não autenticado, por isso segue o mesmo processo clicando em Connect:

  4. Vai pedir-te para abrires um URL externo no teu browser para autorizar a conexão com a Metricool:

  5. Depois de concederes acesso, a aplicação Cursor vai abrir novamente e o MCP ficará conectado.

N8N

  1. Vai ao N8N e cria um novo workflow

  2. 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

  1. Cria uma nova credencial.

  2. Adiciona o Name → X-Mc-Auth

  3. E o value → A tua API Key da Metricool (podes encontrar em your account settings)

  1. 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

  1. Para transferires o Gemini CLI, precisas de abrir um terminal e executar o seguinte comando:

npm install -g @google/gemini-cli
  1. Depois 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 ambiente GEMINI_CLI_SYSTEM_DEFAULTS_PATH.

  1. No ficheiro de configuração, adiciona este trecho de código:

{
  "mcpServers": {
    "metricool": {
      "httpUrl": "https://ai.metricool.com/mcp"
    }
  },
  "security": {
    "auth": {
      "selectedType": "oauth-personal"
    }
  }
}
  1. Guarda o ficheiro e abre um terminal Gemini CLI com o comando gemini. Executa o seguinte comando:

/mcp auth metricool
  1. Vai abrir um separador do browser a pedir autorização:

  1. Depois de concederes acesso, podes voltar ao teu terminal e o MCP ficará conectado.


Artigos relacionados

Isso foi útil?