Qué es

El Model Context Protocol (MCP) es una forma estándar para que los clientes de IA — Claude Code, Claude Desktop, Cursor, ChatGPT en modo desarrollador, n8n, Make — descubran y llamen herramientas expuestas por servicios externos. SonetHub envía un servidor MCP en https://mcp.sonethub.com/mcp para que puedas dirigir tu espacio de trabajo desde el runtime que ya uses.

Tu cliente de IA lista las herramientas de SonetHub, le describes lo que quieres, el cliente llama a la herramienta correcta con los argumentos correctos. Misma superficie del agente que el chat dentro del producto — misma seguridad, mismo seguimiento de costes, mismas acciones gateadas por rol.

Configuración

1. Crea una clave de API

Ve a Ajustes → Acceso MCP en la app de SonetHub y haz clic en Crea tu primera clave. Dale un nombre (tu portátil, un flujo en n8n, una integración de CI — lo que te ayude a reconocerla más tarde). La clave se muestra exactamente una vez. Cópiala.

Las claves de API empiezan por snh_pat_. Heredan el rol del usuario que las creó en cada petición, limitadas al espacio de trabajo activo en el momento de crearlas.

2. Conecta desde tu cliente

Claude Code:

claude mcp add --transport http sonethub https://mcp.sonethub.com/mcp \
  --header "Authorization: Bearer snh_pat_..."

Después, dentro de Claude Code, escribe /mcp para confirmar la conexión y ver las herramientas disponibles.

Cursor / Claude Desktop (recomendado — edita el archivo de configuración):

Añade a tu configuración de servidores MCP (Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json en macOS; Cursor: Settings → MCP):

{
  "mcpServers": {
    "sonethub": {
      "url": "https://mcp.sonethub.com/mcp",
      "headers": {
        "Authorization": "Bearer snh_pat_..."
      }
    }
  }
}

Reinicia la app después de editar.

Claude Desktop (diálogo de conector personalizado):

El diálogo Settings → Connectors → Add custom connector no tiene campo para cabeceras HTTP — solo URL. Para ese flujo, pasa tu clave como parámetro de query:

https://mcp.sonethub.com/mcp?api_key=snh_pat_...

Compensación: las claves en query string pueden acabar en logs de acceso aguas arriba y en el historial del navegador. Prefiere el formato de archivo de configuración cuando puedas. Si sospechas que una clave en URL se ha expuesto (pantalla compartida, log pegado), revócala en Ajustes y crea una nueva.

n8n:

Añade un nodo MCP, configura:

URL: https://mcp.sonethub.com/mcp
Transporte: HTTP (Streamable)
Cabecera: Authorization: Bearer snh_pat_...

3. Empieza a usarlo

Una vez conectado, pídele a tu agente cosas como:

"Lista mis cuentas sociales conectadas."
"Programa un post de LinkedIn sobre el lanzamiento de nuestro producto para mañana a las 9am hora de Madrid."
"¿Cuál es mi mejor TikTok de este mes?"
"Lee mis DMs de Instagram de la última semana y señala lo importante."
"Constrúyeme una automatización que envíe DM a quien comente PRECIO en mi última publicación."

Herramientas disponibles

La superficie MCP expone 24 herramientas curadas. Algunas destacadas:

Publicación

publish_post, schedule_post, save_draft, edit_post, delete_post
publish_story, publish_reel, publish_article, publish_document (específicas por formato)

Generación de contenido

generate_social_post, adapt_content
generate_image, generate_video

Bandeja e interacción

read_inbox, reply_message
read_mentions, reply_comment

Analíticas

query_analytics, fetch_account_posts, suggest_posting_time

Automatización

manage_automations, describe_automation

Memoria de marca

manage_memories

Descubrimiento de cuentas

list_connected_accounts

Las herramientas internas, las acopladas a la UI y las acciones destructivas como edit_published_post y delete_comment no están expuestas vía MCP — usa la app web de SonetHub para esas.

Límites

Por clave: hasta 100 llamadas por minuto. Detecta una clave individual que se haya usado mal.
Por espacio de trabajo al día: hasta 5.000 lecturas y 1.000 escrituras. Se reinicia a medianoche UTC.
Por herramienta: los mismos límites de plan que aplican en la web (topes diarios de publicación, créditos mensuales, concurrencia de vídeo) aplican aquí. La ruta MCP no esquiva ninguno.

Cuando alcances un límite recibirás un error estructurado explicando cuál + cuándo reintentar. El agente que lea la respuesta te lo expondrá en lenguaje claro.

Seguridad

Las claves se guardan como hashes SHA-256; nunca registramos la clave en bruto.
Cada petición pasa por la comprobación de espacio de trabajo + rol que usa el resto del producto. Una clave con rol viewer solo ve herramientas de lectura.
Revocar una clave desde Ajustes la desactiva en segundos — todas las peticiones en vuelo que la usen reciben un 401 en la siguiente llamada.
La ruta MCP nunca reenvía tu token bearer a plataformas externas (Instagram, X, etc.). Las llamadas a esas usan los tokens OAuth que tu espacio de trabajo ya tiene, cifrados en reposo.

Planes

El acceso MCP está disponible en cada plan de pago y en Free. Los límites de plan sobre las herramientas mismas siguen aplicando: una llamada generate_video en un workspace Free devuelve un mensaje de "se requiere actualización" antes de tocar ninguna API externa, igual que en el chat del producto.

Revocar una clave

Ve a Ajustes → Acceso MCP, encuentra la clave, haz clic en Revocar, confirma. La siguiente petición que la lleve recibe un 401.

Si sospechas que una clave se filtró: revócala inmediatamente, después crea una nueva y reconfigura tu cliente.

Solución de problemas

"Unauthorized" / "Clave MCP inválida o revocada" La clave fue revocada, mal escrita o pertenece a un espacio de trabajo al que ya no tienes acceso. Comprueba el prefijo de la clave en Ajustes contra el que tienes en tu configuración de cliente.

"La herramienta 'X' no está disponible vía MCP" La herramienta que intentaste llamar no está en la superficie MCP curada. Usa la app web o el chat de SonetHub para esa acción.

Errores de rate-limit durante uso normal Abre Ajustes → Acceso MCP y comprueba si tienes claves huérfanas de configuraciones anteriores que aún se estén sondeando — revócalas. Si la carga legítima genuinamente alcanza el límite, contacta con soporte.