Shipstar

Marketing automatizado de productos desde tus commits: genera, revisa, publica y envía por correo changelogs, publicaciones de blog y notas de versión a través de MCP (OAuth 2.1, alojado).

Ver en shipstar.aiPrueba este MCPPatrocinado

Documentación

Descripción general del servidor MCP de Shipstar

Usa el contenido publicado de Shipstar directamente desde agentes LLM a través del Protocolo de Contexto de Modelo

Shipstar expone su pipeline completo como herramientas del Protocolo de Contexto de Modelo (MCP) para que agentes LLM — claude.ai, Claude Code, Claude Desktop, Cursor, Windsurf, agentes personalizados y cualquier otra cosa que hable MCP — puedan generar contenido de marketing a partir de tus commits, revisar y revisar borradores, publicarlos y enviar correos de lanzamiento, así como leer tus changelogs publicados, publicaciones de blog y artículos de la base de conocimientos.

Mismos servicios, mismas garantías que el panel de control — las herramientas llaman a las mismas rutas de código de revisión/publicación/entrega — presentadas como herramientas tipadas que el modelo puede llamar directamente.

Endpoint

El servidor MCP está montado en el backend principal de Shipstar utilizando el transporte Streamable HTTP.

POST https://mcp.shipstar.ai/mcp

Autenticación

Dos formas de acceso:

OAuth 2.1 (recomendado — lo que usa claude.ai). Añade el endpoint como conector personalizado e inicia sesión; no se necesita manejo de tokens. Cada autorización está limitada a un proyecto, elegido en la pantalla de consentimiento. Flujo completo y detalles del protocolo: OAuth.

Token API estático (para scripts y CI). Cada token del panel de control funciona como token bearer en /mcp — los mismos tokens que protegen la API REST V1. Crea uno en Configuración → Tokens API (/dashboard/console); el token está vinculado al proyecto en el que se creó.

Authorization: Bearer YOUR_API_TOKEN

Las solicitudes sin token, o con un token inválido/expirado, devuelven 401 Unauthorized con un desafío WWW-Authenticate que permite a los clientes compatibles con OAuth arrancar automáticamente.

Conexión desde claude.ai

Configuración → Conectores → Añadir conector personalizado → introduce https://mcp.shipstar.ai/mcp → Conectar → inicia sesión y elige un proyecto. Consulta OAuth para el paso a paso.

Conexión desde Claude Code

El camino más rápido es el plugin oficial, que incluye la conexión al servidor más habilidades de agente guiadas — /shipstar:announce-release, /shipstar:write-blog-post, /shipstar:email-your-users y /shipstar:build-changelog-page:

/plugin marketplace add shipstar-ai/shipstar-plugin
/plugin install shipstar@shipstar

O añade el servidor directamente:

claude mcp add --transport http shipstar https://mcp.shipstar.ai/mcp

De cualquier manera, Claude Code ejecuta el flujo OAuth en tu navegador en el primer uso. Para fijar un token estático en su lugar, añade --header "Authorization: Bearer YOUR_API_TOKEN" al formulario claude mcp add.

Conexión desde Claude Desktop

Añade el servidor a tu claude_desktop_config.json, incluyendo un token bearer como encabezado personalizado:

