Integrações

Conectar Assistentes de IA (MCP)

Conecte qualquer assistente de IA compatível com MCP — Claude, Claude Code, ChatGPT, Cursor, VS Code e mais — aos seus dados de contratação do Flowmingo e trabalhe no seu pipeline em linguagem natural.

Our team is online
Precisa de ajuda com a integração?

Travou em alguma etapa ou precisa de suporte técnico? A nossa equipa terá todo o gosto em ajudar — fale connosco a qualquer momento e nós tratamos de o conectar.

Visão Geral

Conecte qualquer assistente de IA compatível com MCP aos seus dados de contratação do Flowmingo — leia suas vagas e candidatos e execute ações protegidas (convidar, mover, rejeitar, remover de um projeto), com segurança e com sua permissão. Com duas permissões extras que você ativa manualmente, um assistente também pode criar projetos de contratação e avaliações, além de publicar, fechar ou impulsionar uma vaga (veja O que você pode fazer). Novo no MCP? É o padrão aberto que permite que assistentes de IA conversem com ferramentas como o Flowmingo. Saiba o que é MCP.

Transporte: Streamable HTTP (o transporte remoto moderno). Não há SSE legado — sempre aponte seu cliente para /mcp, nunca para /sse.

Trate sua chave de API como uma senha. Prefira OAuth, uma entrada solicitada ou uma variável de ambiente em vez de colar uma chave bruta fl_... em um arquivo que você possa enviar para o git (por exemplo, .vscode/mcp.json, ~/.cursor/mcp.json, sua configuração do Continue).

Autenticação — duas opções

A — Entre com o Flowmingo (OAuth, recomendado). Seu navegador abre uma página de consentimento do Flowmingo; você cola sua chave de API nela. O assistente nunca recebe sua chave bruta. Ele recebe um token de acesso e um token de atualização, que pode usar para obter um novo token de acesso. O login não dura para sempre. O token de atualização dura cerca de 30 dias por padrão, contados a partir da emissão, no login ou na atualização mais recente, então um login que fica sem uso por esse período expira, e uma versão do Flowmingo que mude como os logins são armazenados também pode exigir que você entre novamente. O assistente então pede que você entre novamente, e você cola sua chave novamente. Para interromper antes, exclua essa chave de API. Não há ID de cliente ou segredo para criar (o Flowmingo usa Registro Dinâmico de Cliente). Em clientes que mostram configurações de OAuth "Avançadas" (por exemplo, Claude.ai), deixe o Client ID e o Secret em branco.

B — Chave de API estática (cabeçalho). Envie sua chave como um dos cabeçalhos:

x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY

Obtenha sua chave em Flowmingo → Configurações → Integrações → Chaves de API. Marque Read hiring data e Read candidates — o primeiro cobre vagas, funil e resultados, o segundo é o que permite que um assistente pesquise alguém. Adicione Manage pipeline / Invite candidates para as ações de escrita protegidas. Para permitir que um assistente crie projetos e avaliações e publique ou impulsione uma vaga, marque também Create hiring projects e Create assessments. Leia Criar e publicar em O que você pode fazer primeiro: essas duas permissões são opcionais, e o criador da chave deve ser um Proprietário ou um Administrador.

Como é uma chave completa. Um valor longo: fl_live_, o nome público da chave, um ponto, e depois um segredo longo. A metade do segredo é mostrada uma vez, logo após criar a chave; depois, a lista de Chaves de API mostra apenas o início. Um valor sem ponto é apenas o nome da chave e será recusado. Sempre que este guia escrever fl_YOUR_KEY, substitua tudo por sua chave completa, sem aspas e sem espaços.

Se não conectar. Uma chave inválida ou vazia retorna Missing credential ou The Flowmingo API key was rejected; ambos podem significar que o valor nunca chegou completo até nós, então verifique o valor primeiro. Uma configuração como ${env:FLOWMINGO_API_KEY} só funciona se o programa puder ver essa variável, e um editor aberto pelo dock ou pelo menu Iniciar geralmente não lê o perfil do terminal. Inicie-o a partir de um terminal onde a variável está definida ou coloque sua chave completa no arquivo (e mantenha esse arquivo fora do git).

