Usa Hermoso desde cualquier cliente MCP

El servidor de Hermoso es un servidor normal de Model Context Protocol, así que “¿qué cliente?” es sobre todo una cuestión de sintaxis de configuración, no de capacidad. Hay dos formas de entrar y ambas llegan a las mismas más de 922+ herramientas.

Los dos transportes

• Alojado, HTTP en streaming: https://app.hermoso.ai/mcp. Es el que más clientes quieren. Admite OAuth con registro dinámico de clientes y PKCE, así que un cliente que sigue el flujo de autorización completo no necesita ninguna clave; un cliente que no lo hace puede enviar un encabezado Authorization: Bearer hmk_… en su lugar. Ten en cuenta que es solo HTTP en streaming. No hay endpoint HTTP+SSE legado, así que un cliente que solo habla el transporte antiguo no tiene a qué conectarse aquí.
• stdio, vía npm: npx -y hermoso mcp, con tu clave en HERMOSO_TOKEN. Cualquier cliente MCP por stdio puede cargarlo. El mismo paquete también es una CLI (npm install -g hermoso), que es la vía económica en tokens para los agentes de terminal: ejecutan un comando por vez en lugar de llevar un manifiesto de más de 922 herramientas en cada turno.

Los agentes pueden descubrir automáticamente la tarjeta del servidor en /.well-known/mcp.json, y está listado en el registro oficial de MCP como io.github.hermoso-ai/hermoso.

El bloque de configuración genérico

La mayoría de clientes aceptan alguna variante de esto:

{ "mcpServers": { "hermoso": {
    "url": "https://app.hermoso.ai/mcp",
    "headers": { "Authorization": "Bearer <your key>" }
} } }

Crea la clave en Hermoso en MCP y CLI → Terminal y claves API. Un cliente es una excepción real: Codex lee TOML, no JSON, así que un bloque mcpServers copiado no se cargará allí. Consulta la página de Codex para ver las cuatro líneas que necesita.

Clientes con su propia página

• Claude: se conecta con OAuth, sin nada que pegar.
• ChatGPT: se conecta con OAuth, sin nada que pegar.
• Claude Code: inicia sesión desde la terminal con hermoso auth login, sin nada que pegar; como es un agente de terminal, la CLI es la vía más económica para ejecuciones largas.
• Cursor: inicia sesión desde la terminal con hermoso auth login, sin nada que pegar.
• Codex: inicia sesión desde la terminal con hermoso auth login, sin nada que pegar; como es un agente de terminal, la CLI es la vía más económica para ejecuciones largas.
• Cline: acepta una clave de API en un encabezado Authorization.
• OpenClaw: inicia sesión desde la terminal con hermoso auth login, sin nada que pegar; como es un agente de terminal, la CLI es la vía más económica para ejecuciones largas.
• Grok Bot: añade la plantilla Hermoso Marketing Bot y acepta una clave de API en el chat, o inicia sesión desde la terminal del propio Bot.
• Hermes: inicia sesión desde la terminal con hermoso auth login, sin nada que pegar; como es un agente de terminal, la CLI es la vía más económica para ejecuciones largas.
• Gemini CLI: inicia sesión desde la terminal con hermoso auth login, sin nada que pegar; como es un agente de terminal, la CLI es la vía más económica para ejecuciones largas.
• Perplexity: se conecta con OAuth, sin nada que pegar.
• Le Chat: se conecta con OAuth, sin nada que pegar.
• Claude Cowork: se conecta con OAuth, sin nada que pegar.
• Perplexity Computer: se conecta con OAuth, sin nada que pegar.
• Paperclip: se conecta con OAuth, sin nada que pegar.
• Gemini: se conecta con OAuth, sin nada que pegar.
• Grok Build: inicia sesión desde la terminal con hermoso auth login, sin nada que pegar; como es un agente de terminal, la CLI es la vía más económica para ejecuciones largas.
• Kimi Code: añade la URL alojada a mcp.json e inicia sesión con /mcp-config login, sin nada que pegar; como es un agente de terminal, la CLI es la vía más económica para ejecuciones largas.
• DeepSeek Harness: inicia sesión desde la terminal con hermoso auth login y ejecuta Hermoso como servidor local, sin nada que pegar.
• Manus: acepta una clave de API en un encabezado Authorization.
• Muse, se configura con un mensaje de chat que se conecta con OAuth, sin nada que pegar.

