Recruitee su MCP: posizioni, candidati, pipeline, colloqui e attività di recruiting in qualsiasi agente AI

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Recruitee, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Recruitee

Gestione delle candidature con Recruitee (Tellent Recruitee): posizioni e talent pool, candidati con ricerca completa, pipeline e fasi, placement, note, tag, reparti, sedi, colloqui e valutazioni, attività e feed delle attività. Inoltre sposta i candidati tra le fasi e crea e pubblica posizioni. Recruitee ATS API con un token API personale.

Setup

La configurazione richiede circa 3 minuti.

1. In Recruitee apri Settings > Apps and plugins > Personal API tokens (https://app.recruitee.com/#/settings/api_tokens), fai clic su Add new token, assegna un'etichetta e conferma la password. Copia il token in RECRUITEE_API_TOKEN; non può essere mostrato di nuovo.
2. Copia il company ID indicato nella stessa pagina (un numero) in RECRUITEE_COMPANY_ID. Funziona anche il sottodominio dell'azienda.
3. Installa il connettore: recruitee_get_current_admin è il controllo di installazione.

Il token agisce come te, con il tuo ruolo, solo in quell'azienda; un'altra azienda richiede un token proprio. Recruitee non permette di restringere l'ambito di un token, quindi crealo con un utente il cui ruolo corrisponde a ciò che l'AI deve fare.

Dati personali: i candidati sono persone che si candidano, con CV, recapiti, valutazioni e talvolta data di nascita o nazionalità. Chiedi solo ciò che serve al compito, rispetta le impostazioni GDPR dell'azienda e non copiare i dati dei candidati in altri strumenti senza motivo.

Le parole di Recruitee: una posizione è un offer (kind job; un talent pool è un offer con kind talent_pool). Un candidato in una posizione è un placement, che porta la fase e l'eventuale squalifica per quella posizione. I membri del team sono admin.

Cosa legge:

• Team: recruitee_get_current_admin e recruitee_list_admins (id per assegnatari delle attività e filtri).
• Posizioni: recruitee_list_offers (filtri per statuses come published, tipo, reparto, sede, tag, recruiter o hiring manager), recruitee_get_offer (descrizione, requisiti, team di selezione e fasi della pipeline con i loro id) e recruitee_list_offer_notes.
• Candidati: recruitee_list_candidates (filtri semplici), recruitee_search_candidates (ricerca completa con filters_json), recruitee_get_candidate (recapiti, link a CV e lettera di presentazione, fonti, tag, campi personalizzati, valutazioni, placement e risposte alle domande), recruitee_list_candidate_notes, recruitee_list_candidate_tasks e recruitee_list_candidate_activities. Il feed aziendale: recruitee_list_activities.
• Pipeline di una posizione: recruitee_list_placements (chi è in quale fase), recruitee_list_pipeline_templates, recruitee_get_pipeline_template e recruitee_list_disqualify_reasons.
• Elenchi di riferimento: recruitee_list_departments, recruitee_get_department, recruitee_list_locations, recruitee_get_location, recruitee_list_tags e recruitee_list_sources.
• Colloqui: recruitee_list_interview_events (di default quelli in arrivo), recruitee_get_interview_event e recruitee_list_interview_results (valutazioni e scorecard). Attività: recruitee_list_tasks.

Cosa scrive:

• Candidati: recruitee_create_candidate (facoltativamente già candidato a posizioni; un remote_cv_url viene analizzato), recruitee_update_candidate, recruitee_add_candidate_tags (i tag che non esistono ancora vengono creati), recruitee_remove_candidate_tags, recruitee_add_candidate_field (ad esempio competenze, lingue o nazionalità) e recruitee_create_candidate_note (visibile al team di selezione, non al candidato).
• Pipeline: recruitee_assign_candidate inserisce un candidato in una posizione (prima fase) o in un talent pool; recruitee_change_stage sposta un placement in un'altra fase (id del placement dal candidato, id della fase da recruitee_get_offer; una fase di assunzione può richiedere hired_at, work_location_id e, con le requisition, opening_id); recruitee_disqualify_candidate con un motivo e recruitee_requalify_candidate si annullano a vicenda.
• Posizioni: recruitee_create_offer crea una bozza, recruitee_update_offer ne modifica i campi, recruitee_publish_offer la pubblica sul sito carriere e sui job board configurati, recruitee_unpublish_offer la ritira mantenendo i candidati, recruitee_close_offer blocca nuove candidature.
• Attività: recruitee_create_task e recruitee_complete_task (o riapre un'attività con completed false).

Automazioni: creare un candidato su una posizione, cambiare fase con run_actions true o squalificare può avviare le email e le azioni che l'azienda ha configurato in Recruitee, quindi i candidati potrebbero ricevere comunicazioni. L'AI lo dice prima di farlo per molti candidati.

Disattivati all'installazione: recruitee_delete_candidate (elimina il candidato con tutti i suoi dati) e recruitee_remove_placement (toglie un candidato da una posizione insieme alla cronologia delle fasi di quel placement). Non si possono annullare; un amministratore del workspace li attiva quando servono al team. Squalificare è il modo reversibile per togliere un candidato da una posizione.

Filtri di ricerca: filters_json di recruitee_search_candidates è un array JSON come stringa, ad esempio [{"field":"all","query":"java"},{"filter":"tags","id":{"in":[12]}},{"field":"created_at","gte":"2026-10-01"}]. Stato e fonte: {"field":"status","in":["qualified"]}; fasi: {"filter":"stages","name":{"in":[...]}}.

Formati dei dati: gli id sono interi; date e orari sono ISO 8601 in UTC (2026-10-19T11:02:32Z). I placements di un candidato elencano una voce per posizione con offer_id, stage_id e disqualify_reason; i cambi di fase e di qualifica usano l'id del placement. adminapp_url porta al candidato in Recruitee.

Paginazione: recruitee_list_candidates pagina con limit (fino a 1000) e offset; posizioni, ricerca, sedi, attività del feed, eventi e attività paginano con limit e page (da 1). L'AI si ferma quando una pagina restituisce meno elementi di limit.

Errori comuni: 401 invalid_token indica un token errato, revocato o di un'altra azienda; 403 un ruolo senza il permesso necessario; 404 un company ID o un id di record errato; 422 un errore di validazione, con il campo indicato nel corpo.

Il connettore non invia email ai candidati direttamente, non pianifica colloqui e non scrive valutazioni.

Prerequisiti: RECRUITEE_COMPANY_ID, RECRUITEE_API_TOKEN

Installazione locale del connettore

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Apri http://localhost:3000/connectors/store, scegli Recruitee e inserisci le variabili elencate nei Prerequisiti.

Tool disponibili

Esempi di prompt

• "Quali candidati si sono candidati questa settimana per la posizione Senior Backend Developer e in quale fase si trovano?"
• "Trova i candidati con il tag java che si sono candidati dopo il 1° ottobre."
• "Quali colloqui sono in programma domani, con candidato, posizione e partecipanti?"
• "Sposta Laura Rossi nella fase Interview della posizione Product Designer e aggiungi una nota che il colloquio telefonico è andato bene."
• "Crea una bozza di posizione per un Customer Support Specialist nel reparto Support, con sede a Berlino."

Prossimi passi

• Collegare a Claude
• Collegare a ChatGPT