Integração MCP: converse com o ATS Abler pela sua IA da sua escolha.

O que é a integração MCP do Abler e para que serve?

A integração MCP (Model Context Protocol) é a forma de conversar com o ATS Abler por um assistente de IA, em linguagem natural. Em vez de abrir telas e filtros, você faz perguntas como “Quais vagas estão paradas há mais de 15 dias?” ou “Me mostre os candidatos da vaga de Analista Fiscal ordenados por aderência” — e também pede ações, como escrever um parecer ou mover candidatos de etapa.

A IA não recebe uma cópia da sua base: ela consulta o Abler ao vivo, a cada pergunta, com as mesmas regras de permissão que você já tem dentro do sistema.

Conecte o seu assistente de IA ao servidor MCP do Abler (veja o passo a passo na próxima pergunta).
Peça o que precisa em português, como se falasse com um colega de time.
Para ações que alteram o processo de verdade, a IA resume o que faria e pede sua confirmação antes de executar.

A integração é um atalho para as tarefas do dia a dia — ela não substitui a tela do Abler. Relatórios, configurações e a visão completa do processo continuam no sistema.

Quais assistentes de IA funcionam com o Abler?

Qualquer cliente compatível com o padrão MCP. Exemplos: Claude, Cursor e plataformas de automação como o n8n. A conexão é feita por HTTP, sem instalar nada no seu computador.

Verifique se o seu assistente suporta servidores MCP (a maioria das ferramentas de IA modernas suporta).
Siga a configuração descrita em “Como conecto meu assistente de IA ao ATS Abler?”.
Teste com uma pergunta simples, como “liste as minhas vagas abertas”.

Boa prática: você pode conectar mais de um assistente ao mesmo tempo. Apenas lembre-se de que os limites de consulta são contados por empresa, então assistentes e automações dividem a mesma cota.

Como conecto meu assistente de IA ao ATS Abler?

A conexão é feita uma única vez, na configuração do seu assistente de IA. Depois disso, o assistente descobre sozinho tudo o que pode fazer e já começa a responder.

Tenha em mãos o token de integração da sua empresa (veja como conseguir na próxima pergunta).
No seu assistente de IA, adicione um servidor MCP com estes dados:

Campo	Valor
Endereço	`https://api.abler.com.br/mcp`
Cabeçalho de autenticação	`X-API-TOKEN: token-da-empresa`

Salve a configuração. Não é preciso instalar nada — a conexão é por endereço web.
Faça um teste: peça “quais vagas estão abertas?”.

Trate o token como uma senha corporativa: ele é único por empresa e vale para todos que usam a integração. Se suspeitar que vazou, peça um novo — o antigo deixa de funcionar na hora.

Erro de “Unauthorized” quase sempre vem do token colado com espaços no início ou no fim, ou do nome do cabeçalho digitado de forma diferente de X-API-TOKEN.

O que preciso para começar a usar o MCP no Abler?

Para usar o MCP, você precisa de três coisas: uma conta ativa no Abler, a API pública habilitada e o token de integração da sua empresa.

Conta ativa no Abler ATS — a sua conta usual de recrutador.
API pública habilitada para a sua empresa — faz parte do seu plano ou é contratada à parte. Consulte o seu time de atendimento para confirmar.
Token de integração da empresa — hoje é um único token por empresa. Peça ao suporte ou ao administrador da sua empresa.

Preciso instalar alguma coisa? Funciona no celular?

Não é preciso instalar nada. A conexão é por endereço web, direto na configuração do assistente. E funciona no celular sempre que o seu assistente de IA funcionar — inclusive nos aplicativos móveis que suportam MCP.

Posso desligar a integração quando quiser?

Sim, a qualquer momento. Basta pedir ao suporte um novo token ou a desativação do acesso — o acesso antigo deixa de funcionar imediatamente.

Criação e Gestão de Vagas

Como criar uma vaga no Abler usando a IA?

Você pode criar uma vaga em rascunho pela conversa e preencher todos os blocos do cadastro — descrição, requisitos, remuneração, localização, responsáveis, etapas, formação e divulgação — sem sair do chat.