Hay cuatro clientes que deliberadamente no tienen página propia, y conviene decir por qué en lugar de dar a entender un soporte más amplio del que hemos probado. VS Code: Hermoso publica un enlace profundo de VS Code de un clic, pero no hay ningún bloque de instalación de VS Code en el producto ni una ruta probada, así que no hay una página que afirme tenerlo. El enlace profundo instala solo el endpoint y deja la autenticación al OAuth de VS Code. Claude Desktop: Claude Desktop usa el mismo flujo de Conectores que claude.ai, así que está cubierto por la página de Claude y no se duplica. Grok: el chat de Grok se conecta hoy mediante la tarjeta de configuración en /mcp; no tiene página propia todavía porque su copia por canal duplicaría las páginas de ChatGPT sin aportar nada que solo nosotros podamos decir. Muse: Meta Muse se configura con un mensaje de chat y no con una pantalla de ajustes, así que su guía se escribe a mano en hermoso.ai/muse y no se genera aquí.

Todos los canales, desde cualquiera de ellos

El cliente no cambia lo que se puede alcanzar. Desde cualquiera de ellos: publicar y programar en Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram, Google Business Profile; investigar las bibliotecas de anuncios de Meta, Google y LinkedIn más TikTok, Instagram, YouTube, Reddit y Threads orgánicos; renderizar anuncios terminados de imagen y video con más de 100 modelos; y crear campañas en Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads y AppLovin Ads.

Una superficie de publicación está construida pero retenida, a la espera de la plataforma: Reddit. La publicación orgánica y las estadísticas de publicaciones están construidas, pero la Responsible Builder Policy de Reddit exige una aprobación escrita explícita antes de que una app use la Data API, y esa solicitud no ha sido concedida. El conector se retiene en lugar de ofrecer una pantalla de OAuth que lleve a una API inactiva. Reddit Ads es otra conexión y está activa: el árbol de campañas completo, previsiones, búsqueda de segmentación, píxeles y formularios de clientes potenciales.

Lo que ningún cliente puede hacer por sí solo

Un agente con presupuesto solo es útil si el alcance de sus acciones está acotado, así que el límite está en el servidor y no en un prompt. Cada campaña, conjunto de anuncios, grupo de anuncios y anuncio publicitario se crea en pausa, y los interruptores de estado que activan dinero real se niegan a ejecutarse sin una marca de confirmación explícita. Cada render se cotiza primero (hermoso_capabilities publica el costo exacto en créditos de cada modelo antes de que se gaste nada). Los créditos se reservan antes de la primera llamada al proveedor y se liquidan al costo exacto después, así que un envío fallido se reembolsa en lugar de dejarte cobrado por nada. Los borrados también requieren confirmación, y cada árbol de campañas se vuelve a leer desde la plataforma publicitaria antes de que tu agente te diga qué creó.

Un paso lo decides tú: vincular cada cuenta, una vez. La mayoría de canales se vinculan a través de la pantalla de consentimiento OAuth de la propia plataforma en un navegador; Bluesky pide una contraseña de aplicación y Telegram un token de bot, que pegas en Hermoso. Todo lo que viene después es una llamada a una herramienta.

Preguntas frecuentes

¿Hermoso funciona con cualquier cliente MCP?

Por stdio, sí. Cualquier cliente que pueda lanzar npx -y hermoso mcp obtiene las más de 922+ herramientas. Por el endpoint alojado, solo funciona HTTP en streaming: no hay ruta HTTP+SSE legada, así que un cliente que solo habla el transporte antiguo no tiene a qué conectarse.

¿Necesito una clave de API o funciona OAuth?

Existen ambas rutas. El endpoint alojado admite OAuth con registro dinámico de clientes y PKCE, que es como los conectores de Claude, ChatGPT, Perplexity, Le Chat, Claude Cowork, Perplexity Computer, Paperclip y Gemini inician sesión sin pegar nada. Los clientes que inician un proceso local inician sesión una vez con hermoso auth login, y un cliente que no puede hacer ninguna de las dos cosas envía una clave de API (hmk_…) en un encabezado Authorization: Bearer, que se crea en la pestaña MCP y CLI, en Terminal y claves API.

¿Cuál es la URL del endpoint MCP?

https://app.hermoso.ai/mcp, declarada como remoto de HTTP en streaming en la tarjeta del servidor en /.well-known/mcp.json. El paquete es hermoso en npm e io.github.hermoso-ai/hermoso en el registro oficial de MCP.