FoundRole MCP

Gerencie sua busca de emprego diretamente do seu assistente de IA.

Documentação

Servidor MCP FoundRole — Busca de Empregos com IA no ChatGPT, Claude e Cursor

Pergunte ao ChatGPT ou Claude sobre vagas e receba oportunidades reais de volta — cada uma verificada para saber se ainda está ativa, quanto realmente paga e se a empresa patrocina vistos. O servidor MCP FoundRole conecta seu assistente de IA ao quadro de vagas ao vivo, rastreador de candidaturas e base de conhecimento de carreira do FoundRole, para que toda a busca de emprego aconteça dentro do chat que você já usa.

Faça login uma vez — seu assistente cuida do resto. Na primeira vez que sua IA chamar o FoundRole, ela abrirá um login OAuth padrão; aprove-o uma vez no navegador e isso cobre tudo: busca, verificações, rastreador, lembretes e alertas. Não há chave de API para copiar ou rotacionar, e a conta é gratuita.

O que seu assistente pode fazer

  • Busque vagas ao vivo fazendo perguntas. Oportunidades direto das páginas de carreira das empresas, atualizadas a cada hora em mais de 40 setores. Linguagem natural é convertida em filtros reais — título do cargo, local, empresa, faixa salarial, data de publicação: "vagas remotas de React em Nova York pagando acima de US$ 130 mil publicadas esta semana."
  • Cada vaga verificada — grátis. Antes de você passar uma noite numa candidatura, três perguntas são respondidas com as evidências por trás de cada resposta:
    • Alguém está realmente contratando? Risco de vaga fantasma — se o cargo foi republicado por meses ou parece estar coletando currículos.
    • Estou sendo mal pago? O salário comparado ao que os empregadores daquele mercado realmente registram, para que uma faixa salarial oculta deixe de ser adivinhação.
    • Eles me patrocinariam? Se a empresa já patrocinou vistos antes, contabilizado ano a ano a partir de registros públicos.
  • Veja o quanto você se encaixa. Pontuação de compatibilidade com seu currículo e perfil, além de recomendações personalizadas de vagas ranqueadas por adequação.
  • Veja o que o software de recrutamento lê do seu currículo — grátis. Pergunte e receba a versão de você que um parser extrai: cargo, anos de experiência, habilidades reconhecidas, seções, dados de contato — além do que ele perde no caminho. É a leitura mecânica, determinística e repetível, para que a resposta não varie entre perguntas. Cole o texto no chat ou confira o currículo já salvo na sua conta.
  • Pesquise antes de se comprometer. Explore empresas, setores da indústria e contratações por local para decidir onde mirar.
  • Compare vagas lado a lado. "Compare estas duas" alinha compatibilidade, salário, patrocínio e risco de publicação de uma vez — para que a escolha deixe de ser uma sensação.
  • Cole uma vaga de qualquer lugar. LinkedIn, página de carreiras, um link que um amigo enviou — cole a vaga no chat e ela recebe as mesmas verificações, podendo ficar no seu rastreador junto com as listagens do FoundRole. Seu assistente lê o texto que você fornece; nada é rastreado no site por você.
  • Não perca o controle das candidaturas. Salve vagas no seu rastreador de candidaturas Kanban e mova-as entre Salvas → Candidatada → Em entrevista → Oferta → Contratada por meio de perguntas. Anexe notas, tags, salário esperado, contatos de recrutadores e prazos. O mesmo quadro aparece no aplicativo web.
  • Nunca perca um acompanhamento. Defina um lembrete em qualquer vaga rastreada e receba um e-mail com um convite de calendário (.ics) para Google Calendar, Outlook ou Apple Calendar.
  • Deixe a busca vir até você. Assine uma busca para receber alertas recorrentes por e-mail — diários, semanais ou mensais — para que novas correspondências cheguem à sua caixa de entrada.
  • Faça também as perguntas difíceis. Preparação para entrevistas, negociação salarial, táticas de currículo, pesquisa de empresas — respostas fundamentadas na base de conhecimento do FoundRole, com as fontes linkadas.
  • Veja resultados como painéis reais, não paredes de texto. Em clientes que suportam MCP Apps (entre eles o ChatGPT), resultados de busca, detalhes de vagas e seu rastreador são exibidos como painéis interativos direto no chat.

