# Servidor MCP de HeyMark: lleva tu marca desde Claude o ChatGPT. El servidor MCP de HeyMark le pasa a tu asistente lo real: tu calendario, tu bandeja, tus números. Le pides los borradores de la semana, mueves una publicación o respondes un comentario sin salir de la conversación. Está en todos los planes y no gasta tus chats de Mark. Pégala en cualquier cliente MCP compatible con OAuth. Inicias sesión con tu propia cuenta de HeyMark, así que tu asistente ve lo que ves tú y nada más. ## Se configura una sola vez La misma URL en todos. Elige tu cliente y sigue las cuatro líneas. ### Claude Desktop 1. Abre Claude, entra en Ajustes y luego en Conectores. 2. Elige Añadir conector personalizado. 3. Pega la URL de conexión y guarda. 4. Aprueba el acceso cuando HeyMark se abra en tu navegador. ### Claude Code Ejecuta esto en tu terminal. `claude mcp add --transport http heymark https://mcp.heymark.ai` La primera vez que lo uses, el navegador abrirá HeyMark para aprobar el acceso. ### ChatGPT 1. Abre los ajustes de ChatGPT y entra en Apps y conectores. 2. Activa el modo desarrollador en los ajustes avanzados. 3. Añade un conector nuevo con la URL de conexión. 4. Aprueba el acceso cuando se abra HeyMark. ChatGPT solo ejecuta acciones, como crear o publicar, con el modo desarrollador activo. Los clientes MCP compatibles usan la misma URL. No hay llaves que generar ni aplicación que registrar: tu cliente se registra solo la primera vez que conecta. ## Lo que puede hacer tu asistente Lee tu marca y luego planifica y actualiza su contenido, bandeja y flujo de publicación. ### Lectura (17) - `list_brands`: Las marcas a las que llega tu cuenta y tu rol en cada una. - `get_brand_context`: La identidad de una marca, sus cuentas conectadas y su contenido reciente. - `list_posts`: El calendario: qué es idea, borrador, programado o publicado. - `get_post_insights`: Visualizaciones, alcance, likes, comentarios y engagement de una publicación. - `get_post_caption`: El copy completo de una publicación. - `get_post_planning_content`: La idea, las notas y los guiones de video completos de una publicación, en su orden original. - `get_post_tags`: Las etiquetas de planificación de una publicación. - `get_account_overview`: Cuentas conectadas con seguidores, estado de conexión y última sincronización. - `list_automations`: Tus automatizaciones de DM y de comentarios, y si están activas. - `get_inbox_overview`: Cuántos mensajes sin leer hay y qué conversaciones esperan respuesta. - `list_inbox_messages`: El historial de la bandeja de la marca, entre todas sus conversaciones y desde el más reciente. - `get_conversation_messages`: Los mensajes dentro de una conversación de la bandeja. - `get_analytics_overview`: Los últimos N días: tendencia de seguidores, totales contra el periodo anterior y mejores publicaciones. - `get_audience_demographics`: Edad, género, país y ciudad de quienes te siguen. - `get_post_comments`: Los comentarios guardados de una publicación. - `get_team_comments`: La conversación privada del equipo en una publicación. - `get_post_media_analysis`: La transcripción y la descripción visual de la media, con su administrador de archivos. ### Escritura (15) - `create_post`: Crear una idea o borrador con su copy y contenido de planificación. - `create_team_comment`: Añadir un comentario privado del equipo o responder uno. - `update_post`: Actualizar el contenido, copy, personas o fecha de una idea o borrador. - `update_post_tags`: Añadir, quitar o crear etiquetas de planificación. - `upload_post_cover`: Abrir el selector de imagen para la portada de un Reel o video de TikTok. - `move_post_status`: Mover una publicación a un estado de planificación del tablero de la marca. - `reschedule_post`: Mover la fecha de planificación de una idea o borrador. - `unschedule_post`: Sacar una publicación de la cola. - `update_post_automation` (Pide confirmación): Cambiar las respuestas automáticas de una publicación. - `schedule_post` (Pide confirmación): Programar una publicación para una fecha futura o mover una programación existente. - `publish_post` (Pide confirmación): Publicar ahora mismo en la plataforma conectada. - `delete_post` (Pide confirmación): Eliminar una idea o un borrador para siempre. - `reply_to_comment` (Pide confirmación): Responder un comentario en público. - `delete_comment` (Pide confirmación): Borrar un comentario de la plataforma. - `reply_to_conversation` (Pide confirmación): Enviar un mensaje directo en una conversación. ## Nada sale sin ti. Tu asistente puede dejarlo todo listo. Lo que llega al público sigue esperando tu visto bueno. - Publicar, programar, eliminar, responder en público y tocar una automatización vuelven primero como vista previa, y solo se ejecutan cuando tú apruebas. - La conexión lleva tus permisos de HeyMark. Una marca que no puedes abrir en la app, tu asistente tampoco. - Revócala desde tu cliente cuando quieras y la siguiente llamada se queda en la puerta. - 60 llamadas de herramientas por minuto, para que nada al otro lado pueda golpear tus cuentas. ## Para quien construye clientes MCP Streamable HTTP, OAuth 2.1 y el descubrimiento en el lugar estándar. Si tu cliente sigue la especificación, aquí no hay nada que configurar. - Endpoint: POST https://mcp.heymark.ai - Transporte: Streamable HTTP, sin estado - Autorización: OAuth 2.1 con PKCE, bearer token en el header - Descubrimiento OAuth: /.well-known/oauth-protected-resource - Registro: Dinámico, sin client_id manual - Grants: authorization_code, refresh_token - Límite de uso: 60 llamadas de herramientas por minuto ## Antes de conectar ### ¿Tiene costo extra? No. Está en todos los planes y no descuenta de tus chats ni de tus respuestas de Mark: estas herramientas leen y escriben tus datos, no ejecutan un modelo. ### ¿Llega a todas mis marcas? A todas las que puede leer tu cuenta. Tu asistente las lista y tú eliges; si tienes una sola, ya viene elegida. ### ¿Qué pasa si lo desconecto? Solo se va el acceso. Tus publicaciones programadas, tus automatizaciones y tus conversaciones quedan tal cual estaban. ### ¿Hay también una API REST? Todavía no. MCP es la puerta de entrada hoy, y cubre tanto la lectura como la escritura. ## Recursos para desarrolladores y agentes - [Documentación MCP de HeyMark](https://heymark.ai/es/mcp/) - [llms.txt](https://heymark.ai/llms.txt) - [Contenido completo del sitio para modelos de lenguaje](https://heymark.ai/llms-full.txt) - Endpoint del protocolo MCP: `POST https://mcp.heymark.ai` - Metadatos OAuth del recurso protegido: [/.well-known/oauth-protected-resource](https://mcp.heymark.ai/.well-known/oauth-protected-resource) - MCP server card: [/server-card](https://mcp.heymark.ai/server-card)