Conecte o RolePark ao Claude, ao ChatGPT e a outros assistentes de IA
O conector do RolePark permite trabalhar com seus dados de recrutamento a partir de um assistente de IA: perguntar quem está em cada etapa, encontrar candidatos para uma vaga, ler um currículo, preparar entrevistas e acompanhar o funil de uma vaga e, se você permitir alterações, criar e publicar vagas, adicionar e atualizar candidatos, movê-los de etapa, agendar entrevistas, escrever e-mails a candidatos e criar notas e tarefas. O assistente trabalha com o seu acesso ao RolePark e nunca com mais.
Atualizado:
Endereço do servidor MCPhttps://rolepark.com/api/mcp
Para desenvolvedores de agentes de IA: como um agente obtém acesso (auth.md)
O que o conector faz e para quem é
O RolePark é um sistema de recrutamento e gestão de pessoas. O conector é um servidor MCP remoto: um assistente de IA como o Claude ou o ChatGPT chama as ferramentas do RolePark enquanto atende ao seu pedido, e você entra com a sua própria conta do RolePark. Não há chaves de API nem tokens para copiar.
É para quem trabalha no RolePark como parte de uma empresa: recrutadores, gestores de contratação, entrevistadores e administradores. Cada pessoa recebe exatamente o próprio acesso: um gestor de contratação vê as próprias vagas, e um entrevistador, as próprias entrevistas. Contas de candidato não podem conectar um assistente.
Em uma empresa que se cadastrou sozinha no RolePark, os agentes de IA já vêm ativados em “Visualizar e alterar”; em outras empresas, um administrador os ativa. Um administrador pode desativá-los ou escolher “Somente visualizar” ou “Visualizar e alterar” a qualquer momento em Configurações da empresa → Agentes de IA. Ainda assim, cada pessoa decide na tela de consentimento se o assistente pode fazer alterações.
Conectar no Claude
- No Claude, no navegador ou no aplicativo para computador, abra Customize → Connectors.
- Selecione “+ Add” e depois “Add custom connector”.
- Informe o nome RolePark e a URL do servidor MCP remoto https://rolepark.com/api/mcp e selecione Continue. Mantenha as configurações de autenticação que o Claude detectou e selecione Continue de novo; em OAuth client mantenha “Use Claude’s published identity (Recommended)” e depois selecione Add.
- Entre no RolePark quando o Claude pedir (ou selecione Connect ao lado do RolePark), confira a conta, a empresa e o acesso na tela de consentimento e selecione “Permitir”.
- Em uma conversa, abra “+” → Connectors e ative o RolePark.
Conectores personalizados funcionam nos planos Free, Pro, Max, Team e Enterprise; no Free, o Claude permite um. Nos planos Team e Enterprise, primeiro um Owner ou Primary Owner (no Enterprise, também uma função com a permissão Manage access to Libraries) adiciona o RolePark em Organization settings → Connectors → Add → Custom → Web com a mesma URL; depois cada membro o conecta em Customize → Connectors e entra com a própria conta do RolePark.
O RolePark se inscreveu no diretório de conectores do Claude, e a análise ainda não terminou. Enquanto o RolePark não estiver lá, conecte-o com os passos acima: é o mesmo conector. Quando ele estiver no diretório, adicioná-lo por lá funcionará do mesmo jeito: entre no RolePark e selecione “Permitir”.
O plugin do RolePark é outra coisa: um conjunto de cenários prontos, como um resumo diário, uma lista curta ou a preparação para uma entrevista, que usa este conector. Ele não substitui a conexão: conecte o RolePark primeiro.
Passos conferidos com as centrais de ajuda da Anthropic e da OpenAI em . Os menus delas mudam com frequência; os nomes seguem a interface em inglês.
Conectar no ChatGPT
O RolePark está no diretório de plugins do ChatGPT: abra a página dele pelo link abaixo, adicione o plugin, entre no RolePark e selecione “Permitir”. Em um workspace Business, Enterprise ou Edu, pode ser que um administrador ou proprietário precise liberá-lo antes para todo o workspace.
Conectar manualmente
O que é preciso, segundo a central de ajuda da OpenAI: servidores MCP personalizados são conectados no ChatGPT na web, não nos aplicativos móveis. O suporte completo, visualizar e alterar, está nos planos Business, Enterprise e Edu. Para o Pro, a OpenAI descreve servidores MCP personalizados apenas com acesso de leitura (read e fetch), então alterações no RolePark podem não estar disponíveis ali; para outros planos, esse caminho não é descrito.
Em um workspace Business, somente administradores e proprietários podem adicionar um servidor MCP personalizado. No Enterprise e no Edu, um administrador também pode dar aos membros a permissão “Create plugins with MCPs”; somente administradores e proprietários publicam uma conexão para todo o workspace.
- Em chatgpt.com, abra Plugins na barra lateral.
- Selecione o botão “+” e depois “Add custom MCP server”. Não é preciso ativar o Developer mode antes.
- Informe o nome RolePark e, em Connection, a URL do servidor MCP https://rolepark.com/api/mcp. Escolha OAuth como autenticação: não há chaves nem tokens para colar.
- Leia o aviso de risco, marque “I understand and want to continue” e selecione “Create as a plugin”. Quando o ChatGPT abrir o RolePark, entre e selecione “Permitir”; depois confira as ferramentas que o ChatGPT encontrou.
- Instale o plugin se o ChatGPT oferecer. Em uma nova conversa, digite @ e selecione o RolePark.
Se o seu ChatGPT ainda mostra as configurações antigas de Apps
- Administradores e proprietários: Workspace settings → Apps → Create. Outros membros autorizados: Settings → Apps → Create.
- Informe o nome RolePark e a URL https://rolepark.com/api/mcp, escolha OAuth e selecione Scan Tools. Entre no RolePark, selecione “Permitir”, aguarde o fim da verificação e selecione Create.
- O aplicativo aparece como rascunho com o rótulo Dev. Em um workspace, um administrador ou proprietário o publica em Workspace settings → Apps → Drafts → Publish para que os membros possam usá-lo.
Se essas opções não aparecem
- Confira se você está no ChatGPT na web e no workspace certo (troque no menu da conta).
- Em um workspace Business, Enterprise ou Edu, peça a um administrador ou proprietário que adicione o RolePark para o workspace ou, no Enterprise e no Edu, que lhe dê a permissão “Create plugins with MCPs”.
- Se no seu plano não houver nem Plugins → Add custom MCP server nem Settings → Apps → Create, o ChatGPT não oferece ali a conexão manual. Enquanto isso, use o Claude ou outro cliente MCP e acompanhe as mudanças no artigo de ajuda da OpenAI “Connecting custom MCP servers in ChatGPT”.
- Se não conseguir adicionar o RolePark pelo diretório, conecte-o manualmente com os passos acima: é o mesmo conector.
Passos conferidos com as centrais de ajuda da Anthropic e da OpenAI em . Os menus delas mudam com frequência; os nomes seguem a interface em inglês.
O que você autoriza
A tela de consentimento do RolePark mostra qual aplicativo está pedindo acesso, com qual conta e em qual empresa você entrou, e dois tipos de acesso:
- “Visualizar” (rolepark.read) — candidatos e o texto dos currículos, vagas e suas estatísticas, funis de contratação e candidaturas, correspondências, entrevistas, avaliações e suas tarefas: o que você mesmo pode ver.
- “Fazer alterações” (rolepark.write) — criar, editar, publicar, pausar e encerrar vagas, adicionar e editar candidatos e tags, adicionar notas, movê-los de etapa, analisar candidaturas recebidas, agendar, remarcar e cancelar entrevistas, enviar avaliações, escrever e-mails a candidatos, criar tarefas e, para um administrador da empresa, editar o perfil da empresa. É uma escolha separada, disponível somente se a sua empresa permitir visualizar e alterar. Permite que o assistente chame essas ferramentas; não é uma confirmação separada de cada ação.
O assistente recebe o seu acesso e nunca mais do que isso: campos ocultos para você também ficam ocultos para ele. Cada alteração que ele faz é registrada no log de auditoria da empresa como ação sua, com o nome do aplicativo. O que você abre pelo assistente é tratado pelo provedor dele, por exemplo a Anthropic ou a OpenAI, conforme o seu acordo com ele.
Ferramentas
O assistente trabalha com as ferramentas do servidor MCP do RolePark para candidatos, candidaturas e funis de contratação, entrevistas e avaliações, vagas e sites de vagas, e-mails para candidatos, tarefas e busca, sua memória de IA e suas metas, e o perfil da empresa; as que alteram dados só funcionam se você permitir alterações, exceto as da sua própria memória de IA.
Exemplos de pedidos
Escreva como escreveria para um colega. Por exemplo:
- Quem está na etapa de entrevista final da vaga Senior Java Developer?
- Encontre na nossa base candidatos para a vaga Product Designer e resuma os cinco mais fortes.
- Quais entrevistas eu tenho esta semana? Me dê uma linha sobre cada candidato.
- Resuma o perfil de Ana Souza e os últimos comentários da equipe antes da minha ligação.
- Mova Ana Souza para a etapa de oferta na vaga QA Engineer e crie uma tarefa para eu enviar a oferta amanhã.
- Adicione Pedro Lima (pedro@example.com) como candidato por indicação e coloque-o na vaga DevOps Engineer.
- Agende uma entrevista técnica de 45 minutos com Ana Souza para a vaga QA Engineer na quinta às 14h, horário de Brasília, comigo e com o Rafael como entrevistadores.
- Quais das minhas tarefas estão atrasadas?
- Como está a vaga Product Designer: conversão entre etapas e de onde vêm os candidatos?
- Prepare um e-mail para Pedro Lima sobre o próximo passo na vaga DevOps Engineer, mostre para mim e envie só depois que eu confirmar.
Limitações
- O assistente não pode excluir candidatos, vagas ou notas, alterar as configurações da empresa ou o acesso dos agentes de IA, gerenciar usuários, funções ou cobrança, conectar sites de vagas nem publicar nos pagos. Ele lê o texto extraído de um currículo, se você puder abrir esse currículo, mas não baixa, envia nem anexa arquivos de currículo. Textos longos, como notas, são encurtados.
- Mover um candidato para oferta, contratado ou reprovado envia um e-mail ao recrutador e ao gestor de contratação da vaga (exceto a quem fez a mudança e a quem desativou esses avisos); o candidato não recebe e-mail pela mudança. Se, ao mover para contratado ou reprovado, ainda houver entrevistas agendadas, a mudança é recusada até você concordar em cancelá-las; então o candidato, os entrevistadores, o organizador e o gestor de contratação recebem o e-mail de cancelamento. Mover para oferta mantém as entrevistas agendadas.
- Até 120 solicitações por minuto por pessoa e 600 por empresa; acima disso, o RolePark pede ao assistente que espere.
- Algumas alterações chegam a pessoas fora da conversa: agendar, remarcar ou cancelar uma entrevista avisa o candidato e os entrevistadores como no RolePark, um e-mail a um candidato é enviado na hora e não pode ser recuperado, e publicar ou encerrar uma vaga muda a sua página de carreiras. Se o assistente pergunta antes dessa chamada depende das configurações dele: o Claude e o ChatGPT podem pedir confirmação, mas se você permitir uma ferramenta de forma permanente (por exemplo, “Allow always” no Claude ou as permissões do app no ChatGPT), e-mails e publicações podem sair sem uma pergunta separada. O RolePark executa na hora uma chamada permitida. Para e-mails a candidatos e publicações, peça ao assistente que mostre o texto antes e dê um “sim” explícito.
- Textos de currículos, e-mails, notas e comentários chegam ao assistente como dados, não como instruções. Mesmo assim, confira o que o assistente propõe antes de permitir uma alteração.
- As respostas são escritas pelo modelo de IA do seu assistente e podem estar erradas. Confira decisões importantes no RolePark.
Se algo não funcionar
“Os agentes de IA estão desativados na sua empresa”
Um administrador da empresa pode ativá-los em Configurações da empresa → Agentes de IA. Depois, comece a conexão novamente no seu assistente.
“Para conectar um agente, entre com uma conta da empresa”
Esta conta não pertence a nenhuma empresa, por exemplo uma conta da plataforma. Entre com a sua conta de funcionário da empresa; para trocar de conta, a tela de consentimento tem “Não é você? Sair”.
“Este link de conexão não é mais válido”
O login demorou demais ou o link foi aberto duas vezes. Comece a conexão novamente no seu assistente.
O assistente diz que o RolePark recusou o pedido
Talvez você não tenha acesso a esse item no RolePark, ou a conexão tenha somente o acesso “Visualizar”. Se a sua empresa permitir alterações, desconecte o assistente e conecte de novo marcando “Fazer alterações”.
O conector mostra um erro, nenhuma ferramenta ou não todas
Confira se o endereço é exatamente https://rolepark.com/api/mcp. No Claude, remova o conector e adicione de novo. No ChatGPT, abra o RolePark em Plugins, selecione Refresh e comece uma nova conversa; em um workspace, as novas ferramentas do RolePark só aparecem depois que um administrador atualiza o aplicativo nas configurações do workspace.
Ainda não funciona
Escreva para nós (veja Suporte abaixo): qual assistente você usa, quando aconteceu e o texto exato do erro. Por favor, não envie dados pessoais de candidatos.
Como desconectar
- No RolePark: Perfil → Agentes de IA → “Desconectar”. O assistente perde o acesso imediatamente.
- Um administrador da empresa vê ali todas as conexões da empresa e pode desconectar qualquer uma, ou desativar os agentes de IA para todos em Configurações da empresa → Agentes de IA. Quando um usuário é desativado, todas as conexões dele deixam de funcionar.
- No assistente: no Claude, Customize → Connectors → RolePark → Remove; no ChatGPT, remova o RolePark em Plugins (nas configurações antigas, Settings → Apps). Isso não exclui as conversas que o provedor do assistente já armazenou.
Suporte
Dúvidas, problemas ou relatos de segurança: help@rolepark.com