Torna al Blog🇬🇧 Read in English

Il Model Context Protocol: come Claude parla ai tuoi strumenti

MCP è il protocollo aperto di Anthropic. Ecco cos'è, i quattro MCP server inclusi nel VibeCoded Orchestrator e come i nostri agenti li chiamano.

Prima di MCP

I modelli linguistici producono testo. Non possono leggere file, interrogare database o scaricare pagine senza un ponte. Prima del 2024, ogni vendor inventava il suo: function calling di OpenAI, schema di plugin per IDE, integrazioni vendor-specifiche.

Cos'è MCP (e cosa non è)

Model Context Protocol (MCP) è una specifica aperta annunciata da Anthropic a novembre 2024. La release attuale è datata 25 novembre 2025, governata tramite Spec Enhancement Proposal e Working Group su GitHub. La roadmap 2026 copre lo scaling del transport remoto, il nuovo primitivo Tasks per operazioni lunghe e auth/audit enterprise.

MCP è il protocollo che i nostri prodotti parlano. Un MCP server espone tre primitive:

  • Tools: funzioni invocabili con schema JSON
  • Resources: dati leggibili
  • Prompts: template riutilizzabili

Un client (Claude Code, Cursor, ecc.) avvia il server, legge gli schemi e decide quando chiamare. Wire format: JSON-RPC 2.0. Transport: stdio (subprocess locale) o HTTP (remoto). MCP è più pesante del function calling—esegui un processo separato—ma provider-indipendente e model-agnostico.

I quattro server

Il VibeCoded Orchestrator registra quattro server MCP:

  1. weaviate-kg: ricerca semantica su knowledge e code graph locali. Abilitato di default. Tool: hybrid_search, semantic_graph_search, store_knowledge_node, search_code_graph, query_code_structure, describe_excalidraw. Embedding: qwen3-embedding:0.6b (testo, 1024-d) e CodeSage-Large-v2 (codice, 2048-d).

  2. search: ricerca accademica. Abilitato di default. Un solo tool: search_papers, che interroga OpenAlex e arXiv. Nessuna API key richiesta.

  3. mermaid: descrive ed estrae diagrammi Mermaid così gli agenti possono leggere i tuoi schizzi di architettura. Registrato ma disabilitato di default — abilitalo per progetto dal tab Diagrams del launcher.

  4. excalidraw: la stessa superficie describe/extract per i disegni Excalidraw. Registrato ma disabilitato di default, stesso opt-in.

Un quinto server viaggia insieme agli altri: playwright (browser automation, il pacchetto ufficiale @playwright/mcp lanciato via npx), abilitato di default e pre-cachato all'install.

Nota cosa non è un server MCP. Il servizio di code-embedding che alimenta il code graph è un semplice servizio HTTP sulla porta 11440 — gli agenti non lo chiamano mai direttamente; è il server weaviate-kg a farlo, dietro le quinte. Ollama esegue gli embedding come infrastruttura sulla porta 11435, anch'esso fuori dal protocollo. MCP è il contratto rivolto all'agente; il lavoro pesante che gli agenti non devono ragionare resta fuori. Questa separazione mantiene piccoli gli schema dei tool — ogni descrizione di tool registrato costa context window a ogni turno, quindi la superficie deve guadagnarsi i suoi token.

Come gli agenti li usano davvero

Un trace concreto. Chiedi: "Come abbiamo gestito il rate limiting nei progetti passati?"

  1. Claude legge lo schema di weaviate-kg, sceglie hybrid_search.
  2. Invia {"query": "rate limiting patterns", "limit": 5} via stdio come chiamata JSON-RPC.
  3. Il server embedda la query, esegue ricerca ibrida keyword + vettoriale sul KG, restituisce 5 nodi con estratti.
  4. Claude sintetizza una risposta fondata su quei nodi reali — non allucinata.

La stessa forma si ripete lungo la superficie: query_code_structure per il contesto di refactoring ("chi chiama questa funzione?"), search_code_graph per trovare codice per scopo, search_papers quando un task ha bisogno di una citazione reale, store_knowledge_node per salvare una decisione che la prossima sessione dovrà ricordare. Gli agenti chiamano tool MCP invece di grep. Questo è il punto.

Aggiungere il livello di team

Questi server coprono il workflow del singolo sviluppatore. Per il coordinamento di team—decisioni condivise, messaggi cross-macchina, rationale delle decisioni—spediamo un modulo a pagamento separato, la Coordination MCP, appoggiata su un progetto Supabase condiviso e incluso con VCO Pro e MAO. Stesso protocollo. Vedi /products/coordination-mcp e il post sul coordinamento di team.

Un Telegram Module MCP pianificato esporrà chat Telegram come tool surface per pilotare l'orchestrator dal telefono.

Dove ci collochiamo nell'ecosistema MCP

A inizio 2026 MCP è lo standard cross-vendor dominante per l'accesso AI agli strumenti. OpenAI ha adottato MCP a marzo 2025 ed esteso il supporto alle ChatGPT apps a settembre 2025. Registry pubblici indicizzano migliaia di server community.

ClientSupporto MCPOpen source
Claude Desktop / Claude CodeNativoSì protocollo, no client
VibeCoded OrchestratorNativo, 4 server registrati + playwright + Coord MCP tier Pro
Cursor / WindsurfNo
Cline / Zed / Continue.dev
VS Code + CopilotParziale
OpenAI ChatGPT / AppsSì (dal 2025)No
LangChain / LangGraphVia adapter

Ogni MCP server per Claude Code funziona con l'Orchestrator. Spediamo i default; puoi aggiungere server community. Il function calling sopravvive per use case single-vendor, bassa latenza. Per tutto model-indipendente, MCP vince.

I server MCP qui sopra sono inclusi gratuitamente nel VibeCoded Orchestrator — locali, aperti, sotto il tuo controllo. Il livello di team-sync è la Coordination MCP, inclusa con VCO Pro e MAO.

Sources: