Não consigo conectar ao Metricool MCP

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

1. No Claude Desktop, abra 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 for solicitado. Se você usou o método da chave de API, a etapa do navegador é pulada.

7. No chat, 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. Corrija nesta ordem:

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

2. Confirme que 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 Conceder acesso 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 concluir a autorização no navegador.

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

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

O N8N se conecta com autenticação por token de cabeçalho, e não com o fluxo OAuth apenas 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 o Name X-Mc-Auth.

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

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

Os conectores personalizados do Remote 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. Veja Como conectar o MCP do Metricool com o Claude.

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

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

2. Execute:

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

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

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

1. Instale e abra Cursor Desktop.

2. Use o link profundo 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.

Normalmente isso é um limite do plano, não uma falha de conexão do servidor. O MCP funciona nos planos Free e pagos, mas os limites do plano Metricool ainda se aplicam ao que o MCP pode consultar ou agendar.

Confira exemplos do plano Free, requisitos do lado do cliente e a fronteira entre MCP e API em Limites do MCP e requisitos do plano. 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 Acesso via MCP vs API: qual é a diferença?.