No seu assistente conectado, descreva a vaga em linguagem natural. Exemplo: “crie um rascunho de vaga para Analista de Logística em Curitiba, modelo híbrido, salário de R$ 4.500 a R$ 5.500, com etapa de triagem, entrevista técnica e proposta”.
A IA cria a vaga em rascunho e confirma o que foi cadastrado.
Peça ajustes pelo nome dos campos: “atualize os benefícios e adicione o time de Operações como responsável”.
Quando estiver pronta, peça a publicação — a IA resume a ação e pede sua confirmação antes de executar.

Prefira revisar o rascunho na tela do Abler antes de publicar, especialmente descrição e requisitos — o texto publicado é o que os candidatos veem.

Se a IA disser que a vaga não existe, mas você sabe que ela existe, quase sempre é permissão: o usuário vinculado ao token não está relacionado àquela vaga. Peça ao administrador para incluí-lo como responsável, analista ou gestor.

Quais ações a IA pode fazer nas minhas vagas?

A IA cobre todo o ciclo de vida da vaga: você consulta, altera e movimenta sem sair do chat.

Consultar:

Buscar e listar vagas por texto, status, período de criação, encaminhamento ou encerramento.
Abrir a ficha completa: descrição, salário, benefícios, cliente, time, prazos.

Cadastrar e editar:

Criar vaga em rascunho e atualizar todos os blocos do cadastro.
Duplicar uma vaga existente (ótimo para vagas recorrentes).

Movimentar status: publicar, aprovar, recusar, pausar, retomar, reabrir, encerrar, cancelar e excluir.

Outras ações: liberar ou desliberar candidaturas e registrar uma ocorrência na linha do tempo da vaga.

Ponto de atenção: as ações de status (publicar, encerrar, excluir etc.) têm trava de confirmação — a IA mostra o que faria e espera o seu “confirma” antes de executar.

Como funciona a divulgação da vaga no LinkedIn pela IA?

A IA ajuda na divulgação da vaga no LinkedIn da empresa e, dependendo do módulo ativo, também no seu LinkedIn pessoal.

Na página da empresa:

Peça: “gere o texto do post de divulgação da vaga de Analista Fiscal”.
Aguarde o texto ficar pronto — a geração é assíncrona. Peça para consultar o status quando quiser.
Revise o texto com a IA e, só então, peça a publicação.

No seu perfil pessoal (requer o módulo LinkedIn — perfis pessoais): consultar se você já está conectado a um candidato, enviar convite de conexão e publicar um post no seu perfil.

Gerar não publica.

São três passos: gerar, agendar ficar pronto e publicar. Se a IA tentar publicar antes do texto ficar pronto, ela avisa — peça o status e tente de novo em instantes.

O post na página da empresa exige o módulo

LinkedIn — página da empresa

. Sem o módulo, a IA avisa que o recurso não está disponível em vez de falhar silenciosamente.

Gestão de Candidatos

Como consultar candidatos de um processo seletivo pela IA?

Você pode listar os candidatos de um processo com filtros por etapa, favoritos, triagem, contratação, data de candidatura e etiquetas — tudo por conversa.

Peça: “liste os candidatos da vaga de Analista Fiscal que estão na etapa de entrevista técnica”.
Refine à vontade: “só os favoritos”, “ordenados por aderência”, “candidatados nos últimos 7 dias”.
Para ver uma candidatura em detalhe, peça a abertura dela: a IA mostra a etapa atual, as datas, os dados de contratação, o Matching da ju (aderência geral, requisitos obrigatórios e desejáveis, localização) e as avaliações comportamentais (DISC e Big Five).
Para os anexos, peça os documentos da candidatura — como o currículo — e baixe pelo link gerado.

Os links de download de anexos são temporários, por segurança. Se o link parar de funcionar, peça o arquivo novamente e um link novo é gerado.

Como mover candidatos de etapa ou desqualificar pela IA?

A IA movimenta o funil por você — sempre com confirmação antes de executar.

Mover de etapa:

Peça pelo nome da etapa, sem precisar de IDs: “mova esses três candidatos para a etapa de Proposta”.
A IA resume a ação e pede confirmação.
Após o seu “confirma”, a mudança é feita e registrada na linha do tempo.

Desqualificar:

Peça: “desqualifique os candidatos 12, 18 e 33 por falta de aderência”.
Informe o motivo (a IA encontra o motivo cadastrado pelo nome).
Você pode pedir o envio de e-mail e/ou WhatsApp de desqualificação, se quiser.
Confirme e pronto.

