Não consigo conectar ao Metricool MCP

O Claude Desktop tem um bug externo documentado que bloqueia o caminho usual de conexão MCP. Em vez disso, use mcp-remote.

1. No Claude Desktop, abre Configurações no seu perfil.

2. Vá para Developer → Edit config em Local MCP servers.

3. Adicione esta configuração:

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

4. Para autenticar com uma chave de API em vez de OAuth no navegador, use esta configuração:

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

5. Salve o arquivo e reinicie o Claude Desktop.

6. Se você usou OAuth, conclua a autorização no navegador quando solicitado. Se você usou o método da chave de API, a etapa do navegador é pulada.

7. Em uma conversa, abra Connectors e confirme que o Metricool está conectado.

Passos completos para Claude Desktop e Claude Code: Como conectar o MCP do Metricool com o Claude.

O endpoint, o método ou a etapa de autorização está incompleto. Corrige nesta ordem:

1. Confirme que a URL do servidor é exatamente https://ai.metricool.com/mcp (sem caminho extra, sem espaço e sem host alternativo).

2. Confirme que o seu cliente está usando o método da tabela acima. Por exemplo, o N8N precisa de autenticação por cabeçalho, não de uma configuração simples só com OAuth; o Claude Desktop precisa de mcp-remote.

3. Conclua o login no navegador e escolha Grant access quando o Metricool pedir permissões.

4. No Cursor, depois da instalação o servidor pode aparecer como não autenticado até você clicar em Connect e terminar a autorização no navegador.

5. No Gemini CLI, depois de adicionar a configuração, rode /mcp auth metricool e conclua a autorização no navegador.

6. No Claude Code, rode /mcp, selecione Metricool e depois autentique quando solicitado.

O N8N conecta com autenticação por token de cabeçalho, não com o fluxo de OAuth só por URL usado pela maioria dos outros clientes.

1. Na MCP Client Tool, defina o endpoint como https://ai.metricool.com/mcp.

2. Defina Authentication como Header Auth.

3. Crie uma credencial com Name X-Mc-Auth.

4. Defina o valor como a sua chave de API do Metricool em Configurações da conta > API.

5. Salve a credencial e tente o fluxo de trabalho de novo.

Conectores personalizados remotos do MCP estão disponíveis no Claude Free, Pro, Max, Team e Enterprise. Usuários Free podem usar apenas um conector personalizado por vez.

Remova ou substitua o conector personalizado existente e depois conecte o Metricool de novo. O Claude Code ainda exige uma assinatura Pro ou Max.

O Claude Code exige uma assinatura Pro ou Max e a instalação pela página do produto Claude Code antes que você possa adicionar o Metricool.

1. Confirma que o Claude Code está instalado e que você está no Pro ou Max.

2. Rode:

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

3. Inicie o Claude Code com claude, rode /mcp, selecione Metricool e autentique.

A configuração do MCP no Cursor exige o app Cursor Desktop. O Cursor só no navegador não consegue concluir o caminho de instalação documentado.

1. Instale e abra Cursor Desktop.

2. Use o deep link de instalação do Metricool ou o link web de Como conectar o MCP do Metricool, ou adicione um MCP personalizado com:

   "metricool-mcp": {
     "url": "https://ai.metricool.com/mcp",
     "type": "http"
   }

3. Clique em Connect, autorize o Metricool no navegador e volte ao Cursor para confirmar a conexão.

Isso normalmente é um limite do plano, não uma falha na conexão com o servidor. O MCP funciona nos planos Free e pagos, mas os limites do plano Metricool continuam valendo para o que o MCP pode consultar ou agendar.

• Contas gratuitas não podem agendar mais de 20 posts.

• Os planos pagos ampliam esses limites.

Se você precisar de acesso HTTP programático fora de um cliente de IA, isso é a API do Metricool (Advanced ou Custom), não MCP. Veja MCP vs API access: what is the difference?.