Qual escolher? A maioria dos clientes suporta ambos; alguns (por exemplo, ChatGPT) são somente OAuth — cada aba observa o que esse cliente suporta. Em geral, o OAuth é adequado para assistentes interativos (Claude.ai, ChatGPT, VS Code); o cabeçalho de chave de API é adequado para CLIs, headless/CI e editores onde você prefere inserir uma chave.

O que você pode fazer

Leituras não precisam de aprovação. A maioria das escritas é protegida. Um convite, uma rejeição feita com a ação Rejeitar, uma remoção de candidatos de um projeto, uma exclusão de um projeto ou, normalmente, uma movimentação para uma etapa configurada para enviar e-mail ao candidato aguarda a aprovação de uma pessoa em um link, com login no Flowmingo. O assistente não pode aprovar, e um "sim" digitado no chat não conta. A configuração de e-mail da etapa é verificada quando a movimentação é solicitada. Para uma nota, uma classificação, uma lista de seleção, uma tag ou uma movimentação para uma etapa que não está configurada para enviar e-mail ao candidato, o assistente é instruído a mostrar uma prévia primeiro e a prosseguir somente quando você concordar, o que é uma instrução para ele, não um bloqueio. Um aviso que seu cliente de IA mostra antes de executar uma ferramenta é do próprio cliente e não é a aprovação do Flowmingo: um convite, uma rejeição feita com a ação Rejeitar e uma movimentação para uma etapa que envia e-mail ainda aguardam o link de aprovação, independentemente do que o cliente pediu. Um link de aprovação expira após 15 minutos, e uma solicitação para vários candidatos ou inscrições (no máximo 50) é uma aprovação que lista todos. Uma vez que uma mudança é preparada, o assistente pode verificar o status, retirá-la enquanto ainda aguarda e desfazer uma mudança reversível (uma nota, uma classificação, uma marca de lista de seleção, uma tag ou uma movimentação que não enviou e-mail a ninguém) dentro de 24 horas. Uma reversão nem sempre está disponível: a mudança precisa voltar com uma referência de reversão, registrar uma é um esforço melhor, e uma movimentação para um candidato sem etapa anterior não tem nenhuma, então o assistente deve verificar e informar quando não houver como voltar. Um e-mail enviado não pode ser desfeito. As ferramentas listadas em Criar e publicar são a exceção a tudo isso, exceto delete_project: elas agem imediatamente e não são preparadas para aprovação. Uma remoção e uma exclusão de projeto não podem ser desfeitas. Tudo é limitado à sua organização.

Leitura

