CurriculoCurriculo

Documentação do Servidor MCP do Curriculo ATS

Documentação do Curriculo ATS MCP Server — curriculo ATS.

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)

PropriedadeValor
Endpointhttps://mcp.curriculo.me/mcp
TransporteHTTP transmitível
AutenticaçãoOAuth 2.1 + Token de Acesso Pessoal (PAT)
Escoposats:read, ats:write
Ferramentas25

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:

  1. Abra o Claude, depois Configurações, depois Conectores.
  2. Clique em Adicionar conector personalizado e cole a URL do servidor acima.
  3. Complete a autenticação OAuth quando solicitado. O Claude se conecta à sua organização.
  4. 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:

  1. Faça login em ats.curriculo.me.
  2. Vá para Configurações, API & Integrações, Tokens de Acesso Pessoais.
  3. Crie um token, escolha seus escopos e copie-o (mostrado uma vez).
  4. Passe como Authorization: Bearer <token>.

Escopos

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)

Candidatos (8)

Caixa de entrada & e-mail (5)

Entrevistas (2)

Análises (2)

Automação & importações (3)

Conta (1)

Exemplos de prompts

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


Versão HTML canônica: https://curriculo.me/docs/mcp/

Ready to hire with precision?

Start free, invite your whole team, and see your first scored candidate in 15 minutes.