Versjonere verktøy og skjemaer
Videreutvikle serveren uten å ødelegge klientene.
Versjonere verktøy og skjemaer er en gratis leksjon i MCP Academy på CoddyKit. Dette er leksjon 4 av 4. Du kan lese valgfritt 3 leksjoner fra denne læringsstien gratis i sin helhet – deretter låser CoddyKit PRO opp alle leksjoner, samt praktisk øving med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt. Den er en del av læringsløpet i MCP Academy, og fremdriften din synkroniseres mellom nettet og CoddyKit-appen. Kurset i MCP Academy inneholder totalt 4 leksjoner.
Klienter er avhengige av formene Deres
Når andre først har koblet seg til, er de avhengige av verktøynavnene og argumentenes former. Hvis De endrer dem uforsiktig, slutter alle klientene å fungere samtidig.
Tilføyelser er trygge
Ved å legge til en valgfri parameter med en standardverdi fortsetter gamle kallere å fungere. De ignorerer ganske enkelt det nye feltet de ikke sender.
def search(q: str, limit: int = 10) -> list:
...Brudd på bakoverkompatibiliteten gjør vondt
Å gi et verktøy nytt navn, fjerne et argument eller gjøre et argument obligatorisk er et brudd. Eksisterende klienter sender plutselig kall som ikke lenger passer.
Legg til, og marker deretter som foreldet
For å videreutvikle et felt legger De til det nye og beholder det gamle. Marker det gamle som deprecated i beskrivelsen, slik at kallere vet at de må migrere.
Versjon i verktøynavnet
Ved et reelt brudd leverer De et v2-verktøy ved siden av v1. Begge kjører en stund, slik at klientene kan flytte over i sitt eget tempo.
@mcp.tool(name="search_v2")
def search_v2(query: str) -> list:
...Serveren rapporterer versjonen sin
Serveren Deres kunngjør et navn og en versjon under håndtrykket. Oppdater versjonen slik at klientene kan se hvilken utgave de koblet seg til.
mcp = FastMCP("my-server")
# version surfaces in server infoFølg semantisk versjonering
Bruk semver: øk patch-versjonen for rettelser, minor-versjonen for nye, bakoverkompatible funksjoner og major-versjonen når De gjør en endring som bryter kompatibiliteten. Tallet forteller en historie.
Gjør utdataene bredere, ikke smalere
Det er vanligvis trygt å legge til et felt i et resultat; å fjerne et felt er et brudd. Behandle output-skjemaet som et løfte klientene tolker.
Før en endringslogg
Registrer alle endringer i verktøy og skjemaer i en changelog. Brukere som oppgraderer, må kunne se hva som er flyttet, hva som er nytt og hva som er fjernet.
Gi foreldede funksjoner en sluttdato
Fortell når et gammelt verktøy skal fjernes. En tydelig sunset-dato får brukerne til å migrere uten at De plutselig trekker bort grunnlaget under noen.
Test mot gamle klienter
Før lansering kjører De testene slik en eldre klient ville ha kalt serveren. Da oppdager De utilsiktede brudd som typesjekkeren ikke kan se.
Hurtigsjekk
Hvilken endring i et eksisterende verktøy er trygg for nåværende klienter?
Oppsummering: trygg videreutvikling
Foretrekk additive endringer, marker funksjoner som foreldet før De fjerner dem, lever v2 ved reelle brudd, følg semver og før en endringslogg. De kan levere med trygghet! 🚀
Lær deg Python med en AI-veileder – gratis
Skriv og kjør ekte kode i nettleseren, få umiddelbar hjelp fra en AI-veileder som er tilgjengelig døgnet rundt, og fortsett der du slapp – på nettet eller i appen.
- Kurs
- 30
- Leksjoner
- 120
Ofte stilte spørsmål
Er leksjonen «Versjonere verktøy og skjemaer» gratis?
Ja – du kan lese valgfritt 3 av leksjonene i læringsstien MCP Academy, inkludert «Versjonere verktøy og skjemaer», gratis i sin helhet her på nettet. Deretter låser CoddyKit PRO opp alle leksjoner, samt interaktiv øving med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt. Kurset i MCP Academy inneholder totalt 4 leksjoner.
Hva lærer jeg i «Versjonere verktøy og skjemaer»?
Videreutvikle serveren uten å ødelegge klientene. Du øver på MCP Academy med praktisk kode som du kjører direkte i nettleseren, mens en AI-veileder som er tilgjengelig døgnet rundt, svarer på spørsmålene dine mens du jobber deg gjennom leksjonen.
Trenger jeg erfaring for å begynne med MCP Academy?
Ingen tidligere erfaring er nødvendig. MCP Academy på CoddyKit er lagt opp for både nybegynnere og viderekomne, så De kan begynne her eller helt fra start og lære i Deres eget tempo. Dette er leksjon 4 av 4.
Hvor lang tid tar leksjonen «Versjonere verktøy og skjemaer»?
De fleste CoddyKit-leksjoner tar omtrent 5–10 minutter. Hver leksjon er kort og interaktiv, slik at De gjør jevne fremskritt og kan fortsette akkurat der De slapp – både på nettet og i appen.
Kan jeg skrive og kjøre kode i denne MCP Academy-leksjonen?
Ja. Alle MCP Academy-leksjoner har en innebygd kodeeditor, slik at De kan skrive og kjøre ekte kode direkte i nettleseren og få umiddelbar tilbakemelding fra AI – uten lokal konfigurering.
Alle leksjonene i dette kurset
- Lagdelt serverarkitektur
- Konfigurasjon og hemmeligheter via miljøet
- Idempotente verktøy med kontroll på bivirkninger
- Versjonere verktøy og skjemaer