{
  "mcpServers": {
    "shipstar": {
      "type": "http",
      "url": "https://mcp.shipstar.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Reinicia Claude Desktop y las herramientas de Shipstar estarán disponibles en cualquier chat.

Conexión desde Cursor / Windsurf

Ambos editores aceptan la misma configuración de servidor MCP. Añade una entrada con la URL anterior y las herramientas aparecerán en la barra lateral del agente.

Herramientas disponibles

Generación (iniciar contenido desde commits)

Herramienta	Descripción
`generate_changelog`	Generar un changelog público a partir de commits recientes
`generate_blog_post`	Generar una publicación de blog (opcionalmente guiada por una idea)
`generate_blog_post_ideas`	Lluvia de ideas para ángulos de publicaciones de blog (síncrono)
`generate_feature_page`	Generar una página de aterrizaje de características de marketing
`generate_kb_articles`	Generar un conjunto de artículos de base de conocimientos
`generate_release_notes_email`	Generar un correo de notas de lanzamiento
`generate_twitter_thread`	Generar un hilo de X (Twitter)
`generate_linkedin_post`	Generar una publicación de LinkedIn

Las herramientas de generación (excepto generate_blog_post_ideas) devuelven un content_id pendiente y se ejecutan en segundo plano — consulta get_generation_status para ver la finalización.

Ciclo de vida (revisar, modificar, aprobar, publicar)

Herramienta	Descripción
`get_generation_status`	Consultar el estado de un trabajo de generación
`get_content_draft`	Leer el borrador completo de un registro de contenido
`update_content`	Revisar el texto y/o categoría de un borrador
`approve_content`	Aprobar contenido para publicación
`publish_content`	Publicar contenido completado directamente

Proyecto y entrega

Herramienta	Descripción
`get_project_context`	Describir el proyecto de la conexión: repos, destinos, listas de correo
`list_destinations`	Listar destinos de entrega conectados
`list_mailing_lists`	Listar listas de correo para correos de notas de lanzamiento
`send_release_email`	Enviar un correo de notas de lanzamiento a listas de correo

Lectura (obtener contenido publicado)

Herramienta	Descripción
`list_changelogs`	Listar los changelogs publicados del proyecto, más recientes primero
`get_changelog`	Obtener un changelog individual por slug
`list_blog_posts`	Listar las publicaciones de blog publicadas del proyecto, más recientes primero
`get_blog_post`	Obtener una publicación de blog individual por slug
`list_kb_article_sets`	Listar los conjuntos de artículos de base de conocimientos publicados del proyecto
`get_kb_article_set`	Obtener un conjunto de artículos de KB individual por slug

Casos de uso

Apunta un agente de soporte a `list_changelogs` / `get_changelog` para que pueda responder "¿qué hay de nuevo esta semana?" y citar la versión exacta que lanzó una característica — sin que tengas que copiar notas de lanzamiento en una base de conocimientos. Deja que un agente de codificación (Cursor, Claude Code, Windsurf) obtenga tus últimos tutoriales de blog y artículos de KB bajo demanda. El agente fundamenta sus respuestas en tu guía publicada en lugar de alucinar APIs. Al redactar páginas de aterrizaje, anuncios o campañas de correo, haz que Claude obtenga changelogs y publicaciones de blog recientes para extraer detalles precisos del producto, citas y capturas de pantalla del material que ya has lanzado. Pide a un agente que resuma los últimos N changelogs en una actualización semanal o mensual. La salida de la herramienta es estructurada, por lo que el modelo no tiene que hacer scraping de tu sitio web. Expón `list_kb_article_sets` / `get_kb_article_set` a un agente interno para que los empleados puedan preguntar "¿cómo hago X?" en Slack y obtener respuestas extraídas de tu KB publicado. Cualquier framework de agentes que hable MCP (LangGraph, Agent SDK, Mastra, personalizado) puede extraer contenido de Shipstar como fuente de datos de solo lectura sin que escribas un cliente REST a medida.

Cómo funciona internamente

Las herramientas MCP llaman directamente a la misma capa app.services.content que impulsa los endpoints REST V1. Eso significa:

Una única fuente de verdad. Cualquier corrección de errores o cambio de comportamiento en el servicio de contenido fluye automáticamente a ambos transportes.
Solo se devuelve contenido publicado. Los borradores, elementos pendientes y filas de tipo incorrecto se filtran en la capa de servicio.
Omisión elegante de datos inválidos. Los endpoints de listado omiten filas cuyo JSON almacenado está malformado en lugar de fallar toda la llamada.

Si necesitas un control más fino (paginación, feeds RSS, filtrado personalizado) o estás construyendo una integración que no sea de agente, usa la API REST V1 directamente.

Esta documentación está construida y alojada en Mintlify, una plataforma de documentación para desarrolladores.