Usa el endpoint MCP de producción de Metricool https://ai.metricool.com/mcp, adapta tu cliente de IA al método de conexión correcto y luego sigue las comprobaciones de abajo si el servidor no se conecta.
Confirma estos puntos antes de meterte en correcciones específicas del cliente:
Endpoint: usa la URL de producción exactamente: 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 le corresponde abajo (URL/OAuth, token de cabecera, CLI o mcp-remote).
Autenticación: completa el inicio de sesión OAuth y concede acceso, o configura la autenticación por cabecera con la clave API de Metricool cuando el cliente lo requiera.
Requisitos previos del cliente: Claude Code necesita una suscripción Pro o Max; Cursor necesita la app de escritorio de Cursor; Claude Free solo puede usar un conector personalizado a la vez. Lista completa: Límites de MCP y requisitos del plan.
Señal de éxito: el cliente muestra Metricool como conectado, autenticado o listo para usar (la redacción varía según la herramienta).
Elige el método de conexión correcto
Usa el método que coincida con tu cliente. Usar el método incorrecto es una causa común de que el servidor MCP nunca termine de conectarse.
Método de conexión
Cómo te autenticas
Clientes compatibles
Basado en URL (HTTP/OAuth)
Pega la URL de MCP y luego inicia sesión en Metricool y concede acceso
Añade MCP por HTTP/CLI y luego autentícate cuando se te pida
Claude Code, Gemini CLI
mcp-remote
Ejecuta npx mcp-remote contra la URL de Metricool y luego usa OAuth o X-Mc-Auth
Claude Desktop
Otras opciones de autenticación documentadas para clientes MCP son iniciar sesión con 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 la solución.
Claude Desktop no se conecta por la ruta habitual
Claude Desktop tiene un error externo documentado que bloquea la ruta habitual de conexión MCP. Usa mcp-remote en su lugar.
En Claude Desktop, abre Configuración desde tu perfil.
Ve a Desarrollador → Editar configuración en Servidores MCP locales.
El cliente nunca termina de conectarse o sigue sin autenticarse
El endpoint, el método o el paso de autorización está incompleto. Arréglalo en este orden:
Confirma que la URL del servidor sea exactamente https://ai.metricool.com/mcp (sin ruta extra, espacios ni un host alternativo).
Confirma que tu cliente está usando el método de la tabla de arriba. Por ejemplo, N8N necesita autenticación por cabecera, no una configuración OAuth solo con navegador; Claude Desktop necesita mcp-remote.
Completa el inicio de sesión en el navegador y elige Conceder acceso cuando Metricool te pida permisos.
En Cursor, después de instalarlo, el servidor puede aparecer como no autenticado hasta que hagas clic en Conectar y termines la autorización en el navegador.
En Gemini CLI, después de añadir la configuración, ejecuta /mcp auth metricool y termina la autorización en el navegador.
En Claude Code, ejecuta /mcp, selecciona Metricool y luego autentícate cuando se te pida.
La autenticación por cabecera de N8N falla
N8N se conecta con autenticación por token de cabecera, no con el flujo OAuth solo por URL que usan la mayoría de los demás clientes.
En la herramienta MCP Client Tool, define el endpoint como https://ai.metricool.com/mcp.
Guarda la credencial e intenta el flujo de trabajo otra vez.
Claude Free no puede añadir Metricool como otro conector personalizado
Los conectores personalizados de Remote MCP están disponibles en Claude Free, Pro, Max, Team y Enterprise. Los usuarios de 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 requiriendo una suscripción Pro o Max. Consulta Cómo conectar el MCP de Metricool con Claude.
Claude Code no acepta el comando de añadir MCP
Claude Code requiere una suscripción Pro o Max y la instalación desde la página del producto Claude Code antes de que puedas añadir Metricool.
Confirma que Claude Code esté instalado y que estés en 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 de MCP en Cursor requiere la app de escritorio de Cursor. Cursor solo en el 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
Eso suele ser un límite del plan, no una conexión fallida del servidor. El MCP funciona en planes Free y de pago, pero los límites del plan de Metricool siguen aplicando a lo que el MCP puede consultar o programar.
Revisa los ejemplos del plan Free, los requisitos del lado del cliente y la frontera entre MCP y API en Límites de MCP y requisitos del plan. Si necesitas acceso HTTP programático fuera de un cliente de IA, eso es la API de Metricool (Advanced o Custom), no MCP. Consulta Acceso MCP vs API: ¿cuál es la diferencia?.
Confirma que la conexión se ha realizado correctamente
Usa la señal de éxito de tu cliente:
Claude Desktop: Metricool aparece en Conectores como conectado.
Claude Code: después de la autorización en el navegador, /mcp muestra Metricool conectado.
Cursor: después de la autorización en el navegador, Cursor se vuelve a abrir con Metricool conectado.
Gemini CLI: después de /mcp auth metricool y la autorización en el navegador, el MCP queda conectado en la sesión de terminal.
Make, Zapier, Smithery, Mistral Vibe, TypingMind, N8N: después de conceder acceso (o de guardar las credenciales de cabecera en N8N), el cliente muestra el conector o las herramientas como disponibles.
Revoca el acceso y vuelve a conectar
Para revocar el acceso, elimina o desconecta el conector de Metricool del cliente o plataforma de IA donde 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 conectar repitiendo los pasos de conexión de ese cliente y concediendo acceso otra vez si necesitas recuperar el MCP.