Shipstar

Marketing automatizado de produtos a partir dos seus commits: gere, revise, publique e envie changelogs, posts de blog e notas de versão via MCP (OAuth 2.1, hospedado).

Ver em shipstar.aiExperimente este MCPPatrocinado

Documentação

Visão Geral do Servidor MCP Shipstar

Use o conteúdo publicado do Shipstar diretamente de agentes LLM via Model Context Protocol

O Shipstar expõe todo o seu pipeline como ferramentas Model Context Protocol (MCP) para que agentes LLM — claude.ai, Claude Code, Claude Desktop, Cursor, Windsurf, agentes personalizados e qualquer outra coisa que fale MCP — possam gerar conteúdo de marketing a partir dos seus commits, revisar e revisar rascunhos, publicá-los e enviar e-mails de lançamento, bem como ler seus changelogs, posts de blog e artigos da base de conhecimento publicados.

Mesmos serviços, mesmas garantias do dashboard — as ferramentas chamam os mesmos caminhos de código de revisão/publicação/entrega — apresentados como ferramentas tipadas que o modelo pode chamar diretamente.

Endpoint

O servidor MCP está montado no backend principal do Shipstar usando o transporte Streamable HTTP.

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

Autenticação

Duas formas de acesso:

OAuth 2.1 (recomendado — o que o claude.ai usa). Adicione o endpoint como um conector personalizado e faça login; nenhum tratamento de token é necessário. Cada autorização é limitada a um projeto, escolhido na tela de consentimento. Fluxo completo e detalhes do protocolo: OAuth.

Token de API estático (para scripts e CI). Todo token de API do dashboard funciona como um token bearer em /mcp — os mesmos tokens que protegem a API REST V1. Crie um em Configurações → Tokens de API (/dashboard/console); o token está vinculado ao projeto em que foi criado.

Authorization: Bearer YOUR_API_TOKEN

Requisições sem token, ou com token inválido/expirado, retornam 401 Unauthorized com um desafio WWW-Authenticate que permite que clientes compatíveis com OAuth façam bootstrap automaticamente.

Conectando pelo claude.ai

Configurações → Conectores → Adicionar conector personalizado → insira https://mcp.shipstar.ai/mcp → Conectar → faça login e escolha um projeto. Veja OAuth para o passo a passo.

Conectando pelo Claude Code

O caminho mais rápido é o plugin oficial, que inclui a conexão do servidor mais habilidades de agente guiadas — /shipstar:announce-release, /shipstar:write-blog-post, /shipstar:email-your-users e /shipstar:build-changelog-page:

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

Ou adicione o servidor diretamente:

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

De qualquer forma, o Claude Code executa o fluxo OAuth no seu navegador no primeiro uso. Para fixar um token estático, acrescente --header "Authorization: Bearer YOUR_API_TOKEN" ao formulário claude mcp add.

Conectando pelo Claude Desktop

Adicione o servidor ao seu claude_desktop_config.json, incluindo um token bearer como cabeçalho personalizado:

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

Reinicie o Claude Desktop e as ferramentas do Shipstar estarão disponíveis em qualquer chat.

Conectando pelo Cursor / Windsurf

Ambos os editores aceitam a mesma configuração de servidor MCP. Adicione uma entrada com a URL acima e as ferramentas aparecerão na barra lateral do agente.

Ferramentas Disponíveis

Geração (inicie conteúdo a partir de commits)

Ferramenta	Descrição
`generate_changelog`	Gere um changelog público a partir de commits recentes
`generate_blog_post`	Gere um post de blog (opcionalmente orientado por uma ideia)
`generate_blog_post_ideas`	Faça brainstorming de abordagens para posts de blog (síncrono)
`generate_feature_page`	Gere uma página de destino de recurso de marketing
`generate_kb_articles`	Gere um conjunto de artigos da base de conhecimento
`generate_release_notes_email`	Gere um e-mail de notas de versão
`generate_twitter_thread`	Gere um tópico do X (Twitter)
`generate_linkedin_post`	Gere um post do LinkedIn

As ferramentas de geração (exceto generate_blog_post_ideas) retornam um content_id pendente e executam em segundo plano — consulte get_generation_status para verificar a conclusão.

Ciclo de vida (revisar, revisar, aprovar, publicar)

Ferramenta	Descrição
`get_generation_status`	Consulte o status de um job de geração
`get_content_draft`	Leia o rascunho completo de um registro de conteúdo
`update_content`	Revise o texto e/ou categoria de um rascunho
`approve_content`	Aprove conteúdo para publicação
`publish_content`	Publique conteúdo concluído diretamente

Projeto e entrega

Ferramenta	Descrição
`get_project_context`	Descreva o projeto da conexão: repositórios, destinos, listas de e-mail
`list_destinations`	Liste os destinos de entrega conectados
`list_mailing_lists`	Liste as listas de e-mail para e-mails de notas de versão
`send_release_email`	Envie um e-mail de notas de versão para listas de e-mail

Leitura (busque conteúdo publicado)

Ferramenta	Descrição
`list_changelogs`	Liste os changelogs publicados do projeto, do mais recente ao mais antigo
`get_changelog`	Busque um único changelog por slug
`list_blog_posts`	Liste os posts de blog publicados do projeto, do mais recente ao mais antigo
`get_blog_post`	Busque um único post de blog por slug
`list_kb_article_sets`	Liste os conjuntos de artigos da base de conhecimento publicados do projeto
`get_kb_article_set`	Busque um único conjunto de artigos da KB por slug

Casos de Uso

Aponte um agente de suporte para `list_changelogs` / `get_changelog` para que ele possa responder "o que há de novo esta semana?" e citar a versão exata que lançou um recurso — sem que você precise copiar notas de versão para uma base de conhecimento. Deixe um agente de codificação (Cursor, Claude Code, Windsurf) buscar seus tutoriais de blog e artigos da KB mais recentes sob demanda. O agente fundamenta suas respostas na sua documentação publicada em vez de alucinar APIs. Ao redigir páginas de destino, anúncios ou campanhas de e-mail, peça ao Claude para buscar changelogs e posts de blog recentes para obter detalhes precisos do produto, citações e capturas de tela do material que você já publicou. Peça a um agente para resumir os últimos N changelogs em uma atualização semanal ou mensal. A saída da ferramenta é estruturada, então o modelo não precisa fazer scraping do seu site. Exponha `list_kb_article_sets` / `get_kb_article_set` a um agente interno para que funcionários possam perguntar "como faço X?" no Slack e obter respostas baseadas na sua KB publicada. Qualquer framework de agente que fale MCP (LangGraph, Agent SDK, Mastra, personalizado) pode puxar conteúdo do Shipstar como uma fonte de dados somente leitura sem que você precise escrever um cliente REST personalizado.

Como funciona internamente

As ferramentas MCP chamam diretamente a mesma camada app.services.content que alimenta os endpoints REST V1. Isso significa:

Uma única fonte de verdade. Qualquer correção de bug ou mudança de comportamento no serviço de conteúdo flui automaticamente para ambos os transportes.
Apenas conteúdo publicado é retornado. Rascunhos, itens pendentes e linhas de tipo errado são filtrados na camada de serviço.
Pular graciosamente dados inválidos. Endpoints de listagem pulam linhas cujo JSON armazenado está malformado em vez de falhar a chamada inteira.

Se você precisar de controle mais fino (paginação, feeds RSS, filtragem personalizada) ou estiver construindo uma integração não baseada em agente, use a API REST V1 diretamente.

Esta documentação é construída e hospedada no Mintlify, uma plataforma de documentação para desenvolvedores.