Capacidade O que faz
Listar vagas Navegue pelas funções abertas e fechadas da sua organização.
Listar conjuntos de entrevistas e projetos Veja suas avaliações (conjuntos de entrevistas) de todos os tipos (entrevistas de IA, role-plays, Testes de Habilidade, Testes Técnicos, avaliações de CV, Showcases e gravações; questionários quando você pedir) e seus projetos de contratação.
Listar seu funil de candidatos Veja as inscrições por etapa em um projeto.
Ler resultados e pontuações de avaliação Obtenha resultados de todos os tipos: entrevistas de IA, role-plays, Testes de Habilidade, Testes Técnicos, avaliações de CV, Showcases, gravações e questionários. Cada resultado é rotulado com seu tipo. Apenas alguns tipos têm pontuação de IA: um Showcase e um questionário nunca são pontuados, e um Teste de Habilidade é uma porcentagem.
Consultar um candidato Obtenha o nome, e-mail e CV de um candidato.
Pesquisar candidatos Encontre candidatos por nome ou e-mail.
Comparar candidatos Alinhe de 2 a 10 candidatos lado a lado. Precisa da permissão Read candidates além de Read hiring data.
Visão geral de contratação O funil para tudo que sua conexão pode alcançar (toda a empresa, a menos que a chave tenha sido criada por alguém limitado a alguns projetos), ou reduzido quando você pedir: inscrições por etapa, ativas vs rejeitadas e, para cada tipo de avaliação que tem resultados, resultados concluídos vs em andamento e a pontuação média. Um projeto reduz todas as contagens, mas suas contagens de resultados cobrem os resultados nas avaliações vinculadas a esse projeto, então um candidato de outro projeto que compartilha uma dessas avaliações também pode ser contado. Uma avaliação reduz apenas as contagens de resultados: as contagens de etapa e de inscrições permanecem em tudo que sua conexão pode alcançar. Os tipos nunca são somados.
Melhores candidatos Os resultados mais bem classificados, ordenados por pontuação geral. Todos os tipos de avaliação são classificados juntos, a menos que você peça um tipo ou uma avaliação (conjunto de entrevistas).
Detalhe do resultado de avaliação Pontuações por competência de um resultado mais o resumo de IA, para os tipos que os têm. Um Teste de Habilidade, um Teste Técnico, um Showcase e um questionário têm pouco ou nenhum.
Detalhe da vaga O detalhe completo de uma única vaga.
Uma vaga está aberta ao público? (get_job_post_publication) Se qualquer pessoa pode abrir a página pública de uma vaga: ativa, ainda aguardando a verificação de conteúdo de IA, recusada por ela, sinalizada, desativada, ou se o projeto não está aberto. Também seu endereço público e seu impulso (desligado, flowmingo ou estendido). Precisa de Read hiring data.
Próximas entrevistas Convites para qualquer tipo de avaliação que foram enviados ou estão agendados e ainda não foram concluídos. Não é uma contagem de todos os pendentes: um convite cujo candidato foi lembrado, ou abriu ou clicou no link, é deixado de fora até o candidato começar, e também aquele que falhou na entrega.

Escrita (protegida)

Capacidade O que faz
Convidar candidatos para uma avaliação Prepara os convites para uma entrevista de IA, um role-play, um Teste de Habilidade ou um Teste Técnico e aguarda a aprovação de uma pessoa em um link. Nada é enviado antes disso. Uma avaliação e no máximo 50 candidatos por solicitação; um Teste de Habilidade ou um Teste Técnico precisa de um projeto e um e-mail para cada candidato, e um patrocinado pode debitar a carteira da sua organização quando um candidato começa.
Mover um candidato para outra etapa Uma movimentação para uma etapa configurada para enviar e-mail ao candidato normalmente aguarda a aprovação de uma pessoa em um link (a configuração de e-mail da etapa é lida uma vez, pouco antes da movimentação, então uma configuração ativada naquele momento ainda pode permitir que uma movimentação envie e-mail sem aprovação). Qualquer outra movimentação: o assistente é instruído a pré-visualizar e aguardar seu "sim", e geralmente pode ser desfeita por 24 horas, quando voltou com uma referência de reversão. No máximo 50 inscrições por solicitação.
Rejeitar uma inscrição Solicita aprovação em um link. Se uma pessoa aprovar, o Flowmingo tenta mover a inscrição para a etapa Rejeitado do projeto; verifique o resultado depois. No máximo 50 inscrições por solicitação.
Remover candidatos de um projeto (remove_application) Precisa de Manage pipeline. Solicita aprovação em um link. Se uma pessoa aprovar, o Flowmingo exclui as inscrições do projeto; o perfil do candidato permanece no seu banco de talentos e em outros projetos. Não é uma rejeição, e não há como desfazer. No máximo 50 inscrições por solicitação.
Adicionar uma nota a um resultado O assistente é instruído a pré-visualizar a nota proposta e aguardar seu "sim" antes de salvar. Uma nota pertence a um resultado de avaliação (de qualquer tipo), não ao candidato como um todo.
Classificar um resultado O assistente é instruído a pré-visualizar a classificação e aguardar seu "sim". A classificação se aplica a um resultado de avaliação.
Adicionar à lista de seleção O assistente é instruído a pré-visualizar a mudança na lista de seleção e aguardar seu "sim". Aplica-se a um resultado de avaliação.
Marcar / adicionar à coleção de talentos O assistente é instruído a pré-visualizar a mudança de tag ou coleção de talentos e aguardar seu "sim".
Verificar, retirar ou desfazer uma mudança Verifique onde uma mudança preparada está (aguardando, executada, falhou, expirada ou substituída por uma solicitação mais recente), retire uma que ainda aguarda aprovação ou desfaça uma mudança reversível dentro de 24 horas, quando voltou com uma referência de reversão.

