Usa el endpoint de producción de Metricool https://ai.metricool.com/mcp, configura tu cliente de IA con el método de conexión correcto y, si el servidor no se conecta, sigue las comprobaciones que aparecen a continuación.
Confirma estos puntos antes de revisar soluciones específicas para cada cliente:
Endpoint: usa exactamente la URL de producción: https://ai.metricool.com/mcp.
Cuenta de Metricool: tienes una cuenta de Metricool y puedes iniciar sesión.
Método del cliente: tu herramienta usa el método que se indica a continuación (URL/OAuth, token de encabezado, CLI o mcp-remote).
Autenticación: completa el inicio de sesión mediante OAuth y concede acceso, o configura la autenticación mediante encabezado con la clave de API de Metricool cuando el cliente lo requiera.
Requisitos del cliente: Claude Code necesita una suscripción Pro o Max; Cursor necesita la aplicación Cursor Desktop; Claude Free solo puede usar un conector personalizado a la vez. Lista completa: Límites del MCP y requisitos del plan.
Indicio de conexión correcta: el cliente muestra Metricool como conectado, autenticado o listo para usarse (el texto puede variar según la herramienta).
Elige el método de conexión correcto
Usa el método que corresponda a tu cliente. Usar el método incorrecto es una razón frecuente por la que el servidor MCP nunca termina de conectarse.
Método de conexión
Cómo te autenticas
Clientes compatibles
Basado en URL (HTTP/OAuth)
Pega la URL del MCP, inicia sesión en Metricool y concede acceso
ChatGPT, Make, Zapier, Smithery, Mistral Vibe, Cursor, TypingMind, Claude Desktop y Claude.ai (mediante el Directorio de conectores)
Añade el MCP mediante HTTP/CLI y, después, autentícate cuando se te solicite
Claude Code, Gemini CLI
mcp-remote
Ejecuta npx mcp-remote con la URL de Metricool y, después, usa OAuth o X-Mc-Auth
Claude Desktop (solo como alternativa manual, no es la ruta predeterminada)
Claude Desktop y Claude.ai se conectan de la misma forma: Configuración → Conectores → Explorar conectores → busca Metricool → Conceder acceso. Este flujo de OAuth no necesita una clave de API de Metricool. mcp-remote es una alternativa solo para Claude Desktop, cuando el listado del directorio no está disponible o el flujo no se completa.
Otras opciones de autenticación documentadas para los clientes MCP son iniciar sesión mediante OAuth o proporcionar METRICOOL_USER_TOKEN y METRICOOL_USER_ID en la configuración del cliente. Consulta Preguntas frecuentes sobre el MCP de Metricool.
Problemas de conexión
Abre el síntoma que coincida con lo que ves. Cada sección cubre un modo de fallo verificado y su solución.
Claude Desktop no se conecta mediante la ruta habitual
Empieza por el Directorio de conectores: Configuración → Conectores → Explorar conectores → busca Metricool → Conceder acceso. Este es el mismo flujo de OAuth que se usa en Claude.ai y no requiere una clave de API de Metricool. Si esta ruta no se completa, conéctate manualmente con mcp-remote.
En Claude Desktop, abre Configuración desde tu perfil.
Ve a Desarrollador → Editar configuración en Servidores MCP locales.
Esta configuración de OAuth no necesita una clave de API. Para autenticarte con una clave de API en lugar de OAuth mediante el navegador, usa esta configuración:
Si usaste OAuth, completa la autorización en el navegador cuando se te solicite. Si usaste el método de clave de API, se omitirá el paso del navegador.
En un chat, abre Conectores y confirma que Metricool está conectado.
El cliente nunca termina de conectarse o permanece sin autenticar
El endpoint, el método o el paso de autorización está incompleto. Corrígelo en este orden:
Confirma que la URL del servidor sea exactamente https://ai.metricool.com/mcp (sin rutas adicionales, espacios ni otro host).
Confirma que tu cliente use el método indicado en la tabla anterior. Por ejemplo, N8N necesita autenticación mediante encabezado, no una configuración basada únicamente en OAuth; Claude Desktop comienza con el Directorio de conectores y solo recurre a mcp-remote si no se completa.
Completa el inicio de sesión en el navegador y selecciona Conceder acceso cuando Metricool te solicite permisos.
En Cursor, después de la instalación, el servidor puede aparecer sin autenticar hasta que hagas clic en Conectar y completes la autorización en el navegador.
En Gemini CLI, después de añadir la configuración, ejecuta /mcp auth metricool y completa la autorización en el navegador.
En Claude Code, ejecuta /mcp, selecciona Metricool y autentícate cuando se te solicite.
La autenticación mediante encabezado de N8N falla
N8N se conecta mediante autenticación con token de encabezado, no mediante el flujo de OAuth basado solo en URL que usan la mayoría de los demás clientes.
En MCP Client Tool, configura el endpoint como https://ai.metricool.com/mcp.
Guarda la credencial y vuelve a intentar el flujo de trabajo.
Claude Free no puede añadir Metricool como otro conector personalizado
Los conectores personalizados MCP remotos están disponibles en Claude Free, Pro, Max, Team y Enterprise. Los usuarios del plan Free solo pueden usar un conector personalizado a la vez.
Elimina o sustituye el conector personalizado existente y vuelve a conectar Metricool. Claude Code sigue necesitando una suscripción Pro o Max. Consulta Cómo conectar el MCP de Metricool con Claude.
Claude Code no acepta el comando para añadir el MCP
Claude Code requiere una suscripción Pro o Max y debe instalarse desde la página del producto Claude Code antes de que puedas añadir Metricool.
Confirma que Claude Code esté instalado y que tengas el plan Pro o Max.
Ejecuta:
claude mcp add --transport http metricool https://ai.metricool.com/mcp
Inicia Claude Code con claude, ejecuta /mcp, selecciona Metricool y autentícate.
Cursor no muestra el flujo de instalación del MCP de Metricool
La configuración del MCP de Cursor requiere la aplicación Cursor Desktop. Cursor solo para navegador no puede completar la ruta de instalación documentada.
Haz clic en Conectar, autoriza Metricool en el navegador y vuelve a Cursor para confirmar la conexión.
El MCP se conecta, pero las acciones fallan o los datos parecen limitados
Normalmente se trata de un límite del plan, no de un fallo en la conexión del servidor. El MCP funciona con planes Free y de pago, pero los límites del plan de Metricool siguen aplicándose a lo que el MCP puede consultar o programar.
Make, Zapier, Smithery, Mistral Vibe, TypingMind, N8N: después de conceder acceso (o guardar las credenciales del encabezado en N8N), el cliente muestra el conector o las herramientas como disponibles.
Revoca el acceso y vuelve a conectarte
Para revocar el acceso, elimina o desconecta el conector de Metricool desde el cliente de IA o la plataforma en la que lo autorizaste (por ejemplo, Claude, ChatGPT, Cursor u otro cliente MCP). No puedes revocar ese permiso del conector desde Metricool.
Después de revocar el acceso en la plataforma, vuelve a conectarte repitiendo los pasos de conexión de ese cliente y concediendo acceso de nuevo si necesitas recuperar el MCP.