É a mesma conta e os mesmos dados do FoundRole.com — o servidor MCP apenas permite que sua IA os utilize.

Grátis vs Pro

Busca, verificações em cada vaga, rastreador, lembretes e alertas são gratuitos, sem limites de uso. O Pro adiciona triagem: peça somente remoto, somente com patrocínio, um piso salarial, vagas arriscadas ocultas ou uma compatibilidade mínima, e seu assistente filtra a lista antes que você a veja — e avisa quando o faz. Uma conta gratuita ainda recebe a lista completa, com uma nota de que esses filtros não foram aplicados.

Novo por aqui? O guia de busca com IA do FoundRole mostra passo a passo como conectar cada cliente, com FAQ.

Configuração

Duas formas de conectar, dependendo do seu cliente. De qualquer forma, seu cliente abrirá um login do FoundRole na primeira conexão — aprove-o uma vez e está pronto.

Opção 1 — Servidor remoto (recomendado)

Aponte seu cliente para o endpoint MCP do FoundRole:

https://www.foundrole.com/mcp

A maioria dos clientes modernos — ChatGPT, Claude, Cursor, VS Code — fala MCP remoto (Streamable HTTP) nativamente, então essa é toda a configuração necessária.

Opção 2 — Ponte stdio (para clientes sem MCP remoto)

Se seu cliente só suporta transporte stdio, execute este pacote localmente com npx; ele faz a ponte entre stdio e o endpoint do FoundRole e cuida do login OAuth para você:

npx @foundrole/ai-job-search-mcp

Conectando seu assistente de IA

ChatGPT

Tempo estimado: ~1 minuto

  1. Abra o FoundRole no diretório de aplicativos do ChatGPT.
  2. Clique em Adicionar e aprove o login do FoundRole quando o ChatGPT o abrir.
  3. Peça vagas em qualquer chat — sem configurações para ajustar, nada para colar.

Claude Web/Desktop

Tempo estimado: ~2 minutos

  1. Abra as configurações do Claude (ícone de perfil/configurações).

  2. Encontre Conectores (ou Ferramentas) e clique em Adicionar conector personalizado.

  3. Dê o nome de FoundRole.

  4. No campo URL do servidor MCP remoto, cole:

    https://www.foundrole.com/mcp
    
  5. Salve, permita que o Claude se conecte e aprove o login do FoundRole que ele abrir. Depois, peça vagas no chat.

Cursor

Tempo estimado: ~1 minuto

Instale o plugin do FoundRole no Marketplace do Cursor: abra Personalizar na barra lateral, encontre FoundRole e selecione Instalar. Aprove o login do FoundRole que o Cursor abrir e depois peça vagas em qualquer chat.

O plugin está neste repositório — .cursor-plugin/plugin.json com o servidor declarado em mcp.json. Para testá-lo antes de ser listado, crie um symlink deste repositório em ~/.cursor/plugins/local/ e recarregue a janela.

Configuração manual — Cursor / VS Code / Windsurf

No Cursor, abra Configurações → MCP e adicione isto em ~/.cursor/mcp.json:

{
  "mcpServers": {
    "foundrole": {
      "url": "https://www.foundrole.com/mcp"
    }
  }
}

No VS Code, adicione isto em .vscode/mcp.json no seu workspace (ou no seu mcp.json de usuário) — o VS Code usa uma chave diferente e precisa de um tipo de transporte explícito:

{
  "servers": {
    "foundrole": {
      "type": "http",
      "url": "https://www.foundrole.com/mcp"
    }
  }
}

Aprove o login do FoundRole quando seu editor o abrir e depois peça vagas no chat.

Antigravity (Google)

Tempo estimado: ~1 minuto

Instale o plugin direto deste repositório:

agy plugin install https://github.com/foundrole/jobs-mcp-proxy

Aprove o login do FoundRole que o Antigravity abrir e depois peça vagas na CLI. O plugin declara o servidor em mcp_config.json; para configurá-lo manualmente, adicione a mesma entrada em ~/.gemini/config/mcp_config.json:

{
  "mcpServers": {
    "foundrole": {
      "serverUrl": "https://www.foundrole.com/mcp"
    }
  }
}