Criar e publicar (age imediatamente, exceto excluir projeto)

Essas ferramentas criam coisas e as abrem ao público. Elas se comportam de maneira diferente das escritas protegidas acima:

  • Elas agem imediatamente, exceto delete_project. Nada é preparado para uma pessoa aprovar em um link, e nenhuma delas envia e-mail a um candidato. delete_project aguarda um Proprietário ou um Administrador aprovar em um link.
  • O criador da chave deve ser um Proprietário ou um Administrador, para todas as ferramentas aqui, exceto o cancelamento, que precisa apenas de Invite candidates. As ferramentas agem com as permissões da pessoa que criou a chave de API. Se essa pessoa for um Membro, a chamada é recusada.
  • Duas permissões são opcionais. Create hiring projects e Create assessments não são concedidas por padrão. Com o login (opção A), o assistente só as recebe se ambas as condições forem verdadeiras: o cliente as listar por nome ao se conectar, e a chave de API que você cola na página de consentimento as possuir. Um cliente que não envia uma lista de permissões recebe as quatro permissões padrão (Read hiring data, Read candidates, Manage pipeline, Invite candidates) que a chave possui, e nenhuma dessas duas, então o assistente não vê as ferramentas que precisam delas. Com uma chave estática (opção B), o assistente vê essas ferramentas independentemente das permissões que a chave possua, e o Flowmingo recusa qualquer chamada que a chave não permitir.
  • Algumas chamadas demoram. A publicação aguarda a verificação de conteúdo de IA, até cerca de 90 segundos. Criar um projeto ou uma avaliação usa geração de IA e pode demorar mais (um Teste Técnico leva de 3 a 9 minutos). Quando a resposta diz que o trabalho ainda está pendente, o assistente chama novamente com a mesma chave de idempotência para ler onde chegou. Uma nova tentativa nunca cria um segundo projeto ou avaliação.
Capacidade O que faz
Criar um projeto de contratação (create_project) Precisa de Create hiring projects (opcional). Cria um projeto com suas quatro etapas padrão e uma vaga escrita pela mesma IA do painel, a partir de um título, a posição e uma descrição opcional. Por padrão, também cria uma Avaliação de CV e uma Entrevista de IA; o assistente pode nomear outras avaliações, ou nenhuma. A vaga é ativada e vai ao público assim que a verificação de conteúdo de IA a aprova, normalmente dentro de um minuto. Limitado a 10 projetos por minuto e 300 por dia para sua empresa. A chave de idempotência é opcional: quando omitida, uma é criada a partir dos argumentos, então uma nova tentativa nunca cria um segundo projeto.
Criar uma avaliação (create_assessment) Precisa de Create assessments (opcional). Cria uma avaliação com a IA: uma Entrevista de IA, uma Avaliação de CV, um Teste de Habilidade, um Showcase, um Teste Técnico ou um Role-play, a partir de um título de vaga e uma descrição de vaga opcional, nome, projeto e idioma (uma tag como en ou vi-VN; um Teste de Habilidade e um Teste Técnico ignoram o idioma). Anexe-a a um projeto para que candidatos possam ser convidados para um Teste de Habilidade, um Teste Técnico ou um Showcase. A chave de idempotência é opcional, como acima.
Publicar uma vaga (publish_job_post) Precisa de Create hiring projects. Ativa a vaga e garante que a verificação de conteúdo de IA foi executada. A resposta informa se a página está ativa agora, ainda aguardando a verificação, ou recusada por ela. O projeto de contratação deve estar ativo.
Despublicar uma vaga (unpublish_job_post) Precisa de Create hiring projects. Desativa a vaga, para que seu link público pare de funcionar. Por padrão, o impulso também é desativado (withdraw_boost é verdadeiro).
Impulsionar uma vaga (boost_job_post) Precisa de Create hiring projects. Define o impulso como off, flowmingo ou extended. Impulsionar é gratuito. Aumentar precisa da vaga ativada, do projeto ativo, um logotipo e descrição da empresa e a verificação de conteúdo de IA; uma empresa pode aumentar 50 impulsos por dia.
Abrir, rascunho ou arquivar um projeto (set_project_state) Precisa de Create hiring projects. Move um projeto de contratação entre active, draft e archived. Rascunho e arquivado fecham o link da vaga. Os dados do candidato são mantidos.
Cancelar um convite agendado (cancel_scheduled_invite) Precisa de Invite candidates. Cancela um convite que foi agendado para depois e ainda não foi enviado, usando o ID do convite do resultado do convite. Ninguém é notificado por e-mail. A pessoa permanece na sua conta e no quadro do projeto.
Excluir um projeto de contratação (delete_project) Precisa de Create hiring projects (opcional). Ele só pede: não exclui imediatamente, solicita aprovação em um link, e nada é excluído até que um Proprietário ou um Administrador aprove. Apenas um projeto ativo pode ser excluído. Se uma pessoa aprovar, o Flowmingo exclui o projeto e suas vagas; as inscrições de candidatos não são excluídas uma a uma, e perfis e contatos de candidatos, suas avaliações e links de convite são mantidos. Não há como desfazer.

