Jev per agenti: server MCP remoto e agent skill (jevmodel.org)

Server MCP remoto: quattro strumenti tipizzati

jevmodel.org gestisce un server MCP remoto su https://jevmodel.org/mcp via Streamable HTTP. Espone jev_decide (il contratto completo — state più fino a 8 domande tipizzate in una chiamata) e tre strumenti di comodo per i casi comuni: jev_noul per probabilità sì/no, jev_choice per opzioni etichettate, jev_score per punteggi di rubrica.

L’autenticazione è la tua normale chiave API jevmodel.org come header Bearer — nessuna credenziale separata, stesso saldo di token, stesso limite di 120 richieste/minuto.

# Claude Code
claude mcp add --transport http jev https://jevmodel.org/mcp \
  --header "Authorization: Bearer $JEVMODEL_API_KEY"

# Cursor / altri client — configurazione server
{
  "mcpServers": {
    "jev": {
      "url": "https://jevmodel.org/mcp",
      "headers": { "Authorization": "Bearer sk-..." }
    }
  }
}

La skill agente

Leggi il SKILL.md grezzo — endpoint, forma della richiesta, manuale e limiti.

MCP dà gli strumenti al tuo agente; il SKILL.md gli insegna i pattern di giudizio: quando una decisione tipizzata batte una chiamata LLM, come raggruppare le domande in una richiesta, come fissare la soglia di una probabilità noul e come scrivere criteria che reggano in produzione. Metti il file nella directory skills del tuo agente — viene adottato automaticamente.

# Claude Code / agenti
curl -o .claude/skills/jev/SKILL.md --create-dirs \
  https://jevmodel.org/skills/jev/SKILL.md

# oppure nel layout stile Devin
curl -o .devin/skills/jev/SKILL.md --create-dirs \
  https://jevmodel.org/skills/jev/SKILL.md

Esempio pratico: un guardrail prima di una chiamata a strumento

Il pattern più usato dagli agenti: prima di eseguire qualcosa di rischioso, chiedi a Jev un giudizio tipizzato sull’azione proposta e applica una soglia alla probabilità.

{
  "state": {
    "action": "bash",
    "command": "rm -rf ./dist && pnpm build",
    "cwd": "/srv/app",
    "recent_errors": 0
  },
  "questions": {
    "allow": {
      "type": "noul",
      "instructions": "Is this command safe to run without asking the user? Destructive paths outside the project, credential files or force-pushes are not safe."
    }
  }
}

# → answers.allow.noul ≥ 0.9: esegui
# → 0.6–0.9: mostra il comando e chiedi
# → < 0.6: blocca

Fatturazione e limiti

Stesso saldo del playground e di /v1/systemone — 100.000 token di input gratis all’accesso, pacchetti da $9,90 che non scadono
Solo token di input; output gratis; le chiamate fallite a monte vengono rimborsate automaticamente
1–8 domande per chiamata jev_decide, ~8.000 caratteri di state, 120 chiamate/minuto per chiave
initialize e tools/list MCP non richiedono autenticazione; solo tools/call usa la tua chiave e il tuo saldo

Domande frequenti

Il server MCP costa di più?

No. tools/call passa dalla stessa pipeline /v1/systemone dell’API: solo token di input, output gratis, addebito sullo stesso saldo. I tuoi 100.000 token di accesso valgono anche per MCP.

Quali client supportano l’endpoint MCP remoto?

Qualsiasi client MCP che parli Streamable HTTP — Claude Code, Cursor, Cline e altri. Puntalo su https://jevmodel.org/mcp con un header Authorization che porta la tua chiave sk-.

Quali strumenti espone il server MCP?

Quattro: jev_decide (il contratto completo state-più-questions, fino a 8 domande) e i wrapper di comodo jev_noul, jev_choice e jev_score per giudizi singoli.

Cosa aggiunge il SKILL.md oltre a MCP?

MCP dà gli strumenti all’agente; la skill gli insegna quando e come usarli — soglie, raggruppamento in una chiamata, design dei criteria, nuovi tentativi idempotenti. Installa entrambi se il tuo agente supporta le skill.

La mia chiave API è al sicuro nella config MCP?

La chiave viaggia solo come header Authorization verso jevmodel.org. Tienila in una variabile d’ambiente, non committarla mai in un repo e revocala dalla dashboard se trapela.