Pular para o conteúdo

Toda a documentação para desenvolvedores

O servidor MCP do Changeloop

Um servidor MCP para um agente trabalhar no seu changelog a partir do editor: ler entradas pendentes, agendadas e publicadas, editá-las, publicá-las agora ou em um horário definido, ou descartá-las. Abaixo: como conectar o Claude Code, as dez ferramentas e o que um agente não pode fazer.

O servidor MCP

POST https://api.changeloop.dev/mcp

Se você trabalha no Claude Code, ChatGPT ou outro agente que fala Model Context Protocol, pode conectá-lo diretamente ao seu changelog. O agente pode então ver o que está aguardando revisão, editar o texto e publicar, sem você sair do editor. É o mesmo portão de revisão do app web: nada se torna público sem que algo aprove.

Conectando o Claude Code

Primeiro crie uma chave de API (Configurações, Chaves de API), depois adicione o servidor com sua chave no cabeçalho:

claude mcp add --transport http changeloop \
  https://api.changeloop.dev/mcp \
  --header "Authorization: Bearer clapi_YOUR_KEY"

Para um cliente que lê uma configuração JSON em vez disso, a mesma coisa fica assim:

{
  "mcpServers": {
    "changeloop": {
      "type": "http",
      "url": "https://api.changeloop.dev/mcp",
      "headers": { "Authorization": "Bearer clapi_YOUR_KEY" }
    }
  }
}

Ainda não há um fluxo OAuth. A autenticação é a chave de API no cabeçalho, que é o que os dois comandos acima fazem. Revogar essa chave em Configurações desconecta o agente na próxima solicitação dele.

O que o agente pode fazer

Dez ferramentas, e a lista é deliberadamente curta. Qualquer outra coisa que este produto possa fazer é alcançável pela API REST com a mesma chave; toda ferramenta exposta a um agente é mais uma coisa que ele pode ser convencido a chamar.

  • list_pending_entries, list_published_entries, get_entry - leem suas entradas. As pendentes não são públicas.
  • update_entry - muda o título ou o corpo em markdown de uma entrada. O HTML que o feed serve é renderizado novamente a partir do seu markdown pelo nosso sanitizador; um agente não pode fornecer HTML.
  • approve_entry - publica. Isso é público e imediato, e notifica qualquer feedback vinculado no GitHub. Só uma entrada pendente pode ser aprovada, ou uma agendada quando você passa publish_now: true, o que a envia agora em vez de no horário marcado.
  • discard_entry - mantém uma entrada fora do changelog. Reversível pelo app web.
  • get_changelog_info - o ID do seu feed e os endereços onde seu changelog é servido.
  • list_scheduled_entries, schedule_entry, unschedule_entry - veem o que está agendado, do mais próximo ao mais distante. Agendam uma entrada pendente para sair em um horário definido, informado com o fuso horário, de um minuto a 90 dias à frente, ou a movem para um novo horário. E cancelam um agendamento, o que devolve a entrada às pendentes. Um resumo não pode ser agendado.

O que não pode fazer

Toda ferramenta é delimitada à equipe a que a chave pertence, e nenhuma delas aceita uma equipe como argumento, então não há nada para apontar a outra equipe mesmo que algo tentasse. O servidor não aceita uma sessão de navegador, apenas uma chave: uma solicitação precisa anexar a credencial deliberadamente. E uma chave não pode gerenciar chaves nem baixar sua exportação de dados, então um agente conectado dessa forma não pode gerar uma segunda credencial para si nem extrair seus dados em uma única chamada.

Chaves de API

Tudo acima é anônimo e não exige credencial. A API autenticada - suas configurações, sua caixa de revisão - é uma superfície diferente, e aceita uma sessão de navegador logada ou uma chave de API. Chaves são para scripts e agentes: qualquer coisa que precise alcançar seu changelog sem uma pessoa no teclado.

Crie uma no app em Configurações, na aba Chaves de API. A chave é mostrada uma vez, no momento em que você a cria, e nunca mais: armazenamos apenas um hash dela, então não existe nenhuma tela em lugar nenhum que possa mostrá-la a você uma segunda vez. Se perdê-la, revogue e crie outra.

Revise seu changelog a partir do editor

O Changeloop escreve cada entrada a partir de um pull request mesclado e guarda para revisão, no app web ou por este servidor MCP. Grátis para um repositório, sem cartão.

Começar grátis

Ler a documentação para desenvolvedores