Segurança e confiança

  • Seus dados são limitados à organização — o assistente nunca pode ver dados de outra empresa.
  • Com OAuth, o assistente nunca recebe sua chave de API. Ele recebe um token de acesso que expira após uma hora, atualizado silenciosamente enquanto permanece conectado. O login em si dura enquanto seu token de atualização, cerca de 30 dias por padrão a partir da emissão ou última atualização, então expira após cerca de 30 dias sem uso, e você entra novamente. Com um cabeçalho estático (opção B), o cliente do seu assistente mantém sua chave e a envia em cada solicitação, então mantenha-a fora de arquivos que você possa compartilhar ou enviar para o git.
  • Cortando um assistente: exclua a chave de API com a qual você o autorizou, em Configurações → Integrações → Chaves de API. O acesso para imediatamente. Ainda não há desconexão por assistente, então se você quiser revogá-los um a um, dê a cada assistente sua própria chave.
  • Solicitações ao endpoint /mcp são verificadas quanto à Origin: uma origem null opaca é sempre recusada, e a verificação pode ser bloqueada em uma lista de permissões, mas por padrão toda origem real é aceita, então a proteção é sua credencial, não a origem. Cada sessão está vinculada à credencial que a abriu.

Para saber como autenticar, veja Autenticação — duas opções; para as leituras exatas, escritas protegidas e ações que acontecem imediatamente, veja O que você pode fazer. Quando estiver pronto, vá para Conecte seu assistente e escolha seu cliente.

URL do servidor MCP

URL do servidor MCPhttps://mcp.flowmingo.ai/mcp

Conecte o seu assistente

Qual assistente está a usar?

Claude Code (CLI)

Um comando adiciona Flowmingo sobre o Streamable HTTP nativo. Comece com OAuth; o --header estático é a alternativa.

Passos: 1) adicione o servidor, 2) faça login (navegador → cole a chave), 3) claude mcp list para verificar.

# OAuth (recommended) — flags BEFORE the name:
claude mcp add --transport http flowmingo https://mcp.flowmingo.ai/mcp
claude mcp login flowmingo          # browser opens; paste your fl_ key on the consent page

# Static API key instead (pick ONE header):
claude mcp add --transport http flowmingo https://mcp.flowmingo.ai/mcp \
  --header "x-api-key: fl_YOUR_KEY"
# or: --header "Authorization: Bearer fl_YOUR_KEY"

# Share with a repo team (writes a git-committable .mcp.json):
claude mcp add --transport http --scope project flowmingo https://mcp.flowmingo.ai/mcp

claude mcp list && claude mcp get flowmingo

Atenção: as flags devem vir antes do nome, e use sempre --transport http (nunca sse). Substitua fl_YOUR_KEY pela sua chave completa (veja Como é uma chave completa na seção Autenticação acima).

Verifique se funciona — pergunte: "liste minhas vagas abertas."