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.
Para ver los pasos de configuración por cliente, consulta Cómo conectar el MCP de Metricool. Para los límites del plan que aplican después de una conexión exitosa, consulta Límites de MCP y requisitos del plan.
Lista rápida de comprobación de conexión
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.
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 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.
Añade esta configuración:
Para autenticarte con una clave API en lugar de OAuth en el navegador, usa esta configuración:
Guarda el archivo y reinicia Claude Desktop.
Si usaste OAuth, completa la autorización en el navegador cuando se te pida. Si usaste el método de clave API, se omite el paso del navegador.
En un chat, abre Conectores y confirma que Metricool está conectado.
Pasos completos para Claude Desktop y Claude Code: Cómo conectar el MCP de Metricool con Claude.
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.
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.
Define Authentication como Header Auth.
Crea una credencial con Name X-Mc-Auth.
Pon el valor como tu clave API de Metricool desde Configuración de la cuenta > API.
Guarda la credencial e intenta el flujo de trabajo otra vez.
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 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:
Inicia Claude Code con claude, ejecuta /mcp, selecciona Metricool y autentícate.
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.
Instala y abre Cursor Desktop.
Usa el enlace profundo de instalación de Metricool o el enlace web de Cómo conectar el MCP de Metricool, o añade un MCP personalizado con:
Haz clic en Conectar, autoriza Metricool en el navegador y vuelve a Cursor para confirmar la conexión.
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.
ChatGPT: Metricool aparece conectado desde Apps después de iniciar sesión y conceder acceso. Pasos completos: Cómo conectar el MCP de Metricool con ChatGPT.
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.
Artículos relacionados