Servidor Curriculo ATS MCP

Conecte o seu Curriculo ATS ao Claude, Cursor e a qualquer cliente MCP que faça Streamable HTTP, ou ao ChatGPT através de um GPT personalizado. Peça em linguagem simples para analisar os candidatos, mover os canais, responder aos candidatos, agendar entrevistas e fazer análises. O seu cliente AI faz o trabalho diretamente no seu ATS.

O servidor é remoto e hospedado, por isso não há nada para instalar ou executar localmente. Aponta qualquer cliente MCP no ponto final, autentique uma vez, e o cliente ganha ferramentas que lêem e agem em seus dados de contratação em tempo real.

Um produto diferente do público API, com autenticação diferente. O MCP fala com o Curriculo ATS e o usuário faz login. Um API público key_ não atinge estas ferramentas, e o API público não atinge o seu ATS.

O que é o servidor Curriculo ATS MCP?

O servidor Curriculo ATS MCP é um endpoint hospedado, https://mcp.curriculo.me/mcp, que permite que os clientes Claude, ChatGPT, Cursor e outros MCP leiam e atuem no seu Curriculo ATS. Inscreve-se uma vez com o OAuth ou um token de acesso pessoal, e depois pede em linguagem simples para analisar os candidatos, mover os estágios, responder aos candidatos ou agendar entrevistas.

Ação de arranque

Use este ponto final em cada cliente MCP:

https://mcp.curriculo.me/mcp

O caminho mais rápido é o fluxo do conector do Claude:

1. Abre Claude, depois Customize, depois Conectores.
2. Clique em Adicionar conector personalizado e colar o servidor URL acima.
3. Complete a inscrição do OAuth para o quando solicitado. O Claude liga-se à sua organização.
4. Comece uma conversa e pergunte, por exemplo, "O que está sentado em cada etapa dos meus papéis abertos?"

Novos aqui? Siga o tutorial passo-a-passo do : execute o seu ATS no Claude, que percorre a conexão, classifica os candidatos por AI e agenda entrevistas a partir de um bate-papo.

Conectar um cliente

Qualquer cliente que fale Streamable HTTP funciona. Autenticar com o OAuth 2.1 ou com um token de acesso pessoal enviado num cabeçalho Authorization: Bearer . A configuração para clientes comuns segue.

Claude

Em Claude (web ou desktop), vá para Customize,Connectors,Adicionar conector personalizado, e depois inserir:

https://mcp.curriculo.me/mcp

Clique em Adicione, complete o login OAuth, em seguida, abra o conector para ativar as ferramentas específicas que você deseja que o Claude use.

Código Claude

Adicione o servidor com um único comando. OAuth abre no seu navegador através de /mcp:

claude mcp add --transport http curriculo https://mcp.curriculo.me/mcp

Ou passar um token de acesso pessoal diretamente com um cabeçalho:

claude mcp add --transport http curriculo https://mcp.curriculo.me/mcp \
  --header "Authorization: Bearer YOUR_CURRICULO_PAT"

Execute o /mcp dentro do código Claude para verificar o status ou ativar o login OAuth.

Cursor

Abra o Customize o na barra lateral do Cursor e adicione isso para mcp.json:

{
  "mcpServers": {
    "curriculo": {
      "url": "https://mcp.curriculo.me/mcp"
    }
  }
}

O Cursor mostra que o precisa de login para o. Clique nele para executar o fluxo de consentimento do OAuth e as ferramentas ficam verdes.

Código VS e outros clientes

Qualquer cliente sem suporte remoto nativo do MCP pode usar a ponte mcp-remote :

{
  "mcpServers": {
    "curriculo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.curriculo.me/mcp"]
    }
  }
}

Para autenticar sem cabeçalhos, adicione um argumento de cabeçalho:

"args": ["-y", "mcp-remote", "https://mcp.curriculo.me/mcp",
         "--header", "Authorization: Bearer YOUR_CURRICULO_PAT"]

ChatGPT (Ações GPT personalizadas)

O ChatGPT conecta através de um GPT personalizado com Ações, usando uma superfície REST que reflete as 25 ferramentas MCP.

1. Em ChatGPT, crie um GPT e abra Configure, então Ações, então Crie uma nova ação.

2. Importar o esquema a partir deste URL:

   https://mcp.curriculo.me/api/v2/mcp/openapi.json

3. Configurar Authentication para OAuth, com um cliente ID e secreto do https://mcp.curriculo.me/api/v2/ats/oauth/register e estes valores do esquema:

   Configuração	Valor
   Autorização URL	https://mcp.curriculo.me/api/v2/ats/oauth/authorize
   Token URL	https://mcp.curriculo.me/api/v2/ats/oauth/token
   Ámbito de aplicação	ats:read ats:write

