Passa al contenuto principale

Tool MCP

Obiettivo: dichiarare un server Model Context Protocol e citarne i tool in un agente.

Prerequisiti​

  • Il comando che avvia il server MCP (per esempio npx -y tavily-mcp), installabile sul worker.

Passi​

  1. Dichiara il server con il kind McpServer e il comando che lo avvia:

    apiVersion: afe.dev/v1alpha1
    kind: McpServer
    metadata:
      name: websearch
    spec:
      transport: stdio
      command:
        - npx
        - -y
        - tavily-mcp

  2. Cita i suoi tool in un agente come mcp:<server>.<tool> oppure mcp:<server>.*.

  3. Esegui il flow. Il plugin afe-mcp si connette una volta per processo ed espone i tool del server.

Note​

Un server che non risponde fa fallire solo l'operazione che lo richiede, mai il motore.

note

Gli harness degli agenti (basic, deep, acp) arrivano nella milestone successiva. Fino ad allora i provider e i tool sono cablati, ma un run --dry non usa alcun provider.

Risoluzione dei problemi​

unknown MCP server 'websearch' Nessun manifesto McpServer chiamato websearch è nella configurazione. Controlla il nome nella lista tools dell'agente rispetto all'McpServer che hai dichiarato.

MCP server 'websearch' has no tool 'search' (known: fetch, extract) Il nome del tool dopo il punto non corrisponde a un tool che il server riporta. L'errore elenca i tool che il server ha davvero. Cita uno di quelli, oppure usa mcp:websearch.* per tutti.

unknown tool 'websearch' (expected 'mcp:<server>.<tool|*>') Manca il prefisso mcp: o la parte .<tool> nel riferimento. Usa la forma completa, mcp:<server>.<tool> oppure mcp:<server>.*.

Vedi anche​