vox/jobs

Integrazione IA

Voxjobs per assistenti IA

Integra il catalogo di lavoro di Voxjobs direttamente in Claude, Cursor e altri client compatibili con MCP.

Senza autenticazioneDati in tempo realeMCP Streamable HTTP

Cos'è MCP

Model Context Protocol

Il Model Context Protocol (MCP) è uno standard aperto che consente agli assistenti IA di interrogare fonti di dati esterne in tempo reale, senza uscire dalla conversazione.

Con Voxjobs MCP, un assistente può cercare offerte, ottenere i dettagli di un annuncio, esplorare le aziende che stanno assumendo e leggere articoli sulla carriera, con dati aggiornati dal database.

Strumenti

4 strumenti disponibili

search_jobs

Cerca offerte per testo semantico (ruolo/competenze) con filtri: località, modalità, seniority, orario, contratto, retribuzione minima e azienda.

search_jobs({ query: "react developer", remoteMode: "REMOTE", salaryMinYearly: 40000 })
get_job_detail

Ottieni i dettagli completi di un'offerta: descrizione, condizioni, retribuzione (lorda/netta/stimata esplicita), azienda e link di candidatura all'origine.

get_job_detail({ slug: "engenheiro-de-dados-lisboa-abc123" })
search_companies

Cerca aziende con offerte attive in questo mercato: settore, sede, dimensione e numero di posizioni aperte.

search_companies({ name: "Feedzai" })
search_articles

Cerca guide alla ricerca di lavoro, analisi del mercato del lavoro, retribuzioni e consigli di carriera.

search_articles({ limit: 5 })

Attenzione

Non incollare il JSON di configurazione in una conversazione di chat. Incollare la configurazione nella chat non attiva nulla: l'assistente la legge solo come testo. La configurazione deve andare nel file di config del client (vedi sotto) o essere aggiunta dall'interfaccia delle impostazioni.

Come integrare

Istruzioni per client

Claude CodePiù veloce

Un solo comando nel terminale, senza modificare file manualmente:

claude mcp add voxjobs --transport http https://www.voxjobs.it/api/mcp

Poi riavvia la sessione di Claude Code. Gli strumenti sono disponibili immediatamente.

Claude DesktopConsigliato

Claude Desktop non si connette direttamente a server HTTP remoti: usa il ponte open source mcp-remote. Modifica il file di configurazione (non la chat!) e aggiungi questo blocco dentro mcpServers:

{
  "mcpServers": {
    "voxjobs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.voxjobs.it/api/mcp"]
    }
  }
}

Richiede Node.js (npx scarica mcp-remote al primo avvio). Riavvia Claude Desktop dopo aver salvato.

Posizione del file

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

Connettori (Claude.ai web e Desktop)

L'interfaccia Connettori di Claude richiede OAuth e non collega ancora server pubblici senza autenticazione come questo: darebbe un errore di accesso. Usa Claude Code o il file di configurazione qui sopra.

Cursor

In Settings → MCP → Add server, scegli il tipo http e inserisci l'URL:

https://www.voxjobs.it/api/mcp

ChatGPTNessun supporto MCP

ChatGPT non supporta MCP in modo nativo. Puoi usare Voxjobs incollando questo testo in un GPT personalizzato o in una conversazione:

“Consulta il catalogo di offerte di Voxjobs su https://www.voxjobs.it/jobs per trovare lavoro in Italia.”

Perplexity

Perplexity indicizza Voxjobs tramite llms.txt e il catalogo pubblico. Nessuna configurazione necessaria: chiedi direttamente:

“Trova offerte di lavoro in Italia su Voxjobs”

Esempi

Cosa puoi chiedere

01“Trovami offerte di data engineering da remoto in Italia sopra i 50 mila €/anno”
02“Quali aziende tech stanno assumendo adesso?”
03“Mostrami offerte di marketing digitale junior a tempo pieno”
04“Leggi una guida di Voxjobs su come negoziare lo stipendio in Italia”

Per sviluppatori

Endpoint tecnico

Server MCP Streamable HTTP, senza autenticazione. Ogni POST è uno scambio JSON-RPC 2.0 completo. Dati in tempo reale, limitati al mercato di questo dominio.

Endpointhttps://www.voxjobs.it/api/mcp
DiscoveryGET https://www.voxjobs.it/api/mcp
ProtocolloMCP 2024-11-05 · JSON-RPC 2.0 · HTTP POST