Qualquer outro cliente MCP

O mesmo endereço funciona em todos os lugares: adicione https://www.foundrole.com/mcp como servidor remoto ou faça a ponte de clientes somente stdio com npx @foundrole/ai-job-search-mcp.

Nota: Após aprovar o login, alguns clientes precisam ser reiniciados (feche e reabra) antes que a conexão fique ativa.

Experimente dizer

  • "Encontre vagas de engenheiro backend sênior em São Francisco publicadas esta semana."
  • "Qual destas tem menos chance de ser uma vaga fantasma?"
  • "A Stripe patrocina vistos? Quanto esta vaga realmente paga?"
  • "Compare as vagas da Stripe e da Vercel em compatibilidade, salário e patrocínio."
  • "Aqui está uma vaga do LinkedIn — faça as mesmas verificações nela."
  • "Recomende vagas que correspondam ao meu currículo."
  • "Salve no meu rastreador e marque como Candidatada."
  • "Lembre-me de fazer o acompanhamento na terça de manhã."
  • "O que está na minha coluna Em entrevista agora?"
  • "Assine alertas semanais para vagas remotas de React."
  • "Como respondo a 'conte-me sobre seu currículo'?"

Segurança

  • OAuth 2.1 com PKCE. Você faz login no FoundRole por um fluxo de autorização padrão — tokens de curta duração, revogação instantânea, nenhuma credencial compartilhada com o cliente de IA, nenhuma chave de API para copiar, armazenar ou vazar.
  • Somente HTTPS, com registro dinâmico de clientes e validação de URI de redirecionamento.
  • Transporte Streamable HTTP (direto) ou stdio por meio deste proxy.
  • Nunca se candidata nem envia e-mails em seu nome.

Solução de problemas

Pedido de login / "requer autenticação":

  • Esperado na primeira conexão — o servidor autentica toda sessão. Complete o login do FoundRole na janela do navegador que seu cliente abrir.
  • Se as ferramentas ainda não aparecerem depois, reinicie o cliente ou reconecte o conector para que a autorização seja reenviada.

"Falha na conexão":

  • Verifique sua conexão com a internet e se a URL está exatamente como https://www.foundrole.com/mcp.
  • Confirme se seu cliente suporta MCP HTTP remoto; se não, use a ponte stdio (Opção 2).

"Comando não encontrado" (clientes stdio):

  • Instale o Node.js (veja engines em package.json para a versão necessária) e tente novamente, ou instale globalmente: npm install -g @foundrole/ai-job-search-mcp e execute ai-job-search-mcp.

Conector não funciona:

  • Verifique novamente a URL, complete o login e reinicie o cliente de IA — alguns clientes só reconhecem a conexão após reiniciar.

Explore os dados por trás das respostas

Os mesmos dados que seu assistente lê podem ser navegados no FoundRole:

  • Como Funciona — de onde vêm as vagas e como cada publicação recebe suas verificações de vaga fantasma, salário e visto
  • Explorador de Salários H1B — salários certificados que empregadores registraram no Departamento do Trabalho dos EUA, organizados por setor, indústria, local e cargo
  • Ranking de Patrocinadores H1B — principais empresas patrocinadoras de vistos por salário mediano registrado, navegável por indústria, setor, cidade e estado
  • Diretório de Empresas — vagas abertas, dados salariais e histórico de patrocínio de vistos de qualquer empregador
  • Setores da Indústria — quem está contratando em mais de 40 setores
  • Contratações por Local — vagas e referências salariais por estado e região metropolitana
  • Rastreador de Vagas — o quadro Kanban que seu assistente gerencia, no navegador
  • Verificador de Currículo — envie um currículo e veja o que o software de recrutamento lê dele, seção por seção
  • Construtor de Currículo — crie uma versão para cada vaga alvo e exporte em PDF, DOCX ou TXT gratuitamente, sem marca d'água
  • Quadro de Vagas ao Vivo — navegue pelas listagens diretamente

Ajuda


Conecte seu cliente de IA, faça login uma vez e conduza toda a busca de emprego pelo chat — busca, verificações, rastreamento, lembretes e alertas, gratuitos no FoundRole.

Feito pela equipe do FoundRole.