Vai al contenuto

Tutta la documentazione per sviluppatori

Il server MCP di Changeloop

Un server MCP che permette a un agente di lavorare sul tuo changelog dall'editor: leggere le voci in attesa, programmate e pubblicate, modificarle, pubblicarle subito o a un orario stabilito, oppure scartarle. Più sotto: come collegare Claude Code, i dieci strumenti e cosa un agente non può fare.

Il server MCP

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

Se lavori in Claude Code, ChatGPT o un altro agente che parla il Model Context Protocol, puoi collegarlo direttamente al tuo changelog. L'agente può quindi vedere cosa è in attesa di revisione, modificare il testo e pubblicare, senza che tu esca dall'editor. È la stessa porta di revisione della web app: nulla diventa pubblico finché qualcosa non lo approva.

Collegare Claude Code

Crea prima una chiave API (Impostazioni, Chiavi API), poi aggiungi il server con la tua chiave nell'intestazione:

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

Per un client che invece legge una configurazione JSON, la stessa cosa appare così:

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

Non c'è ancora un flusso OAuth. L'autenticazione è la chiave API nell'intestazione, che è esattamente ciò che fanno i due comandi sopra. Revocare quella chiave in Impostazioni disconnette l'agente alla sua richiesta successiva.

Cosa può fare l'agente

Dieci strumenti, e l'elenco è deliberatamente corto. Tutto il resto che questo prodotto può fare è raggiungibile tramite l'API REST con la stessa chiave; ogni strumento esposto a un agente è una cosa in più a cui può essere convinto a chiamare.

  • list_pending_entries, list_published_entries, get_entry - leggono le tue voci. Quelle in attesa non sono pubbliche.
  • update_entry - cambia il titolo o il corpo markdown di una voce. L'HTML servito dal feed viene ri-generato dal tuo markdown dal nostro sanitizzatore; un agente non può fornire HTML.
  • approve_entry - pubblica. È pubblico e immediato, e notifica qualsiasi feedback collegato su GitHub. Si può approvare solo una voce in attesa, oppure una voce programmata se passi publish_now: true, che la fa uscire subito invece che al suo orario.
  • discard_entry - tiene una voce fuori dal changelog. Reversibile dalla web app.
  • get_changelog_info - il tuo id feed e gli indirizzi da cui viene servito il tuo changelog.
  • list_scheduled_entries, schedule_entry, unschedule_entry - mostrano cosa è programmato, a partire dalla voce più vicina. Programmano l'uscita di una voce in attesa a un orario stabilito, indicato con il suo fuso orario, tra un minuto e 90 giorni da adesso, oppure la spostano a un nuovo orario. Annullano una programmazione, e la voce torna tra quelle in attesa. Un riepilogo non può essere programmato.

Cosa non può fare

Ogni strumento è limitato al team a cui appartiene la chiave, e nessuno di essi accetta un team come argomento, quindi non c'è nulla con cui puntare a un altro team anche se qualcuno ci provasse. Il server non accetta una sessione browser, solo una chiave: una richiesta deve allegare la credenziale deliberatamente. E una chiave non può gestire chiavi né scaricare la tua esportazione dati, quindi un agente collegato in questo modo non può crearsi una seconda credenziale né estrarre i tuoi dati in un'unica chiamata.

Chiavi API

Tutto quanto sopra è anonimo e non richiede credenziali. L'API autenticata, le tue impostazioni e la tua casella di revisione, è una superficie diversa, e accetta una sessione browser autenticata o una chiave API. Le chiavi sono per script e agenti: tutto ciò che deve raggiungere il tuo changelog senza una persona davanti alla tastiera.

Creane una nell'app, in Impostazioni, nella scheda Chiavi API. La chiave viene mostrata una volta, nel momento in cui la crei, e mai più: conserviamo solo un hash di essa, quindi non c'è alcuna schermata che possa mostrartela una seconda volta. Se la perdi, revocala e creane un'altra.

Rivedi il tuo changelog dall'editor

Changeloop scrive ogni voce a partire da una pull request unita e la tiene per la revisione, nell'app web o tramite questo server MCP. Gratis per un repository, senza carta.

Inizia gratis

Leggi la documentazione per sviluppatori