Como buscar candidatos no banco de talentos pela IA?

A busca interna no banco de talentos do Abler aceita dezenas de filtros e, por padrão, ranqueia os resultados por aderência à vaga.

Descreva o perfil que procura. Exemplo: “procure no banco de talentos analistas fiscais com experiência em ERP, domiciliados em São Paulo, nível superior, inglês intermediário”.
Combine filtros disponíveis: cargo nas experiências, empresas, faixa salarial, cidade, estado, idade, escolaridade, idiomas, cursos, skills, etiquetas e data de atualização do currículo, entre outros.
Sem uma ordenação escolhida, o resultado vem ranqueado por aderência — os mais aderentes primeiro.
Para contatos com candidatos novos de fora da base, peça um hunting externo (veja a pergunta específica abaixo).

Como funciona o hunting externo pela ju? Por que não apareceram candidatos?

O hunting externo dispara buscas por candidatos novos na web ou no LinkedIn, além do banco interno. Ele é a porta de entrada de perfis que ainda não estão na sua base.

Verifique se a vaga está publicada e integrada à ju — é pré-requisito.
Peça: “inicie um hunting no LinkedIn para a vaga de Analista Fiscal”. A IA pedirá confirmação antes de iniciar.
Aguarde: a busca roda em segundo plano e os candidatos chegam aos poucos, marcados como ju_hunting, direto na triagem da vaga. Cada execução traz um lote — não o resultado inteiro de uma vez.
Para acompanhar, peça: “consulte o andamento do hunting”.

Isso pode acontecer quando… você acaba de iniciar o hunting e espera resultados imediatos — o hunting é assíncrono por natureza. Não é erro: é o funcionamento esperado. Os candidatos aparecem na triagem conforme as buscas retornam.

Como escrever pareceres e comentários com a IA?

A IA lê, escreve e edita pareceres (feedbacks) e comentários sobre candidatos — um jeito rápido de registrar a análise sem digitar tudo na tela.

Para ler o histórico, peça: “mostre todos os pareceres do candidato na vaga X” ou “quais comentários existem sobre ele?”.
Para registrar, peça: “escreva um parecer para o candidato da etapa de entrevista técnica, destacando boa aderência aos requisitos obrigatórios e pontuar preocupação com a experiência em sistemas fiscais”.
Revise e peça ajustes até o texto ficar como você quer — o parecer é editável pela IA.
Em comentários, você pode mencionar colegas de equipe para envolvê-los na discussão.

Como falar com candidatos pelo WhatsApp pela IA?

Com o módulo Abler Conversas ativo, a IA lê as últimas mensagens trocadas com um candidato e envia mensagens individuais — sem sair do chat.

Peça: “mostre as últimas mensagens de WhatsApp com o candidato da vaga X” para se atualizar da conversa.
Para enviar, peça: “mande uma mensagem convidando ele para a entrevista de quinta às 14h”.
A IA confirma antes de enviar — vale a trava de confirmação.
O histórico fica registrado no Abler Conversas, como qualquer conversa do canal.

Ponto de atenção: o envio é individual (um candidato por mensagem), e o módulo Abler Conversas precisa estar ativo. Sem ele, a IA avisa que o recurso não está disponível.

Automação e Rotinas

Dá para automatizar rotinas de recrutamento com o MCP?

Sim. Como o MCP é um padrão aberto, plataformas de automação como o n8n podem chamar as mesmas funções em fluxos automáticos — por exemplo, um resumo diário de vagas paradas ou um disparo de convites em lote.

Configure a automação na sua plataforma preferida usando o mesmo endereço e cabeçalho da conexão manual.
Comece por rotinas de leitura (listar, consultar), que não mexem no processo.
Para ações que alteram o funil, preveja o passo de confirmação no fluxo — a trava existe nas ações críticas.
Lembre-se: automações e assistentes dividem a mesma cota de consultas por empresa.

Segurança, Permissões e Limites

A IA pode fazer algo sem eu mandar?

Não. A IA só age quando você pede. E, para ações que mexem no processo de verdade, existe uma trava de confirmação: na primeira tentativa, ela não executa nada — devolve um resumo do que faria e espera você aprovar.

