MCP funzionante (anteprima)
Workable è una piattaforma di assunzione e risorse umane. Questo server MCP consente a un agente di lavorare con l'account workable di un utente: esplorare e cercare i processi, esaminare e intervenire i candidati tramite la pipeline di assunzione, cercare i dipendenti e il grafico dell'organizzazione, gestire richieste, offerte, reparti e membri e gestire il time off, il rilevamento del tempo, le revisioni delle prestazioni.
Questo connettore è disponibile nei prodotti e nelle aree seguenti:
| Service | Classe | Regions |
|---|---|---|
| Copilot Studio | Premium | Tutte le aree Power Automate ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Logic Apps | Standard | Tutte le aree di App per la logica , ad eccezione delle seguenti: - aree Azure per enti pubblici - Aree di Azure Cina - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Apps | Premium | Tutte le aree Power Apps ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Automate | Premium | Tutte le aree Power Automate ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Contatto | |
|---|---|
| Name | Supporto utilizzabile |
| URL | https://help.workable.com/hc/en-us |
| Metadati del connettore | |
|---|---|
| Editore | Praticabile |
| Website | https://www.workable.com |
| Informativa sulla privacy | https://www.workable.com/privacy |
| Categorie | Risorse umane; Produttività |
Praticabile
Workable è una piattaforma di assunzione e risorse umane usata da più di 30.000 aziende per pubblicare posti di lavoro, spostare i candidati attraverso una pipeline di assunzione e gestire i dipendenti una volta assunti.
Il server MCP workable concede a un agente autenticato e con riconoscimento delle autorizzazioni l'accesso a tali dati. Un agente può rispondere a domande sui ruoli aperti e sui candidati, agire sulla posizione della pipeline di un candidato, cercare le informazioni sui dipendenti e sul grafico dell'organizzazione e gestire i flussi di lavoro di approvazione che circondano richieste, offerte e time off, tutti come utente che ha eseguito l'accesso e solo all'interno di ciò che l'utente è autorizzato a visualizzare e fare.
Editore
Workable Inc
Prerequisiti
- Un account utilizzabile.
- Un account utente utilizzabile. Gli strumenti agiscono per conto dell'utente connesso, quindi i dati e le azioni disponibili dipendono dal ruolo e dalle autorizzazioni dell'utente in Workable.
Come ottenere le credenziali
Il server usa OAuth 2.0. Nessuna chiave API, ID client o segreto deve essere immessa a mano.
Quando si crea la connessione, si viene reindirizzati a Workable per accedere e fornire il consenso alle autorizzazioni richieste dal server. Un token di accesso utilizzabile ha come ambito l'utente e la connessione lo archivia. I token vengono aggiornati automaticamente; si accede di nuovo solo se si revoca l'accesso o l'amministratore workable rimuove l'account.
È possibile esaminare o revocare l'autorizzazione in qualsiasi momento da Integrazioni impostazioni > in Workable. Per informazioni di riferimento sullo strumento completo, vedere la documentazione relativa al server MCP workable.
Introduzione al connettore
Aggiungere il server MCP workable come strumento nell'agente, creare una connessione e accedere quando richiesto.
Ogni strumento diverso da get_accounts accetta un account argomento. Un utente utilizzabile può appartenere a più account, quindi l'agente deve prima chiamare get_accounts per elencare gli account che può raggiungere, quindi passare l'account subdomain scelto come account in ogni chiamata successiva. Gli agenti di orchestrazione ben comportati lo fanno automaticamente; se si lavora con un singolo account vale la pena denominarlo nelle istruzioni dell'agente in modo che l'agente non deve chiedere.
Alcuni elementi utili da provare una volta connessi:
- "Quali candidati hanno chiesto il ruolo Senior Backend Engineer questa settimana e dove si trovano nella pipeline?"
- "Spostare il candidato 12345 alla fase del colloquio e aggiungere una nota sul loro portafoglio."
- "Chi è fuori sede nell'ufficio di Berlino il mese prossimo?"
- "Mostrami le richieste in attesa della mia approvazione."
- "Chi riferisce al VP di Engineering?"
Strumenti disponibili
Il server espone oltre 100 strumenti. Sono raggruppati come segue; L'elenco autorevole per una determinata distribuzione è quello che il server restituisce da , perché tools/listun account o una distribuzione può avere strumenti disabilitati.
| Area | Operazioni che l'agente può eseguire | Strumenti rappresentativi |
|---|---|---|
| Accounts | Individuare gli account raggiungibili e i set di autorizzazioni personalizzati dell'account |
get_accounts, get_permission_sets |
| Jobs | Elencare, cercare ed esaminare i processi, le fasi, i membri, i selezionatori, i moduli dell'applicazione e la cronologia delle attività |
get_jobs, search_jobs, get_job, get_job_stages, get_job_activities |
| Candidati | Elencare ed esaminare i candidati; crearli; spostare, copiare, rilocare, squalificarli o riqualificarli; aggiungere commenti, valutazioni e valutazioni; gestire i tag e leggere i file allegati |
get_candidates, get_candidate, create_candidate, move_candidate, disqualify_candidate, revert_disqualification, add_comment, add_review |
| Employees | Elencare ed esaminare i dipendenti, leggere il grafico dell'organizzazione e i documenti dei dipendenti, aggiornare i record dei dipendenti |
get_employees, get_employee, get_orgchartupdate_employee |
| Members | Elencare i membri dell'account, invitarne di nuovi, aggiornare ruoli e autorizzazioni, abilitare o rimuovere membri |
get_members, invite_member, update_memberdelete_member |
| Richieste | Leggere le richieste e i relativi attributi personalizzati; creare, aggiornare, approvare e rifiutarli |
get_requisitions, create_requisition, approve_requisitionreject_requisition |
| Offers | Leggere l'offerta di un candidato e approvarla o rifiutarla |
get_offer, get_candidate_offer, approve_offerreject_offer |
| Indisponibilità | Saldi di lettura, richieste e categorie; creare richieste; approvare o rifiutare quelli in sospeso |
get_timeoff_balances, get_timeoff_requests, create_timeoff_requestupdate_timeoff_approval |
| Rilevamento del tempo | Elencare, creare e aggiornare le voci relative all'ora, tra cui la voce in blocco e l'orologio in entrata o in uscita |
list_time_entries, clock_in, clock_outbulk_create_time_entries |
| Recensioni di prestazioni | Leggere cicli di revisione, attività, moduli e risultati; creare modelli di ciclo; inviare, condividere e firmare recensioni |
get_review_cycles, list_review_tasks, submit_reviewsign_review |
| Organizzazione | Leggere e gestire reparti, persone giuridiche e pianificazioni di lavoro |
get_departments, create_department, get_legal_entitiesget_work_schedules |
| Reporting | Eseguire ricerche filtrate sui dipendenti e sui record candidati dettagliati dopo aver individuato i campi e le opzioni di filtro disponibili |
get_employee_fields, search_employees, search_candidates_detailed |
| Dati di riferimento | Leggere le fasi della pipeline, i motivi di squalifica, gli attributi e gli eventi personalizzati dell'account |
get_stages, get_disqualification_reasons, get_account_custom_attributesget_events |
Gli strumenti di sola lettura sono annotati come tali e gli strumenti che modificano o rimuovono i dati vengono annotati come distruttivi, in modo che un host che espone annotazioni degli strumenti possa richiedere conferma prima di una scrittura.
Problemi noti e limitazioni
- Solo strumenti. Il server espone gli strumenti MCP. Non pubblica risorse o richieste MCP e non usa il campionamento o l'elicitazione.
- Solo HTTP gestibile in streaming. Le richieste vengono
POSTJSON-RPC sul trasporto HTTP streamable. Il trasporto SSE deprecato non è supportato; unGEToggetto all'endpoint restituisce405. - Senza stato. Ogni richiesta viene gestita in modo indipendente. Non è presente alcuna ripresa della sessione e il server non esegue il push delle notifiche al client tra le chiamate.
- La gestione di più account è esplicita. Non esiste alcun "conto corrente" implicito. L'omissione dell'argomento
accountnon riesce invece di indovinare, che è intenzionale: agire sull'account workable sbagliato non è un errore ripristinabile. - Le autorizzazioni vengono applicate da Workable, non dal server. Una chiamata allo strumento può avere esito positivo per un utente e essere rifiutata per un altro nello stesso account. I rifiuti tornano come errori di strumento che descrivono la restrizione; non sono errori del connettore.
- Limiti di frequenza. Le chiamate sono soggette ai limiti di frequenza api utilizzabili. Una chiamata con frequenza limitata restituisce un errore che chiede all'agente di riprovare dopo un breve attesa.
- Strumenti dipendenti dal piano. Gli strumenti HR (dipendenti, time off, time tracking, revisioni delle prestazioni) richiedono l'abilitazione dei prodotti workable corrispondenti nell'account. In un account solo ATS questi strumenti restituiscono errori "non trovati" o "non consentiti".
Errori e rimedi comuni
| Error | Meaning | Rimedio |
|---|---|---|
| Non autorizzato (401) | Il token di accesso è mancante, non valido o scaduto. | Accedere di nuovo per aggiornare la connessione. |
| Non consentito (403) | Il token è valido, ma l'utente o l'account potrebbe non eseguire l'azione. | Controllare il ruolo e le autorizzazioni utilizzabili dell'utente connesso e verificare che il prodotto pertinente sia abilitato nell'account. |
| Non trovato (404) | La risorsa non esiste o non è visibile a questo account. | Verificare che il account sottodominio sia corretto, quindi recuperare nuovamente l'elenco da cui proviene l'ID per ottenere ID validi. |
| Conflitto (409) | La risorsa è in uno stato che non consente l'azione, ad esempio ripristinando un candidato che non è qualificato. | Rileggere lo stato corrente della risorsa e agire di conseguenza. |
| Non elaborabile (422) | La richiesta è stata compresa ma non è stata elaborata come specificato. | Controllare i valori dell'argomento rispetto allo schema dello strumento, in particolare campi simili a enumerazione, ad esempio nomi di fase e motivi di squalifica, che devono essere letti dall'account anziché presupposti. |
| Limite di frequenza (429) | Troppe richieste all'API workable. | Attendere brevemente e riprovare. |
FAQ
Quale account utilizzabile agisce sull'agente?
Indipendentemente dal sottodominio dell'account account passato come argomento, da quelli restituiti da get_accounts. L'agente deve chiamare get_accounts prima della prima chiamata dati.
L'agente può visualizzare i dati che l'utente connesso non può? No. Ogni chiamata viene eseguita con il token di accesso dell'utente ed è soggetta alle stesse autorizzazioni dell'app Web Workable.
L'agente può modificare i dati? Sì, dove le autorizzazioni dell'utente lo consentono, ad esempio lo spostamento o la squalifica dei candidati, l'approvazione di offerte e il time off, l'aggiornamento dei record dei dipendenti e la gestione dei membri. Gli strumenti che scrivono vengono annotati come tali in modo che l'host possa chiedere prima di tutto la conferma.
I dati dei candidati e dei dipendenti vengono usati per la formazione? No. Il server legge e scrive l'account workable tramite l'API Workable e non mantiene il contenuto oltre a quello necessario per gestire la richiesta.
Support
- Documentazione: Informazioni di riferimento sul server MCP utilizzabili
- Supporto: Help Center funzionante
- Termini e condizioni: termini utilizzabili
Azioni
| Server MCP utilizzabile |
Endpoint HTTP gestibile tramite flusso per il server MCP funzionante. Espone ats (Workable recruiting) e gli strumenti HR all'agente. L'agente deve chiamare get_accounts prima di individuare i sottodomini dell'account che l'utente connesso può raggiungere, quindi passare il sottodominio scelto come argomento dell'account di ogni altro strumento. |
Server MCP utilizzabile
Endpoint HTTP gestibile tramite flusso per il server MCP funzionante. Espone ats (Workable recruiting) e gli strumenti HR all'agente. L'agente deve chiamare get_accounts prima di individuare i sottodomini dell'account che l'utente connesso può raggiungere, quindi passare il sottodominio scelto come argomento dell'account di ogni altro strumento.
Valori restituiti
- response
- object
Definizioni
object
Si tratta del tipo 'object'.