Trasformare un'API REST in strumenti
Trasformi endpoint esterni in strumenti invocabili.
Trasformare un'API REST in strumenti è una lezione MCP Academy gratuita su CoddyKit. Questa è la lezione 2 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento MCP Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso MCP Academy include 4 lezioni in totale.
Trasformare gli endpoint in strumenti
Qualsiasi API REST può diventare costituita da strumenti MCP. Ogni endpoint diventa una funzione chiamabile che il modello può invocare per recuperare o inviare dati. 🌐
Chiamare HTTP da uno strumento
All'interno di uno strumento si esegue una normale richiesta HTTP, quindi si restituisce la risposta come testo che il modello può leggere e analizzare.
Preferire un client asincrono
Usi un client asincrono come httpx, così una chiamata lenta all'API non blocca le altre richieste mentre attende la rete.
import httpx
async with httpx.AsyncClient() as client:
r = await client.get(url)Associare i parametri agli argomenti
Esponga la query dell'endpoint come argomenti dello strumento. Il modello passa una città o un ID, che lei inserisce nella richiesta in modo sicuro.
@mcp.tool()
async def get_weather(city: str) -> str:
...Mantenere i segreti sul server
Conservi la key dell'API nell'ambiente del server, mai come argomento dello strumento. Il modello non dovrebbe mai vedere né inviare credenziali.
key = os.environ["WEATHER_API_KEY"]Controllare il codice di stato
Esamini lo status HTTP prima di considerare attendibile il corpo della risposta. Un 404 o un 500 richiede un errore chiaro, non dati inutilizzabili.
r.raise_for_status()Analizzare e ridurre il JSON
La maggior parte delle API restituisce JSON. Lo analizzi e restituisca soltanto i fields necessari all'attività, così il modello non viene sommerso da informazioni superflue.
data = r.json()
return data["temp_c"]Affidare a ogni strumento un solo compito
Associare un endpoint a uno strumento mirato con un nome chiaro. Gli strumenti granulari sono più facili da scegliere correttamente per il modello.
Scrivere descrizioni utili
Descriva cosa fa l'endpoint e quando usarlo. Una descrizione precisa permette al modello di capire che deve chiamare proprio questo strumento.
Gestire i guasti di rete
Racchiuda la chiamata in modo che un timeout o un'interruzione della connessione restituisca un messaggio di errore leggibile invece di arrestare l'intero server.
Impostare timeout ragionevoli
Passi sempre un timeout, così un servizio upstream bloccato non può congelare lo strumento in attesa infinita di una risposta che non arriverà.
r = await client.get(url, timeout=10.0)Controllo rapido
Dove dovrebbe trovarsi una chiave API?
Riepilogo: REST come strumenti
Ha incapsulato gli endpoint come strumenti async: argomenti in ingresso, chiavi lato server, controlli dello stato e JSON ridotto in uscita. Ora metta in pool le connessioni. 🎯
Domande Frequenti
La lezione «Trasformare un'API REST in strumenti» è gratuita?
Sì — il testo completo di «Trasformare un'API REST in strumenti» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso MCP Academy, passa a CoddyKit PRO. Il corso MCP Academy include 4 lezioni in totale.
Cosa imparerò in «Trasformare un'API REST in strumenti»?
Trasformi endpoint esterni in strumenti invocabili. Eserciti MCP Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare MCP Academy?
Non è richiesta alcuna esperienza precedente. MCP Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 2 di 4.
Quanto tempo richiede la lezione «Trasformare un'API REST in strumenti»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione MCP Academy?
Sì. Ogni lezione MCP Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Esporre query SQL in sicurezza
- Trasformare un'API REST in strumenti
- Gestire un pool di connessioni nel ciclo di vita
- Memorizzare nella cache e limitare il rate degli upstream