Protokollfeil kontra verktøyfeil
Skill transportfeil fra feil i forretningslogikken.
Protokollfeil kontra verktøyfeil er en gratis leksjon i MCP Academy på CoddyKit. Dette er leksjon 2 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.
To svært forskjellige feil
MCP har to typer feil: en protocol-feil i selve overføringen, og en verktøyfeil inne i forretningslogikken. De håndteres på forskjellige måter.
Protokollfeil finnes i JSON-RPC
En protocol-feil betyr at meldingen ikke kunne behandles i det hele tatt, for eksempel fordi metoden er ukjent eller params er feil utformet. Den sendes i JSON-RPC-feiltfeltet.
{"jsonrpc": "2.0", "id": 7,
"error": {"code": -32601,
"message": "Method not found"}}Verktøyfeil finnes i resultatet
En tool-feil betyr at kallet nådde funksjonen din, men at arbeidet mislyktes. Den returnerer et normalt resultat merket med isError true.
Hvorfor skillet er viktig
Modellen bør se og reagere på tool-feil, mens protokollfeil vanligvis signaliserer en feil som klienten må håndtere, ikke noe AI-en kan prøve på nytt.
Standardiserte JSON-RPC-koder
Protokollens codes er negative og standardiserte: -32601 betyr at metoden ikke ble funnet, -32602 betyr ugyldige params, og -32700 betyr en tolkningsfeil.
Verktøyfeil når frem til modellen
Fordi en verktøyfeil bare er et result, leser modellen den som kontekst og kan velge å prøve på nytt, justere inndataene eller forklare feilen. 🔁
Hev et unntak i et verktøy
Når du hever et unntak i et verktøy, gjør FastMCP det om til et tool-feilresultat, ikke en protokollfeil. Serveren fortsetter å kjøre.
@mcp.tool()
def fetch(url: str) -> str:
if not url.startswith("http"):
raise ValueError("url must be http")Ukjent verktøy er en protokollfeil
Hvis en klient ber om et verktøy som ikke finnes, er det en protocol-feil. Forespørselen når aldri noen av funksjonene dine.
Ugyldige argumenter kan være begge deler
Typefeil på skjemanivå vises som en protocol-feil for ugyldige params, mens en gyldig type med en ugyldig verdi best håndteres som en verktøyfeil.
Tilpass feilen til mottakeren
Spør hvem som skal reagere. Hvis model kan rette feilen, bør den være en verktøyfeil. Hvis bare utvikleren kan gjøre noe med den, er en protokollfeil riktig.
Hold transportlaget friskt
La aldri forretningsproblemer lekke ut som protocol-feil. Det forvirrer klienter og kan avslutte en økt som egentlig burde fortsette.
Hurtigsjekk
Hvor rapporteres en feil inne i verktøyfunksjonen din?
Oppsummering
Protocol-feil betyr at selve meldingen mislyktes, mens verktøyfeil betyr at logikken din mislyktes. Send hver feil til den som kan gjøre noe med den, og hold transportlaget friskt. ✅
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 «Protokollfeil kontra verktøyfeil» gratis?
Ja – du kan lese valgfritt 3 av leksjonene i læringsstien MCP Academy, inkludert «Protokollfeil kontra verktøyfeil», 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 «Protokollfeil kontra verktøyfeil»?
Skill transportfeil fra feil i forretningslogikken. 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 2 av 4.
Hvor lang tid tar leksjonen «Protokollfeil kontra verktøyfeil»?
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
- Verktøyfeil modellen kan se
- Protokollfeil kontra verktøyfeil
- Validere inndata før handling
- Feile trygt uten å henge