4. Salvar, depois fazer login no Curriculo ATS e aprovar o acesso quando o GPT chamar uma ação pela primeira vez.

Autenticação

Duas maneiras de autenticar. Ambos resolvem-se a um usuário numa organização.

OAuth 2.1 (recomendado)

Os clientes interativos (Claude, Cursor, ChatGPT) utilizam o OAuth 2.1 com o fluxo de código de autorização. O registro de cliente dinâmico é suportado, o PKCE (S256) é necessário para os clientes públicos e os URIs redirecionados devem ser https. Você faz login no Curriculo ATS, aprova a conexão, e o cliente armazena um token de curta duração que atualiza automaticamente. Com Claude e Cursor não há segredos para copiar ou girar à mão. Os metadados do servidor são publicados em https://mcp.curriculo.me/.well-known/oauth-authorization-server.

Token de acesso pessoal

Para CLI ou configurações sem cabeça, gerar um token no ATS e enviá-lo como um cabeçalho portador:

1. Inscrever-se em ats.curriculo.me.
2. Vá para Configurações ****,Desenvolvedores,Tokens de Acesso Pessoal.
3. Crie um token, escolha a sua expiração e copie-o. É mostrado uma vez.
4. Passe-o como Authorization: Bearer <token>, como mostrado nas etapas de configuração acima.

Capacitação

Os tokens possuem um ou ambos os escopo.

Não tens a certeza de como está a agir? Liga para a ferramenta whoami . Retorna o usuário autenticado, organização, método de aut e escopo concedido.

Referência de ferramentas

25 ferramentas. O tipo de acesso diz-lhe o risco:

• Leia apenas o .
• Escreva mudanças ATS dados.
• Write+ altera dados e chega para fora: um e-mail sai, um convite é enviado ou um trabalho AI começa.

17 das vinte e cinco ferramentas são somente de leitura. As sete ferramentas Write+ têm consequências externas; se o assistente confirma a intenção antes de usá-las depende do seu cliente. Nenhuma ferramenta elimina um registro, mas o reprocess_resume sobreescreve a avaliação AI armazenada.

Empregos

Candidatos

Caixa de entrada e e-mail

Entrevistas

Análise

Automatização e importações

Conta

As ferramentas de e-mail enviam da caixa de correio de Curriculo, por isso funcionam sem uma caixa de correio conectada. A programação de entrevistas também funciona sem calendário: ainda guarda a entrevista, mas uma entrevista por vídeo não recebe ligação para a reunião e os convites não são enviados.

Exemplos de instruções

Uma vez conectado, pergunte em linguagem simples. O cliente escolhe as ferramentas certas.

• "Mostra-me o que está sentado em cada etapa dos meus papéis abertos, e sinaliza qualquer coisa parada".
• "Encontre engenheiros seniores da React com experiência na liderança da equipe e resuma os cinco melhores".
• "Move Priya para a segunda entrevista e redigir uma resposta pedindo a sua disponibilidade na próxima semana".
• "Agendem uma entrevista de vídeo de 45 minutos com este candidato na quinta-feira às 14h ET e adicione um link para o Google Meet".
• "Como mudou o volume de candidatos em relação ao mês passado, e qual trabalho está melhor a converter?"

As ferramentas de escrita têm efeitos colaterais reais: enviar e-mails, mudar pipelines, fechar empregos. Mantenha as aprovações de ferramentas ativadas para as ações de escrita até confiar num fluxo de trabalho.

Segurança

• Acesso esculpido. Cada token está vinculado a um usuário e organização. Tudo o que o assistente vê é limitado à sua própria organização.
• Menos privilégio. As metas ainda não são aplicadas; desligue as ferramentas de escrita nas configurações de ferramentas do cliente para análise.
• Revocar a qualquer momento. Os tokens de acesso pessoal podem ser revogados nas configurações ****,Developers. As conexões OAuth podem ser removidas das configurações do conector do seu cliente.
• Segurança de transporte. Todo o tráfego é HTTPS sobre o Streamable HTTP. Nunca coloque um token em clientes não confiáveis ou compartilhe em texto simples.

Parte do hub Curriculo ATS MCP, que liga os guias de configuração, as referências de ferramentas e os documentos de conector.

Próximos passos

• Slack através de MCP: use estas ferramentas do Slack.
• Guia de configuração do Agente de E-mail: conecte a sua caixa de entrada de contratação e calendário.
• Curriculo ATS MCP hub: guias de configuração e os documentos de conector.