add_application_note
ChatGPTRegistra uma nota/feedback na candidatura (visível na ficha do candidato no app).
Overview
The Recruta connector links your ATS (Applicant Tracking System) to ChatGPT. Recruiters query and run hiring by chatting: list jobs, view candidate rankings, move pipeline stages, add notes, and schedule interviews — with per-user login (OAuth), strict per-company isolation, and no health data (PHI) exposed. Built for recruiting teams that want to operate their ATS hands-free, right from the chat.
Tools
create_job
ChatGPTCria uma vaga para a empresa do usuário. Use
client_token (string idempotente) para evitar duplicar em retries.get_candidate_ranking
ChatGPTRanqueia os candidatos de uma vaga por match_score (decrescente). Retorna posição, nome, score e etapa.
get_my_permissions
ChatGPTUse this when the user asks what product help or actions are available to their connected account. Returns only the authenticated role, effective MCP scopes, stored permission matrix, and accessible guide IDs; it never grants access.
get_pipeline_summary
ChatGPTMétricas agregadas do pipeline (contagem por etapa e tempo médio na esteira). Não retorna candidatos individuais.
get_product_guide
ChatGPTUse this after search_product_help when the user needs the complete deterministic procedure for one returned guide. Access is rechecked from the authenticated role and stored permissions.
list_applications
ChatGPTCandidaturas (pipeline) de uma vaga, por etapa (status), sem dados de saúde. Passe
application_id para o detalhe de uma candidatura. Paginação na listagem.list_candidates
ChatGPTCandidatos da empresa (sem dados de saúde/laudo). Sem filtro = lista;
query = busca por texto (nome/resumo); job_id = candidatos de uma vaga; candidate_id = detalhe de um candidato. A lista/busca retorna nome, skills, experiência e resumo; e-mail e telefone só no detalhe de um candidato (candidate_id).list_interviews
ChatGPTLista entrevistas (agenda) por vaga, candidato e/ou intervalo de datas. Paginação obrigatória.
list_jobs
ChatGPTLista as vagas da empresa do usuário (isoladas por RLS). Filtros opcionais por status e por texto (título/descrição). Passe
job_id para obter o DETALHE de uma vaga específica. Paginação na listagem.move_application_stage
ChatGPTMove uma candidatura para outra etapa/status do pipeline. Registra o autor.
schedule_interview
ChatGPTAgenda uma entrevista para uma candidatura. Data em ISO 8601.
search_product_help
ChatGPTUse this when the user asks how to use Recruta or complete a product workflow. Returns at most three role-safe catalog guides and never returns the free-text query.
update_job_status
ChatGPTAbre, pausa ou encerra uma vaga da empresa do usuário.
whoami
ChatGPTRetorna a identidade do usuário conectado: empresa, papel e escopos concedidos ao conector. Útil para testar a conexão.
