Metricool MCP

Como conectar o MCP da Metricool

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 agendar conteúdos nos melhores horários de publicação, oferecer recomendações personalizadas com base nos teus dados, analisar automaticamente as tuas métricas e ajudar-te a poupar tempo enquanto melhora os teus resultados.

Podes usar o MCP da Metricool com qualquer plano da Metricool, incluindo a conta gratuita. As limitações aplicáveis 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 ampliam estes limites.

O que precisas antes de começar

Antes de conectar o MCP, garante 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 ex., 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 ligar a fontes externas ou executar ações via URL. 👉 Se tiveres dúvidas sobre os requisitos específicos de cada ferramenta, confirma 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 compatíveis

Conexão baseada em URL (HTTP/OAuth)

O método mais comum e simples.

ChatGPT, Make, Zapier, Smithery, Mistral Chat, Cursor

Conexão com token no cabeçalho

Método avançado que requer tokens de autenticação nos 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 tens conhecimentos técnicos, recomendamos usar conexões baseadas em URL, já que são as mais fáceis e visuais.

Que permissões o MCP concede

Quando conectas o MCP, a ferramenta de IA vai 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 análises

  • Ver, criar e publicar publicações (tanto agendadas como já publicadas)

Estas permissões dão 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 mostram-te cada passo para todos os clientes compatíveis — incluindo ChatGPT, Make, Zapier, Smithery, Mistral Chat, 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 comando.

ChatGPT

  1. Vai à página do ChatGPT → ChatGPT . Para poderes adicionar conectores no ChatGPT, é necessário ter uma conta de developer.

  2. Para conectar no ChatGPT, tens de clicar no ícone do perfil e das definições.

  1. Uma vez em Definições, vai a Apps & Connectors > Definições avançadas e ativa o Modo de developer:

  1. Com o Modo de developer ativado, em Apps & Connectors, clica no botão 'Create' (canto superior direito) e adiciona a configuração do MCP.

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

  2. O MCP da Metricool vai ficar agora disponível no chat com as ferramentas correspondentes.

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 a URL da Metricool. Clica em Save

  1. Automaticamente, vai abrir-se 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 cria um novo Zap

  2. Adiciona uma nova Action, pesquisa “MCP” e usa “MCP Client”

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

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

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

Smithery

  1. Vai para a página da Smithery (plano gratuito) → https://smithery.ai/playground

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

  1. Introduz a 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 ficará pronto para interação.

Mistral chat

  1. Vai para a página do Mistral chat (plano gratuito) → Le Chat

  2. No painel esquerdo, vai a Intelligence e Connectors.

  1. Vais ver conectores em destaque. Para adicionar o conector da Metricool, tens de clicar no botão 'Add connector'.

  1. Em 'Personalized MCP connector' vais precisar de adicionar 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'.

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

  2. Na parte inferior, vais ter os teus conectores disponíveis, prontos a usar num chat ou para veres as ferramentas disponíveis.

Cursor

Para poderes adicionar MCPs ao Cursor, precisas da app Cursor Desktop; podes descarregá-la aqui: Download.

Depois de entrares na tua conta Cursor, tens duas opções:

  1. Copia qualquer um destes links para o teu navegador:

    Deep link:

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

    Web link: Auth | Cursor - The AI Code Editor

  2. Estes links 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, mostra que precisa de autenticação, por isso clica em Connect:

4. Vai pedir-te para abrir um URL externo no teu navegador para autorizar a ligação com a Metricool:

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

  1. Copia qualquer um destes links para o teu navegador: Deep link: cursor://anysphere.cursor-deeplink/mcp/install?name=metricool-mcp&config=eyJ1cmwiOiJodHRwczovL2FpLm1ldHJpY29vbC5jb20vbWNwIiwidHlwZSI6Imh0dHAifQ%3D%3D Web link: Auth | Cursor - The AI Code Editor

  2. Estes links 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, mostra que precisa de autenticação, por isso clica em Connect:

4. Vai pedir-te para abrir um URL externo no teu navegador para autorizar a ligação com a Metricool:

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

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

2. Uma vez dentro da secção, clica em Add Custom MCP para abrir o ficheiro mcp.json:

3. Originalmente, se não houver nenhum MCP ligado, o ficheiro mcp.json tem a seguinte estrutura:`

{
  "mcpServers": {}
}

Para adicionar um servidor MCP, neste caso o da Metricool, precisas de inserir o seguinte excerto 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.

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


5. Vai pedir-te para abrir um URL externo no teu navegador para autorizar a ligação com a Metricool:

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

N8N

  1. Vai a 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 a URL da Metricool ao campo endpoint
5. Seleciona em Authentication → Header Auth

  1. Cria uma nova credential.

  2. Adiciona o Name → X-Mc-Auth

  3. E o value → A tua API Key da Metricool (podes encontrar nas definições da tua conta)

  1. Guarda a Credential e vais ficar com algo deste género


10. Agora já 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 comando capazes de usar o MCP da Metricool.

Claude Code

  1. Para usar o Claude Code, precisas de uma subscrição Pro ou Max e tens de instalá-lo a partir deste site Claude Code | Claude .

  2. Depois de o instalares, precisas de escrever o seguinte comando no terminal onde o vais usar:

    claude mcp add --transport http metricool https://ai.metricool.com/mcp

  3. Inicia o Claude Code introduzindo o comando claude:

  1. Introduz o comando /mcp no Claude Code para veres os teus MCPs ativos e selecionares o da Metricool. Quando carregares em Enter, vai mostrar que é necessária autenticação para ligar. Carrega em 1 ou Enter para autenticar:

  1. Vai abrir-se um separador no navegador a pedir autorização:

  2. Quando clicares em Grant access, vai aparecer uma mensagem a indicar que correu tudo bem e que já podes voltar ao Claude Code:

  1. O MCP ficará ligado:

Gemini CLI

  1. Para descarregar o Gemini CLI, precisas de abrir um terminal e correr 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 excerto de código:

{
  "mcpServers": {
    "metricool": {
      "httpUrl": "https://ai.metricool.com/mcp"
    }
  },
  "security": {
    "auth": {
      "selectedType": "oauth-personal"
    }
  }
}

  1. Guarda o ficheiro e abre um terminal do Gemini CLI com o comando gemini. Executa o seguinte comando:

/mcp auth metricool

  1. Vai abrir-se um separador no navegador a pedir autorização:

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

Claude Desktop

Devido a um bug externo que não permite aos utilizadores conectar o Claude Desktop ao MCP da Metricool da forma habitual, existe uma solução alternativa usando mcp-remote.

  1. Primeiro, abre o separador Settings clicando no teu perfil:

  1. No separador de definições, clica no botão Developer e depois clica no botão Edit config em Local MCP servers para abrir o documento claude_desktop_config:

  1. Adiciona o seguinte código ao documento:

{
  "mcpServers": {
    "metricool-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://ai.metricool.com/mcp"
      ]
    }
  }
}

Se quiseres obter acesso através de uma API key em vez de autorizar a aplicação, adiciona antes o seguinte código:

{
  "mcpServers": {
    "metricool-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://ai.metricool.com/mcp",
        "--header",
        "X-Mc-Auth: "<METRICOOL_API_KEY>""
      ]
    }
  }
}

  1. Guarda o documento no teu computador e reinicia o Claude Desktop.

  2. Depois de abrir a aplicação novamente, se incluíste o primeiro excerto de código, vai abrir-se um separador no navegador a pedir autorização:

Se usaste o método da API key, este separador não vai aparecer porque já estás autenticado.

  1. Depois de concederes acesso, podes iniciar um chat e confirmar em Connectors que o MCP está ligado:

Isso foi útil?