Essa trava vale para: publicar, aprovar, recusar, pausar, retomar, reabrir, encerrar, cancelar, excluir e liberar vagas; mover candidatos de etapa; convidar e desqualificar candidatos; bloquear um candidato; iniciar hunting externo; enviar convite ou publicar no LinkedIn; e enviar WhatsApp.

Na prática, o diálogo fica assim:

Você: desqualifique os candidatos 12, 18 e 33 por falta de aderência IA: vou desqualificar 3 candidatos da vaga #402 com o motivo “Perfil não aderente”. Confirma? Você: confirma IA: feito.

Até onde a IA enxerga dentro do Abler?

A IA herda as permissões do usuário do Abler ao qual o token está vinculado — nem mais, nem menos.

Se esse usuário só enxerga as vagas em que está alocado, a IA só enxerga essas.
Se ele não pode publicar vagas, a IA também não publica.
Se a IA diz que a vaga não existe e você sabe que existe, peça ao administrador para incluir esse usuário como responsável, analista ou gestor da vaga.

A IA vê os dados pessoais dos candidatos, como telefone e CPF?

Não — e isso é por construção, não por configuração. A conversa com IA é um canal novo e foi projetada para ser, por construção, incapaz de virar uma porta de saída para dados pessoais sensíveis. O recrutador continua vendo tudo o que precisa dentro do Abler, com os controles de acesso e a auditoria de sempre. A IA recebe o suficiente para ajudar na decisão, não para exportar a base.

O que a IA nunca retorna:

Contatos de candidatos: e-mail, telefones, LinkedIn e site.
Documentos pessoais: CPF, PIS, data de nascimento e CNH.
Dados de diversidade: gênero, identidade de gênero, orientação sexual, etnia, pronome, deficiência, estado civil e filhos — inclusive como filtro de busca.
Nome completo: só o primeiro nome é exibido.
Busca por e-mail ou telefone: recusada por segurança.

Isso vale para todas as respostas, sem exceção e sem configuração que libere.

E os pareceres e comentários que eu mesmo escrevi? Esses você lê normalmente — é conteúdo que a sua equipe escolheu registrar. Mas, se um dado sensível tiver sido colado dentro do texto (um e-mail, um telefone, um CPF), ele aparece como [removido] e o nome completo é reduzido ao primeiro nome.

As ações feitas pela IA ficam registradas?

Sim. Tudo entra no histórico e na linha do tempo do Abler, igual a uma ação feita pela tela — em nome do usuário vinculado ao token. Os acessos pela IA também são registrados para auditoria de segurança.

Meus dados são usados para treinar modelos de IA?

O Abler não envia a sua base para treinamento de modelos. O que acontece com o conteúdo da conversa depois que ele chega ao assistente é regido pela política do fornecedor que você escolheu (Claude, Cursor, etc.) — vale conferir as configurações de privacidade dele, especialmente em planos gratuitos.

Existe limite de uso da integração?

Sim, para proteger a base de candidatos contra coleta automatizada. As duas funções que leem candidatos em volume têm uma cota de consultas por empresa:

Ver o perfil de um candidato
Buscar no banco de talentos

Uso normal de recrutamento não chega perto do limite. Se ele for atingido, a IA avisa e basta aguardar um pouco antes de continuar. As demais funções (vagas, processos, pareceres, comentários) não entram nessa cota.

Ponto de atenção: a cota é por empresa — assistentes e automações conectados ao mesmo tempo dividem a mesma cota.

Problemas Comuns e Soluções

Por que aparece “Unauthorized” ou o assistente não conecta?

Esse erro quase sempre vem da autenticação do token — e tem solução rápida na maioria dos casos.

Confira se o token foi colado inteiro, sem espaços no início ou no fim.
Confira se o cabeçalho é exatamente X-API-TOKEN (maiúsculas e hífens).
O token precisa estar vinculado a um usuário — tokens antigos, sem usuário, não funcionam no MCP.
Verifique se o usuário vinculado ao token está ativo e confirmado no Abler.
Se a sua empresa restringe acesso por IP, o IP de onde a chamada sai precisa estar liberado.

Isso pode acontecer quando o token é antigo ou quando houve uma troca recente — tokens desativados param de funcionar na hora. Persistindo, acione o suporte.

