Definire l'ambito del progetto e degli strumenti
Decida quali funzionalità esporrà il Suo server.
Definire l'ambito del progetto e degli strumenti è una lezione MCP Academy gratuita su CoddyKit. Questa è la lezione 1 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.
È ora di distribuire qualcosa di concreto
Ha imparato i vari elementi; ora costruirà un server completo. Questo progetto finale integra un servizio reale in un server MCP ordinato e installabile. 🚀
Iniziare dall'obiettivo dell'utente
Prima di scrivere codice, definisca il compito per cui il suo server è utile. Un obiettivo chiaro, come cercare nelle mie note, mantiene mirata e circoscritta ogni decisione successiva.
Scegliere un solo servizio reale
Scelga un singolo backend concreto: una cartella di note, un database SQLite o un'API pubblica. Una sola origine mantiene il progetto finale realizzabile, senza farlo diventare dispersivo.
Elencare le funzionalità
Annoti ciò che l'IA dovrebbe poter fare, ad esempio cercare, leggere e aggiungere. Questo breve elenco delle funzionalità diventa la mappa di strumenti e risorse.
Distinguere le azioni dalle letture
Divida l'elenco: le operazioni che modificano lo stato sono strumenti, mentre quelle che recuperano solo il contesto sono risorse. Questa distinzione determina in anticipo ogni primitiva.
Delineare le firme degli strumenti
Per ogni strumento, annoti un nome, i relativi argomenti e ciò che restituisce. Una rapida bozza della firma rivela gli input mancanti molto prima della scrittura della logica.
# add_note(title: str, body: str) -> str
# search_notes(query: str) -> list[str]
# A two-line sketch is enough to start.Pianificare una risorsa
Scelga un elemento di contesto in sola lettura da esporre come risorsa, ad esempio una singola nota identificata dal suo ID. Le risorse forniscono informazioni al modello senza eseguire azioni.
Pianificare un prompt
Aggiunga un prompt riutilizzabile che l'utente possa attivare, come riassumi questa nota. I prompt raccolgono le istruzioni migliori, evitando ai chiamanti di doverle riscrivere.
Definire subito cosa significa finito
Decida subito come sarà il risultato completato: il server si avvia, elenca tre strumenti e risponde a una richiesta reale. Un ambito chiaro impedisce l'aggiunta infinita di funzionalità.
Dare un nome al server
Dia al progetto un nome breve e descrittivo, come notes-mcp. I client mostrano questo nome agli utenti, quindi deve comunicare immediatamente a cosa serve.
from mcp.server.fastmcp import FastMCP
mcp = FastMCP("notes-mcp")Scrivere una specifica essenziale
Raccolga il piano in un breve file di specifica: obiettivo, backend, strumenti, risorsa e prompt. Questa pagina diventerà la checklist durante il resto dello sviluppo.
Controllo rapido
Verifichiamo come distinguere le funzionalità.
Riepilogo
Ha definito l'ambito di un progetto reale: un obiettivo, un backend e un elenco circoscritto di strumenti, una risorsa e un prompt. Un piano chiaro rende semplice lo sviluppo. 🎯
Domande Frequenti
La lezione «Definire l'ambito del progetto e degli strumenti» è gratuita?
Sì — il testo completo di «Definire l'ambito del progetto e degli 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 «Definire l'ambito del progetto e degli strumenti»?
Decida quali funzionalità esporrà il Suo server. 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 1 di 4.
Quanto tempo richiede la lezione «Definire l'ambito del progetto e degli 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
- Definire l'ambito del progetto e degli strumenti
- Implementare strumenti, risorse e prompt
- Testare, ispezionare e rafforzare la sicurezza
- Documentare e pubblicare il server