Metricool MCP

No puedo conectar con Metricool MCP

Usa el endpoint MCP de producción de Metricool https://ai.metricool.com/mcp, haz que tu cliente de IA coincida con el método de conexión correcto y luego revisa las comprobaciones de abajo si el servidor no conecta.

El MCP de Metricool funciona con cualquier plan de Metricool, incluido Free. Los límites de tu plan siguen aplicando después de conectar. Por ejemplo, las cuentas gratis no pueden programar más de 20 publicaciones.

Lista rápida de comprobación de la conexión

Confirma estos puntos antes de meterte en correcciones específicas del 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 indicado abajo para ella (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 del cliente: Claude Code necesita una suscripción Pro o Max; Cursor necesita la app Cursor Desktop; Claude Free solo puede usar un conector personalizado a la vez.

  • Señal de éxito: el cliente muestra Metricool como conectado, autenticado o listo para usar (la redacción varía según la herramienta).

Para ver los pasos completos de configuración por cliente, mira Cómo conectar el MCP de Metricool.

Elige el método de conexión correcto

Usa el método que corresponda a tu cliente. Usar el método equivocado 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 MCP y luego inicia sesión en Metricool y concede acceso

ChatGPT, Make, Zapier, Smithery, Mistral Vibe, Cursor

Token de cabecera

Configura el nombre de cabecera X-Mc-Auth con tu clave API de Metricool desde Configuración de la cuenta > API

N8N

CLI

Añade el 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. Mira 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 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.

  1. En Claude Desktop, abre Configuración desde tu perfil.

  2. Ve a DeveloperEditar config en Local MCP servers.

  3. Añade esta configuración:

    {
      "mcpServers": {
        "metricool-mcp": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://ai.metricool.com/mcp"
          ]
        }
      }
    }
  4. Para autenticarte con una clave API en lugar de OAuth en el navegador, usa esta configuración:

    {
      "mcpServers": {
        "metricool-mcp": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://ai.metricool.com/mcp",
            "--header",
            "X-Mc-Auth: <METRICOOL_API_KEY>"
          ]
        }
      }
    }
  5. Guarda el archivo y reinicia Claude Desktop.

  6. Si usaste OAuth, completa la autorización en el navegador cuando se te pida. Si usaste el método de la clave API, se omite el paso del navegador.

  7. En un chat, abre Connectors y confirma que Metricool está conectado.

Pasos completos para Claude Desktop y Claude Code: Cómo conectar el MCP de Metricool con Claude.

El cliente nunca termina de conectarse o sigue sin autenticarse

El endpoint, el método o el paso de autorización están incompletos. Arréglalo en este orden:

  1. Confirma que la URL del servidor sea exactamente https://ai.metricool.com/mcp (sin ruta extra, espacios ni un host alternativo).

  2. 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 simple solo con OAuth; Claude Desktop necesita mcp-remote.

  3. Completa el inicio de sesión en el navegador y elige Conceder acceso cuando Metricool te pida permisos.

  4. En Cursor, después de instalar, el servidor puede aparecer como no autenticado hasta que hagas clic en Conectar y termines la autorización en el navegador.

  5. En Gemini CLI, después de añadir la configuración, ejecuta /mcp auth metricool y termina la autorización en el navegador.

  6. 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 con URL que usan la mayoría de los demás clientes.

  1. En la herramienta MCP Client, establece el endpoint en https://ai.metricool.com/mcp.

  2. Establece Authentication en Header Auth.

  3. Crea una credencial con Name X-Mc-Auth.

  4. Pon como valor tu clave API de Metricool desde Configuración de la cuenta > API.

  5. Guarda la credencial y vuelve a probar el flujo de trabajo.

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 Free solo pueden usar un conector personalizado a la vez.

Elimina o reemplaza el conector personalizado existente y luego conecta Metricool otra vez. Claude Code sigue necesitando una suscripción Pro o Max.

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.

  1. Confirma que Claude Code está instalado y que estás en Pro o Max.

  2. Ejecuta:

    claude mcp add --transport http metricool https://ai.metricool.com/mcp
  3. 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 Cursor MCP requiere la app Cursor Desktop. Cursor solo en navegador no puede completar la ruta de instalación documentada.

  1. Instala y abre Cursor Desktop.

  2. 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:

    "metricool-mcp": {
      "url": "https://ai.metricool.com/mcp",
      "type": "http"
    }
  3. Haz clic en Conectar, autoriza Metricool en el navegador y vuelve a Cursor para confirmar la conexión.

El MCP conecta, pero las acciones fallan o los datos parecen limitados

Normalmente eso es un límite del plan, no una conexión fallida con el 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.

  • Las cuentas gratis no pueden programar más de 20 publicaciones.

  • Los planes de pago amplían esos límites.

Si necesitas acceso HTTP programático fuera de un cliente de IA, eso es la API de Metricool (Advanced o Custom), no MCP. Mira MCP vs API access: what is the difference?.

Confirma que la conexión se ha realizado

Usa la señal de éxito de tu cliente:

  • Claude Desktop: Metricool aparece en Connectors 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 aparece conectado en la sesión del 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, 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.

Revocar acceso y volver a conectar

Para revocar el acceso, elimina o desconecta el conector de Metricool del cliente de IA o de la plataforma donde lo autorizaste (por ejemplo Claude, ChatGPT, Cursor u otro cliente MCP). No puedes revocar ese permiso del conector desde dentro de 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.

¿Te fue útil?