Metricool MCP

No puedo conectar con Metricool MCP

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.

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

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

Token de cabecera

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

N8N

CLI

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.

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

  2. Ve a DesarrolladorEditar configuración en Servidores MCP locales.

  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 clave API, se omite el paso del navegador.

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

  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 OAuth solo con navegador; 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 instalarlo, 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 por URL que usan la mayoría de los demás clientes.

  1. En la herramienta MCP Client Tool, define el endpoint como https://ai.metricool.com/mcp.

  2. Define Authentication como Header Auth.

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

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

  5. 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.

  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 MCP en Cursor requiere la app de escritorio de Cursor. Cursor solo en el 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 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.

  • 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

¿Te fue útil?