Jobven

npx add-mcp 'https://api.jobven.com/mcp'

Use Jobven no Claude Code, Cursor, VS Code e Codex

Pesquise vagas e empresas da Jobven no seu assistente de codificação com o servidor MCP da Jobven, receba cada pesquisa de volta como uma solicitação REST e teste um receptor de webhook contra uma entrega de amostra assinada.

O servidor MCP da Jobven permite que seu assistente de codificação pesquise vagas e empresas da Jobven com sua chave de API. Cada resultado traz a solicitação REST que o produziu, como uma URL e um comando curl, para que uma pesquisa que você tenta no chat vá direto para o seu código.

URL	https://api.jobven.com/mcp
Transporte	HTTP Streamable
Autenticação	Sua chave de API da Jobven no cabeçalho X-API-Key (obtenha uma chave gratuita); webhook_example funciona sem uma
Medição	Igual à da API: cada vaga retornada conta para sua cota mensal

Conecte seu assistente

Coloque sua chave em uma variável de ambiente e adicione o servidor com um comando:

export JOBVEN_API_KEY="your-api-key"

claude mcp add --transport http --scope user jobven https://api.jobven.com/mcp --header 'X-API-Key: ${JOBVEN_API_KEY}'

• Claude Code armazena ${JOBVEN_API_KEY} e lê a variável a cada inicialização, em todos os projetos (--scope user).
• Codex armazena o nome da variável e envia a chave como Authorization: Bearer, que a Jobven aceita.
• VS Code salva o valor da chave no seu perfil de usuário do VS Code.
• Cursor não tem comando de instalação: adicione a configuração do Cursor abaixo em ~/.cursor/mcp.json para todos os projetos, ou .cursor/mcp.json para um único.

Ou adicione a um arquivo de configuração

Para compartilhar a configuração com uma equipe no repositório, use um arquivo de configuração. Cada um lê a chave da variável de ambiente JOBVEN_API_KEY ou de um prompt, então o arquivo não contém chave e é seguro para commit.

{
  "mcpServers": {
    "jobven": {
      "type": "http",
      "url": "https://api.jobven.com/mcp",
      "headers": {
        "X-API-Key": "${JOBVEN_API_KEY}"
      }
    }
  }
}

Depois, pergunte ao seu assistente algo como "encontre vagas remotas de TypeScript publicadas esta semana e mostre-me a solicitação".

Ferramentas

Ferramenta	O que retorna	Conta para sua cota
search_jobs	Vagas que correspondem aos filtros de GET /v1/public/jobs, 10 por página por padrão e no máximo 25, cada uma com um trecho em texto simples da descrição, além de nextCursor para a próxima página	Cada vaga retornada
get_job	Uma vaga por id com sua descrição completa, como texto simples ou markdown	Uma vaga
search_companies	Empregadores que correspondem aos filtros de GET /v1/public/companies	Não
get_company	Um empregador por id	Não
webhook_example	Uma entrega de amostra assinada para job.created, job.updated, job.closed ou job.deleted, com um verificador de assinatura em TypeScript, Python ou Go	Não

Toda ferramenta é somente leitura. Nenhuma delas cria, altera ou exclui nada na sua conta.

A solicitação por trás de cada resultado

search_jobs, get_job, search_companies e get_company retornam um request com a chamada exata que fizeram:

{
  "method": "GET",
  "url": "https://api.jobven.com/v1/public/jobs?q=engineer&remoteType=remote&limit=10&descriptionFormat=plain",
  "curl": "curl -H \"x-api-key: $JOBVEN_API_KEY\" 'https://api.jobven.com/v1/public/jobs?q=engineer&remoteType=remote&limit=10&descriptionFormat=plain'"
}

O comando curl lê sua chave de $JOBVEN_API_KEY. Sua chave nunca aparece em um resultado de ferramenta.

search_jobs solicita descrições em texto simples e retorna um trecho de cada uma, para que uma página de vagas permaneça pequena no contexto do seu assistente. No seu próprio código, remova descriptionFormat=plain para HTML, ou use markdown ou all, e aumente limit para o tamanho de página do seu plano (25 no Free, 50 no Starter, 100 no Growth e acima).

Testando um receptor de webhook

webhook_example retorna uma entrega exatamente como seu endpoint a recebe: o corpo bruto, cada cabeçalho e um Jobven-Signature assinado com um segredo de exemplo. O verificador que ele retorna é o de Verificação de assinatura, e aceita a amostra por 300 segundos, para que você possa enviar a amostra por POST ao seu receptor e verificá-la de ponta a ponta. Entregas reais são assinadas com o segredo de assinatura da sua assinatura, mostrado uma vez quando você cria a assinatura no painel.

Uso e limites

Chamadas MCP passam pela mesma API que seu código: as mesmas verificações de chave, limite de rajada, cota mensal e contagens de uso no seu painel.

Quando uma chamada é recusada, a ferramenta retorna a mensagem da própria API para que seu assistente possa explicá-la:

Mensagem começa com	Significado
This tool needs a Jobven API key	A conexão não enviou cabeçalho X-API-Key. Verifique a variável de ambiente que sua configuração lê.
Jobven API 401	A chave é desconhecida ou revogada. Crie uma nova na página Chaves de API.
Jobven API 429	A cota mensal foi usada ou o limite de rajada foi atingido. A mensagem diz quando tentar novamente. Veja Limites de taxa.

Listar as ferramentas e webhook_example não exige chave, então você pode experimentar o servidor, e diretórios e inspetores podem ver o que ele oferece, antes de se inscrever.

[

Apify e RapidAPI

Obtenha dados de vagas da Jobven por meio do Apify ou RapidAPI e pague na conta do marketplace que você já tem. As mesmas vagas dos sites de carreira dos empregadores que a API.

](https://jobven.com/docs/marketplaces)