Não consigo me conectar ao MCP do Metricool

Comece pelo Diretório de conectores: Configurações → Conectores → Procurar conectores → pesquise Metricool → Conceder acesso. Esse é o mesmo fluxo OAuth usado no Claude.ai e não exige uma chave de API do Metricool. Se esse caminho não for concluído, conecte-se manualmente usando mcp-remote.

1. No Claude Desktop, abra Configurações pelo seu perfil.

2. Acesse Desenvolvedor → Editar configuração em Servidores MCP locais.

3. Adicione esta configuração:

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

4. Essa configuração OAuth não precisa de uma chave de API. Para autenticar com uma chave de API em vez do OAuth pelo 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 usou o método da chave de API, a etapa do navegador será ignorada.

7. Em um chat, abra Conectores e confirme que o Metricool está conectado.

Etapas completas para Claude Desktop e Claude Code: Como conectar o MCP do Metricool ao Claude.

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

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

2. Confirme se o 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 apenas com OAuth; o Claude Desktop começa pelo Diretório de conectores e só usa mcp-remote como alternativa se esse processo não for concluído.

3. Conclua o login no navegador e selecione Conceder acesso quando o Metricool solicitar permissões.

4. No Cursor, após a instalação, o servidor pode aparecer como não autenticado até você clicar em Conectar e concluir a autorização no navegador.

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

6. No Claude Code, execute /mcp, selecione Metricool e autentique-se quando solicitado.

O N8N se conecta usando autenticação por token no cabeçalho, não o fluxo OAuth somente por URL usado pela maioria dos outros clientes.

1. Na Ferramenta de cliente MCP, defina o endpoint como https://ai.metricool.com/mcp.

2. Defina Autenticação como Autenticação por cabeçalho.

3. Crie uma credencial com o Nome X-Mc-Auth.

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

5. Salve a credencial e tente executar o fluxo novamente.

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

Remova ou substitua o conector personalizado existente e conecte o Metricool novamente. O Claude Code ainda exige uma assinatura Pro ou Max. Consulte Como conectar o MCP do Metricool ao Claude.

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. Confirme se o Claude Code está instalado e se você está no plano 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-se.

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

1. Instale e abra o Cursor Desktop.

2. Use o link direto de instalação do Metricool ou o link da web em 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 Conectar, autorize o Metricool no navegador e volte ao Cursor para confirmar a conexão.

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

Confira exemplos do plano Free, requisitos do cliente e a diferença entre MCP e API em Limites do MCP e requisitos de plano. Se você precisa de acesso HTTP programático fora de um cliente de IA, isso é a API do Metricool (Advanced ou Custom), não o MCP. Consulte Acesso MCP vs. API: qual é a diferença?.