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
- Abra o FoundRole no diretório de aplicativos do ChatGPT.
- Clique em Adicionar e aprove o login do FoundRole quando o ChatGPT o abrir.
- Peça vagas em qualquer chat — sem configurações para ajustar, nada para colar.
Claude Web/Desktop
Tempo estimado: ~2 minutos
-
Abra as configurações do Claude (ícone de perfil/configurações).
-
Encontre Conectores (ou Ferramentas) e clique em Adicionar conector personalizado.
-
Dê o nome de
FoundRole. -
No campo URL do servidor MCP remoto, cole:
https://www.foundrole.com/mcp -
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
enginesempackage.jsonpara a versão necessária) e tente novamente, ou instale globalmente:npm install -g @foundrole/ai-job-search-mcpe executeai-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
- 🌐 Site: www.foundrole.com — busca de empregos gratuita com IA, rastreador de candidaturas e pesquisa de empresas
- 📖 Guia de configuração e FAQ: foundrole.com/ai-search-mcp
- 🐛 Problemas: GitHub Issues
- 💬 Perguntas: dev@foundrole.com
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.