Por que a IA diz que a API pública não está habilitada?

O recurso não está ativo no plano da sua empresa. A API pública faz parte de alguns planos ou é contratada à parte. Fale com o seu time de atendimento para habilitar — em seguida, a conexão funciona sem nenhuma configuração extra.

A IA diz que a vaga não existe, mas eu sei que existe. O que fazer?

Quase sempre é permissão: o usuário vinculado ao token não está relacionado àquela vaga.

Peça ao administrador da sua empresa para incluir esse usuário como responsável, analista ou gestor da vaga.
Refaça a pergunta à IA.

Isso pode acontecer quando a empresa usa perfis restritos por alocação — a IA enxerga exatamente o mesmo que o usuário do token.

A IA pede um ID que eu não sei qual é. Preciso procurar?

Não. Deixe que ela descubra. A IA tem acesso às listas de clientes, times, usuários, etapas, benefícios, etiquetas, motivos de desqualificação, cidades, estados, idiomas e modelos de parecer.

Peça sempre pelo nome: “mova para a etapa de Proposta”, e não pelo número da etapa.
Se ela ainda perguntar, responda com o nome do item como está cadastrado no Abler.

A IA inventou um dado? Como conferir?

Peça a fonte: “de qual vaga você tirou isso?”. Todas as informações vêm de consultas ao Abler e podem ser conferidas na tela.

Confira o valor no sistema.
Se algo não bater, confie na tela e nos avise — é assim que melhoramos a integração.

Iniciei um hunting e não apareceu ninguém. É normal?

Sim, é normal. O hunting externo é assíncrono: a busca roda em segundo plano e os candidatos chegam aos poucos, marcados como ju_hunting, direto na triagem da vaga. Cada execução traz um lote — não o resultado inteiro de uma vez.

Peça à IA para “consultar o andamento do hunting” para acompanhar.
Confirme que a vaga está publicada e integrada à ju — sem isso, o hunting não roda.

O post do LinkedIn não publica. O que aconteceu?

A publicação na página da empresa segue três passos: gerar o texto, aguardar ficar pronto e só então publicar. Gerar não publica.

Peça para consultar o status do post.
Quando o texto estiver pronto, peça a publicação novamente.

Se a IA tentar publicar antes do texto ficar pronto, ela avisa — basta aguardar alguns instantes e tentar de novo.

O link do currículo parou de funcionar. Como resolvo?

Links de download de anexos são temporários, por segurança. Peça o arquivo novamente e um link novo é gerado na hora. É o comportamento esperado da integração, não uma falha.

Perguntas rápidas

Preciso instalar alguma coisa? Não. A conexão é por endereço web, direto na configuração do assistente.
Funciona no celular? Funciona onde o seu assistente de IA funcionar, inclusive nos aplicativos móveis que suportam MCP.
Posso conectar mais de um assistente ao mesmo tempo? Pode. Lembre-se de que os limites de consulta são contados por empresa, então assistentes e automações dividem a mesma cota.
Dá para automatizar rotinas? Sim. Plataformas como o n8n podem chamar as mesmas funções em fluxos automáticos.
A IA consegue ler o currículo em PDF do candidato? Ela consegue baixar o arquivo anexado à candidatura. A leitura do conteúdo depende do assistente que você usa.
Posso fazer upload de arquivos pela IA? Não. Você baixa anexos, mas o upload continua sendo feito pela tela do Abler.
Posso desligar a integração? A qualquer momento: peça ao suporte um novo token ou a desativação do acesso. O acesso antigo para de funcionar imediatamente.
Isso substitui a tela do Abler? Não. É um atalho para as tarefas do dia a dia. Relatórios, configurações e a visão completa do processo continuam no sistema.
Alguma função depende de módulo contratado? Sim: Hunting da ju (hunting na web e no LinkedIn), Abler Conversas (WhatsApp), LinkedIn — perfis pessoais e LinkedIn — página da empresa. Sem o módulo, a IA avisa que o recurso não está disponível em vez de falhar silenciosamente. E a API pública é pré-requisito para o MCP.

Se ainda ficar qualquer dúvida, é só dar um oi para o nosso time de Suporte 😊 Acesse: https://help.abler.com.br/como-acionar-o-suporte-da-abler