Como conectar o MCP da Metricool
Atualizado há 2 semanas
As capturas de ecrã neste guia estão em inglês.
Conecta o servidor MCP (Model Context Protocol) da Metricool para que um cliente de IA possa ler e agir na tua conta da Metricool. Usa a URL de produção https://ai.metricool.com/mcp, escolhe o método de conexão para o teu cliente e, depois, autoriza o acesso.
Para saber quais limites do plano continuam a aplicar-se depois da conexão, consulta Limites do MCP e requisitos do plano. Se o servidor não se conectar, vê Não consigo me conectar ao Metricool MCP.
Antes de começar
Tenha isto pronto antes de adicionar o conector:
Uma conta Metricool em qualquer plano, incluindo Free. Os limites do teu plano continuam a aplicar-se ao uso do MCP.
Uma conta no cliente de IA ou ferramenta de automação que queres conectar, com permissão para adicionar conectores MCP externos ou ferramentas baseadas em URL. Os requisitos específicos de cada cliente (por exemplo Claude Code Pro/Max ou Cursor Desktop) estão listados em Limites do MCP e requisitos do plano.
URL de produção do MCP:
https://ai.metricool.com/mcp
Revê a política de privacidade da app que vais conectar antes de autorizar o acesso à tua conta Metricool.
Métodos de conexão disponíveis
Corresponde o teu cliente a um método de conexão. Usar o método errado é uma das razões mais comuns para o servidor nunca acabar de se conectar.
Método de conexão | Descrição | Ferramentas suportadas |
|---|---|---|
Baseado em URL (HTTP/OAuth) | Cola a URL do MCP e depois inicia sessão na Metricool e concede acesso. | ChatGPT, Make, Zapier, Smithery, Mistral Vibe, Cursor, TypingMind |
Header token | Autentica com um token de header no cliente. | N8N |
CLI | Adiciona o servidor a partir do terminal e, depois, autentica quando for pedido. | Claude Code, Gemini CLI |
mcp-remote | Executa a Metricool através de | Claude Desktop |
Se não estiveres a trabalhar a partir de um terminal, começa por um cliente baseado em URL (HTTP/OAuth).
Que permissões o MCP concede
Quando conectas o MCP, a ferramenta de IA pode aceder a estas partes da tua conta Metricool dentro dos limites do teu plano:
Ver e gerir marcas e conexões de redes sociais
Ver e descarregar métricas e Analíticas
Ver, criar e publicar publicações (agendadas e já publicadas)
Estas permissões concedem acesso total, semelhante a iniciar sessão diretamente. Autoriza apenas ferramentas em que confies. Revoga o acesso no cliente de IA ou na plataforma onde conectaste a Metricool.
Escolhe o teu cliente
ChatGPT e Claude têm guias de configuração dedicados. Usa as secções abaixo para os outros clientes suportados.
Como conectar o MCP da Metricool com o Claude (Claude Desktop e Claude Code)
Make
Vai para um novo cenário em Make.com.
Adiciona um novo módulo e procura por MCP.
Cria uma conexão.
Adiciona um novo servidor MCP, insere a URL da Metricool
https://ai.metricool.com/mcpe clica em Guardar.
Inicia sessão na Metricool na janela do navegador que se abre e concede acesso.
Usa o Metricool MCP no cenário selecionando uma ferramenta ou descrevendo a tarefa num prompt.
Zapier
Vai para Zapier.com e começa um novo Zap.
Adiciona uma nova Action, procura por MCP e escolhe MCP Client.
Abre Sign In, adiciona a URL do MCP da Metricool e continua.
Inicia sessão na Metricool e concede acesso.
Usa o Metricool MCP dentro do Zap.
Smithery
Abre o playground da Smithery: https://smithery.ai/playground.
Na parte inferior, na caixa de texto, clica em Adicionar ferramenta.
Insere a URL do MCP da Metricool na barra de pesquisa e clica em Connect to MCP server.
Concede ao MCP acesso à tua conta Metricool.
Quando a conexão é estabelecida, as ferramentas disponíveis aparecem e o servidor fica pronto a usar.
Mistral Vibe
Conecta o MCP da Metricool no Mistral Vibe adicionando um conector personalizado com OAuth 2.1.
Abre Mistral Vibe.
Vai para Connectors no painel da esquerda e depois clica em + Add Connector.
Na página de conectores em destaque, clica em Add connector.
Em Custom MCP Connector, insere um nome para o conector, a URL do servidor do conector
https://ai.metricool.com/mcp, uma descrição opcional e o método de autenticação OAuth2.1 e, depois, clica em Connect.
Concede ao MCP acesso à tua conta Metricool.
A Metricool aparece nos teus conectores disponíveis para conversar ou ver ferramentas.
Cursor
A configuração do Cursor MCP requer a app Cursor Desktop. Depois de iniciares sessão, usa um dos caminhos de instalação abaixo.
Instalar com um link do Cursor
Abre um destes links no teu navegador:
Deep link:
cursor://anysphere.cursor-deeplink/mcp/install?name=metricool-mcp&config=eyJ1cmwiOiJodHRwczovL2FpLm1ldHJpY29vbC5jb20vbWNwIiwidHlwZSI6Imh0dHAifQ%3D%3DWeb link: Instalar Metricool MCP no Cursor
O Cursor Desktop abre e pergunta se queres adicionar o servidor MCP.
Clica em Install. No separador Installed MCP, o servidor aparece e precisa de autenticação — clica em Connect.
Autoriza a Metricool no navegador quando for pedido.
Volta para o Cursor. O Metricool MCP está conectado.
Instalar sem um link do Cursor
Abre a engrenagem de definições no canto superior direito e depois vai para Tools & MCP.
Clica em Add Custom MCP para abrir o ficheiro
mcp.json.
Se ainda não houver nenhum MCP conectado, o ficheiro fica assim:
{ "mcpServers": {} }Adiciona a Metricool dentro de
mcpServers:"metricool-mcp": { "url": "https://ai.metricool.com/mcp", "type": "http" }O ficheiro completo deve ficar assim:
{ "mcpServers": { "metricool-mcp": { "url": "https://ai.metricool.com/mcp", "type": "http" } } }Guarda o ficheiro (Files > Save).
Em Tools & MCP, a Metricool aparece como não autenticada. Clica em Connect.
Autoriza a Metricool no navegador quando for pedido.
Volta para o Cursor. O Metricool MCP está conectado.
TypingMind
Conecta o MCP da Metricool no TypingMind com OAuth baseado em URL. Não é necessário token nem instalar um servidor local, e isto funciona em qualquer plano da Metricool, incluindo Free.
No TypingMind, não uses a secção MCP da barra lateral para a Metricool. Essa área é para servidores MCP locais ou de debug que tu próprio executas. Conecta a Metricool a partir de Settings → Advanced Settings → Model Context Protocol (ou Plugins → MCP Connectors, dependendo do teu layout no TypingMind).
No TypingMind, vai para Settings → Advanced Settings → Model Context Protocol → Add custom connector.
No campo URL, insere
https://ai.metricool.com/mcp.Clica em Connect.
Na primeira vez, escolhe TypingMind Cloud quando te perguntarem que conector usar.
Autoriza com o teu login da Metricool no navegador e aceita o acesso.
Se só vires uma opção de conexão baseada em token, esse caminho usa a API da Metricool e requer Advanced. Prefere o método OAuth por URL acima nos planos Free e restantes. Vê Acesso MCP vs API: qual é a diferença?.
N8N
O N8N usa autenticação por header token, e não o fluxo OAuth apenas por URL usado pela maioria dos outros clientes.
No N8N, cria um novo workflow.
Adiciona um nó AI Agent.
Nas ferramentas do AI Agent, procura por MCP Client Tool.
Define o endpoint para
https://ai.metricool.com/mcp.Define Authentication para Header Auth.
Cria uma nova credencial.
Define o nome do header como X-Mc-Auth.
Define o valor como a tua chave API da Metricool em Account Settings > API.
Guarda a credencial.
Usa o Metricool MCP dentro do workflow do N8N.
Gemini CLI
Instala o Gemini CLI a partir de um terminal:
npm install -g @google/gemini-cliAbre o ficheiro de configuração num destes caminhos (ou no caminho definido por
GEMINI_CLI_SYSTEM_DEFAULTS_PATH):/etc/gemini-cli/system-defaults.json(Linux)C:\ProgramData\gemini-cli\system-defaults.json(Windows)/Library/Application Support/GeminiCli/system-defaults.json(macOS)
Adiciona esta configuração:
{ "mcpServers": { "metricool": { "httpUrl": "https://ai.metricool.com/mcp" } }, "security": { "auth": { "selectedType": "oauth-personal" } } }Guarda o ficheiro, inicia o Gemini CLI com
geminie depois executa:/mcp auth metricoolAutoriza a Metricool no separador do navegador que se abre.
Volta para o terminal. O Metricool MCP está conectado.
Artigos relacionados