Conecte seu Curriculo ATS ao Claude, Cursor e qualquer cliente de IA compatível com MCP. O servidor MCP do Curriculo ATS é um servidor remoto, hospedado em https://mcp.curriculo.me/mcp, sem nada para instalar. Autentique-se uma vez com OAuth 2.1 ou um Token de Acesso Pessoal, e o cliente ganha 25 ferramentas que leem e agem sobre seus dados de contratação em tempo real.
Fonte: https://curriculo.me/docs/mcp/ (Curriculo ATS)
| Propriedade | Valor |
|---|---|
| Endpoint | https://mcp.curriculo.me/mcp |
| Transporte | HTTP transmitível |
| Autenticação | OAuth 2.1 + Token de Acesso Pessoal (PAT) |
| Escopos | ats:read, ats:write |
| Ferramentas | 25 |
O servidor MCP do Curriculo ATS é um servidor remoto, hospedado, sem nada para instalar ou executar localmente. Aponte qualquer cliente MCP para o endpoint, autentique-se uma vez, e o cliente ganha um conjunto de ferramentas que leem e agem sobre seus dados de contratação em tempo real.
Começo Rápido
Use este endpoint em todos os lugares: https://mcp.curriculo.me/mcp
O caminho mais rápido é o fluxo de conector de um clique do Claude:
- Abra o Claude, depois Configurações, depois Conectores.
- Clique em Adicionar conector personalizado e cole a URL do servidor acima.
- Complete a autenticação OAuth quando solicitado. O Claude se conecta à sua organização.
- Comece uma conversa e pergunte, por exemplo, "O que está em cada estágio das minhas funções abertas?"
Novo aqui? Siga o tutorial passo a passo executar seu ATS no Claude.
Conectar um cliente
O servidor fala HTTP transmitível e suporta tanto OAuth interativo quanto um Token de Acesso Pessoal via um cabeçalho Authorization: Bearer.
Claude
No Claude (web ou desktop), vá para Configurações, Conectores, Adicionar conector personalizado, em seguida, insira:
https://mcp.curriculo.me/mcp
Clique em Adicionar, complete a autenticação OAuth, depois abra o conector para ativar as ferramentas específicas que você deseja que o Claude utilize.
Código do Claude
Adicione o servidor com um único comando (OAuth abre em seu navegador via /mcp):
claude mcp add --transport http curriculo https://mcp.curriculo.me/mcp
Ou passe um Token de Acesso Pessoal diretamente com um cabeçalho:
claude mcp add --transport http curriculo https://mcp.curriculo.me/mcp \
--header "Authorization: Bearer SEU_PAT_CURRICULO"
Cursor
Abra as Configurações do Cursor, Ferramentas & MCP, Novo Servidor MCP, e adicione isso ao mcp.json:
{
"mcpServers": {
"curriculo": {
"url": "https://mcp.curriculo.me/mcp"
}
}
}
VS Code / outros
Qualquer cliente sem suporte nativo a MCP remoto pode usar a ponte mcp-remote:
{
"mcpServers": {
"curriculo": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.curriculo.me/mcp"]
}
}
}
Autenticação
Duas maneiras de autenticar. Ambas se resolvem em um usuário em uma organização com permissões limitadas.
OAuth 2.1 (recomendado)
Clientes interativos (Claude, Cursor) utilizam OAuth com registro dinâmico de cliente. Você faz login no Curriculo, aprova a conexão, e o cliente armazena um token de curta duração que ele atualiza automaticamente.
Token de Acesso Pessoal (PAT)
Para configurações de CLI ou sem cabeça, gere um token no ATS e envie-o como um cabeçalho Bearer:
- Faça login em ats.curriculo.me.
- Vá para Configurações, API & Integrações, Tokens de Acesso Pessoais.
- Crie um token, escolha seus escopos e copie-o (mostrado uma vez).
- Passe como
Authorization: Bearer <token>.
Escopos
- ats:read: Listar e ler empregos, candidatos, caixa de entrada, entrevistas, análises.
- ats:write: Criar e alterar dados: mover estágios, enviar email, agendar entrevistas, atualizar empregos.
Chame a ferramenta whoami para confirmar o usuário autenticado, organização, método de autenticação e escopos concedidos.
Referência de ferramentas (25 ferramentas)
As ferramentas de leitura nunca alteram dados. Ferramentas de escrita criam ou modificam registros e podem acionar e-mails, eventos de calendário ou automações.
Empregos (4)
list_jobs(leitura): Listar empregos em sua organização, mais recente atualizado primeiro. Parâmetros: status, página, limite.get_job(leitura): Detalhes completos de um emprego por UUID, incluindo estágios do funil e contagem de candidatos. Parâmetros: jobId (obrigatório).create_job(escrita): Criar uma postagem de emprego com estágios de funil padrão. Apenas o título é obrigatório; abre em rascunho. Parâmetros: título (obrigatório), descrição, localização, tipo, número de vagas, habilidades obrigatórias, habilidades preferidas, salário mínimo/máximo, moeda do salário.update_job_status(escrita): Alterar o status de um emprego (RASCUNHO / ABERTO / PAUSADO / FECHADO / ARMAZENADO). Parâmetros: jobId, status (ambos obrigatórios).
Candidatos (8)
list_applicants(leitura): Listar candidatos, opcionalmente limitado a um emprego, com filtros de destacados / rejeitados / arquivados. Parâmetros: jobId, destacado, rejeitado, arquivado, página, limite.get_applicant(leitura): Detalhe completo do candidato: estágio do funil, link do emprego, notas, histórico de atividades. Parâmetros: applicantId (obrigatório).search_candidates(leitura): Pesquisa semântica entre todos os candidatos. Parâmetros: query (obrigatório), jobId, timestamp, página, limite.move_applicant_stage(escrita): Mover um candidato para outro estágio do funil. Aciona automações do funil. Parâmetros: applicantId, funnelId (obrigatórios), razão.add_applicant_note(escrita): Adicionar uma nota a um candidato. Parâmetros: applicantId, conteúdo (obrigatório), noteType, decisionFlag, roundName.get_applicant_resume_text(leitura): Texto do currículo analisado e dados estruturados. Parâmetros: applicantId (obrigatório).get_applicant_evaluation(leitura): Avaliação de gráfico de agente de IA: pontuação de adequação, tags de IA, resumo, status de lacunas. Parâmetros: applicantId (obrigatório).reprocess_resume(escrita): Re-executar o pipeline de currículo (análise + avaliação + ingestão de gráfico). Parâmetros: applicantId (obrigatório).
Caixa de entrada & e-mail (5)
get_applicant_email_thread(leitura): Todo o histórico de e-mail de um candidato. Parâmetros: applicantId (obrigatório).list_inbox_emails(leitura): Listar e-mails recebidos na caixa de entrada da org. Parâmetros: jobId, status, busca, página, limite.get_inbox_stats(leitura): Estatísticas resumidas da caixa de entrada: contagens de não lidas e totais. Parâmetros: nenhum.reply_to_applicant_email(escrita): Responder a um candidato, encadeando no último e-mail recebido. Requer Gmail conectado. Parâmetros: applicantId, corpo (obrigatório), assunto.send_bulk_email(escrita): Enviar um e-mail para um ou mais candidatos por id. Requer Gmail conectado. Parâmetros: applicantIds, assunto, mensagemCorpo (todos obrigatórios).
Entrevistas (2)
list_interviews(leitura): Listar entrevistas. Parâmetros: jobId, applicantId, status, tipo, dateFrom, dateTo, página, limite.schedule_interview(escrita): Agendar uma entrevista, gerar links de feedback e (com Gmail) sincronizar um evento de calendário e e-mail para todos. Parâmetros: applicantId, jobId, título, scheduledStart, scheduledEnd (obrigatórios), além de tipo, localização, meetingProvider, participantIds, externalInterviewers, timezone, instruções.
Análises (2)
get_analytics(leitura): Visão geral das análises da org: total de candidatos, mudança de período, funil por estágio, empregos mais populares, mix de fontes. Padrão para os últimos 30 dias. Parâmetros: dateFrom, dateTo.get_dashboard(leitura): Caixa de entrada mais a divisão do funil por trabalho de candidatos ativos. Parâmetros: nenhum.
Automação & importações (3)
list_job_automations(leitura): Listar automações do funil configuradas para um emprego. Parâmetros: jobId (obrigatório).get_automation_executions(leitura): Histórico de execução para uma única automação, paginada. Parâmetros: automationId (obrigatório), página, limite.get_import_batch(leitura): Status de um lote de importação de candidatos: progresso, status por arquivo, erros. Parâmetros: batchId (obrigatório).
Conta (1)
whoami(leitura): Retornar o usuário autenticado, organização, método de autenticação e escopos concedidos. Parâmetros: nenhum.
Exemplos de prompts
- "Mostre-me o que está em cada estágio das minhas funções abertas e sinalize qualquer coisa parada."
- "Encontre engenheiros React sêniores com experiência de liderança de equipe e resuma os cinco principais."
- "Mova Priya para a Segunda Entrevista e redija uma resposta pedindo sua disponibilidade na próxima semana."
- "Agende uma entrevista em vídeo de 45 minutos com este candidato na quinta-feira às 14h ET e adicione um link do Google Meet."
- "Como o volume de candidatos mudou em relação ao mês passado, e qual emprego está convertendo melhor?"
Ferramentas de escrita têm efeitos colaterais reais (enviando e-mail, alterando pipelines, fechando empregos). Mantenha as aprovações de ferramentas ativadas para ações de escrita até que você confie em um fluxo de trabalho, e conceda apenas ats:read se você só deseja análise.
FAQ & solução de problemas
Preciso instalar ou hospedar algo?
Não. O servidor é totalmente hospedado em https://mcp.curriculo.me/mcp. Aponte seu cliente para a URL e autentique-se.
Quais clientes são suportados?
Qualquer cliente MCP que suporte servidores remotos sobre HTTP transmitível: Claude (web/desktop), Código do Claude, Cursor, VS Code e outros. Clientes sem suporte remoto nativo podem usar a ponte mcp-remote.
Minhas ferramentas mostram "Necessita login" ou não se conectam.
Reexecute o fluxo de OAuth (no Código do Claude, digite /mcp; no Cursor, clique em Necessita login). Se você usar um PAT, confirme que o cabeçalho é exatamente Authorization: Bearer <token> e que o token não foi revogado ou expirou.
Uma ferramenta de e-mail ou entrevista retorna um erro.
Ferramentas de e-mail e calendário (reply_to_applicant_email, send_bulk_email, o lado de e-mail de schedule_interview) requerem uma conexão Gmail ativa na organização. Conecte o Gmail no ATS e tente novamente.
Como faço para limitar o que a IA pode fazer?
Emita um token com apenas ats:read para acesso somente à análise e utilize as configurações de permissão de ferramenta do seu cliente para desabilitar ferramentas de escrita específicas.
Qual organização ela atua?
A que está vinculada ao seu token. Chame whoami para confirmar o usuário, organização e escopos a qualquer momento.
Segurança
- Acesso limitado. Cada token é vinculado a um usuário e organização e carrega escopos explícitos ats:read / ats:write.
- Menor privilégio. Conceda o escopo mais restrito que realiza a tarefa; prefira tokens somente para leitura para análise.
- Revogar a qualquer momento. Tokens de Acesso Pessoal podem ser revogados em Configurações, API & Integrações; conexões OAuth podem ser removidas das configurações do conector do seu cliente.
- Segurança de transporte. Todo o tráfego é HTTPS sobre HTTP transmitível. Nunca cole um token em clientes não confiáveis ou compartilhe-o em texto claro.
Versão HTML canônica: https://curriculo.me/docs/mcp/
