連携

AIアシスタントを接続 (MCP)

MCP互換のAIアシスタント — Claude、Claude Code、ChatGPT、Cursor、VS Codeなど — をFlowmingoの採用データに接続し、平易な言葉でパイプラインを操作してください。

Our team is online
統合のサポートが必要ですか?

設定の途中でお困りですか?技術的なサポートが必要ですか?私たちのチームが喜んでお手伝いします — いつでもお気軽にご連絡ください。担当者におつなぎします。

概要

MCP対応のAIアシスタントをFlowmingoの採用データに接続しましょう。あなたの許可のもとで、求人や候補者を読み取り、ガード付き操作(招待、移動、却下、プロジェクトからの削除)を安全に実行できます。追加の2つの権限を自分でオンにすると、アシスタントは採用プロジェクトや評価の作成、求人投稿の公開・クローズ・ブーストも行えます(できることを参照)。MCPが初めてですか?MCPは、AIアシスタントがFlowmingoのようなツールと通信するためのオープン標準です。MCPとはをご覧ください。

トランスポート: Streamable HTTP(最新のリモートトランスポート)。レガシーSSEはありません。クライアントは常に/mcpを指定し、/sseは使用しないでください。

APIキーはパスワードと同じように扱ってください。 生のfl_...キーをgitにコミットする可能性のあるファイル(例:.vscode/mcp.json、~/.cursor/mcp.json、Continueの設定)に貼り付ける代わりに、OAuth、プロンプト入力、環境変数を優先してください。

認証 — 2つのオプション

A — Flowmingoにサインイン(OAuth、推奨)。 ブラウザでFlowmingoの同意ページが開き、そこにAPIキーを貼り付けます。アシスタントが生のキーを受け取ることはありません。代わりにアクセストークンとリフレッシュトークンを受け取り、それを使って新しいアクセストークンを取得できます。サインインは永久には続きません。リフレッシュトークンの有効期限はデフォルトで約30日(発行時または最後の更新時から数えて)なので、約30日間使用されないサインインは失効し、Flowmingoのリリースでサインインの保存方法が変更された場合も再サインインが必要になることがあります。その場合、アシスタントが再度サインインを求め、キーを再度貼り付けます。より早く失効させたい場合は、そのAPIキーを削除してください。クライアントIDやシークレットの作成は不要です(FlowmingoはDynamic Client Registrationを使用)。「詳細」OAuth設定を表示するクライアント(例:Claude.ai)では、Client IDとSecretは空白のままにしてください。

B — 静的APIキー(ヘッダー)。 キーを以下のいずれかのヘッダーとして送信します:

x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY

キーはFlowmingo → 設定 → 連携 → APIキーで取得できます。Read hiring data と Read candidates の両方にチェックを入れてください。前者は求人、パイプライン、結果をカバーし、後者はアシスタントが候補者を検索できるようにします。ガード付き書き込み操作には Manage pipeline / Invite candidates を追加してください。アシスタントにプロジェクトや評価の作成、求人投稿の公開・ブーストを許可するには、Create hiring projects と Create assessments にもチェックを入れてください。まず「できること」の「作成と公開」をお読みください。これらの2つの権限はオプトインであり、キーの作成者はオーナーまたは管理者である必要があります。

完全なキーの構成。 1つの長い値:fl_live_、キーの公開名、ドット、長いシークレット。シークレット部分はキー作成直後に一度だけ表示されます。その後、APIキーリストにはその先頭部分のみが表示されます。ドットのない値はキーの名前のみであり、拒否されます。このガイドでfl_YOUR_KEYと書かれている箇所は、すべて完全なキーに置き換えてください。引用符やスペースは含めないでください。

接続できない場合。 不正または空のキーは、Missing credential または The Flowmingo API key was rejected として返されます。どちらも値が完全に届かなかった可能性があるため、まず値を確認してください。${env:FLOWMINGO_API_KEY}のような設定は、プログラムがその変数を参照できる場合にのみ機能します。Dockやスタートメニューから開いたエディタは、ターミナルのプロファイルを読み取らないことがよくあります。変数が設定されたターミナルから起動するか、完全なキーをファイルに記述して(そのファイルをgitにコミットしないでください)ください。

どちらを選ぶ? ほとんどのクライアントは両方をサポートしていますが、一部(例:ChatGPT)はOAuth専用です。各タブにそのクライアントがサポートする内容が記載されています。一般的に、OAuthは対話型アシスタント(Claude.ai、ChatGPT、VS Code)に適しており、APIキーヘッダーはCLI、ヘッドレス/CI、キーを直接設定したいエディタに適しています。

できること

読み取りは承認を必要としません。ほとんどの書き込みはガードされています。招待、Rejectアクションによる却下、プロジェクトからの候補者の削除、プロジェクトの削除、または通常、候補者にメールを送信するステージへの移動は、Flowmingoにサインインした人がリンクで承認するのを待ちます。アシスタントは承認できず、チャットで「はい」と入力しても承認とはみなされません。ステージのメール設定は、移動が要求されたときにチェックされます。メモ、評価、ショートリスト、タグ、候補者にメールを送信しないステージへの移動については、アシスタントはまずプレビューを表示し、あなたが同意した場合にのみ実行するように指示されます。これはアシスタントへの指示であり、ロックではありません。AIクライアントがツールを実行する前に表示するプロンプトはクライアント自身のものであり、Flowmingoの承認ではありません。招待、Rejectアクションによる却下、メール送信ステージへの移動は、クライアントが何を尋ねても、承認リンクを待ちます。承認リンクは15分で失効し、複数の候補者または応募(最大50件)に対する1つのリクエストは、全員をリストする1つの承認となります。変更がステージングされると、アシスタントはその状態を確認したり、待機中に取り下げたり、可逆的な変更(メモ、評価、ショートリストマーク、タグ、誰にもメールを送信しなかった移動)を24時間以内に元に戻したりできます。元に戻せない場合もあります。変更に元に戻す参照が付いている必要があり、記録はベストエフォートであり、以前のステージがない候補者の移動には参照がないため、アシスタントは確認して、戻る方法がない場合はその旨を伝える必要があります。送信済みのメールは元に戻せません。作成と公開にリストされているツールは、delete_projectを除いて、これらすべての例外です。即座に実行され、承認のためにステージングされません。削除とプロジェクトの削除は元に戻せません。すべては組織にスコープされます。

読み取り

機能 説明
求人投稿の一覧 組織の公開中およびクローズ中の役割を閲覧します。
面接セットとプロジェクトの一覧 あらゆる種類の評価(面接セット)(AI面接、ロールプレイ、スキルテスト、テクニカルテスト、CV評価、ショーケース、録画、リクエスト時にはアンケート)と採用プロジェクトを表示します。
候補者パイプラインの一覧 プロジェクト全体のステージ別の応募を表示します。
評価結果とスコアの読み取り あらゆる種類の結果を取得します:AI面接、ロールプレイ、スキルテスト、テクニカルテスト、CV評価、ショーケース、録画、アンケート。各結果には種類がラベル付けされています。AIスコアを持つのは一部の種類のみです。ショーケースとアンケートはスコアリングされず、スキルテストはパーセンテージです。
候補者の検索 1人の候補者の名前、メールアドレス、CVを取得します。
候補者の検索 名前またはメールアドレスで候補者を検索します。
候補者の比較 2〜10人の候補者を並べて比較します。Read candidates 権限に加えて Read hiring data が必要です。
採用概要 接続が到達できるすべてのファネル(会社全体。キーが一部のプロジェクトに制限された人によって作成された場合を除く)、または要求に応じて絞り込み:ステージ別の応募数、アクティブ対却下、結果のある各評価種類について、完了済み対進行中の結果と平均スコア。プロジェクトはすべてのカウントを絞り込みますが、その結果カウントはそのプロジェクトにリンクされた評価の結果をカバーするため、それらの評価を共有する別のプロジェクトの候補者もカウントされる可能性があります。評価は結果カウントのみを絞り込みます。ステージと応募カウントは接続が到達できるすべてのままです。種類は決して合算されません。
トップ候補者 総合スコアで並べられた最高ランクの結果。別途指定がない限り、すべての種類の評価が一緒にランク付けされます。
評価結果の詳細 1つの結果のコンピテンシー別スコアとAIサマリー(それらを持つ種類の場合)。スキルテスト、テクニカルテスト、ショーケース、アンケートはほとんどまたはまったくありません。
求人投稿の詳細 単一の求人投稿の完全な詳細。
求人投稿は公開されていますか?(get_job_post_publication) 誰でも求人投稿の公開ページを開けるかどうか:公開中、AIコンテンツチェック待ち、拒否済み、フラグ付き、オフ、またはプロジェクトが公開されていない。また、公開URLとブースト(オフ、flowmingo、拡張)も表示されます。Read hiring data が必要です。
今後の面接 送信済みまたはスケジュール済みでまだ完了していないあらゆる種類の評価への招待。これはまだ全員が未完了というわけではありません。候補者にリマインダーが送信された、リンクを開いた、またはクリックした招待は、候補者が開始するまで除外され、配信に失敗したものも除外されます。

書き込み(ガード付き)

機能 説明
候補者を評価に招待 AI面接、ロールプレイ、スキルテスト、テクニカルテストの招待を準備し、人がリンクで承認するのを待ちます。それまでは何も送信されません。リクエストごとに1つの評価と最大50人の候補者。スキルテストまたはテクニカルテストには、各候補者のプロジェクトとメールアドレスが必要で、スポンサー付きの場合は候補者が開始すると組織のウォレットから引き落とされる可能性があります。
候補者を別のステージに移動 候補者にメールを送信するステージへの移動は、通常、人がリンクで承認するのを待ちます(ステージのメール設定は移動の直前に一度だけ読み取られるため、その時点でオンにされた設定は承認なしでメールを送信できる場合があります)。その他の移動:アシスタントはプレビューしてあなたの「はい」を待つように指示され、通常は24時間以内に元に戻せます(元に戻す参照が付いている場合)。リクエストごとに最大50の応募。
応募を却下 リンクでの承認をリクエストします。人が承認すると、Flowmingoは応募をプロジェクトの「却下」ステージに移動しようとします。後で結果を確認してください。リクエストごとに最大50の応募。
プロジェクトから候補者を削除(remove_application) Manage pipeline が必要です。リンクでの承認をリクエストします。人が承認すると、Flowmingoはプロジェクトから応募を削除します。候補者のプロフィールはタレントプールと他のプロジェクトに残ります。これは却下ではなく、元に戻せません。リクエストごとに最大50の応募。
結果にメモを追加 アシスタントは、保存する前に提案されたメモをプレビューしてあなたの「はい」を待つように指示されます。メモは候補者全体ではなく、1つの評価結果(あらゆる種類)に属します。
結果を評価 アシスタントは、評価をプレビューしてあなたの「はい」を待つように指示されます。評価は1つの評価結果に適用されます。
結果をショートリストに追加 アシスタントは、ショートリストの変更をプレビューしてあなたの「はい」を待つように指示されます。1つの評価結果に適用されます。
タグ付け / タレントコレクションに追加 アシスタントは、タグまたはタレントコレクションの変更をプレビューしてあなたの「はい」を待つように指示されます。
変更の確認、取り下げ、元に戻す ステージングされた変更の状態(待機中、実行済み、失敗、期限切れ、新しいリクエストに置き換え)を確認し、承認待ちのものを取り下げ、24時間以内に可逆的な変更(元に戻す参照が付いている場合)を元に戻します。

作成と公開(プロジェクトの削除を除き、即座に実行)

これらのツールはものを作成し、一般に公開します。上記のガード付き書き込みとは動作が異なります:

  • delete_projectを除き、即座に実行されます。 人がリンクで承認するためにステージングされるものはなく、候補者にメールを送信することもありません。delete_projectは、オーナーまたは管理者がリンクで承認するのを待ちます。
  • キーの作成者はオーナーまたは管理者である必要があります、キャンセルを除くここでのすべてのツールについて。キャンセルにはInvite candidatesのみが必要です。ツールはAPIキーを作成した人の権限で動作します。その人がメンバーの場合、呼び出しは拒否されます。
  • 2つの権限はオプトインです。 Create hiring projects と Create assessments はデフォルトでは付与されません。サインイン(オプション A)の場合、アシスタントがこれらの権限を取得するには、次の2つの条件を満たす必要があります。クライアントが接続時にそれらの権限を明示的にリストすること、および同意ページで貼り付けたAPIキーがそれらを保持していることです。権限リストを送信しないクライアントには、キーが保持する4つの標準権限(Read hiring data、Read candidates、Manage pipeline、Invite candidates)のみが付与され、これら2つの権限は付与されないため、アシスタントには、それらを必要とするツールが表示されません。静的キー(オプション B)の場合、キーが保持する権限に関係なくアシスタントにこれらのツールが表示されますが、Flowmingoはキーが許可しない呼び出しを拒否します。
  • 一部の呼び出しには時間がかかります。 公開はAIコンテンツチェックを最大約90秒待ちます。プロジェクトまたは評価の作成はAI生成を使用するため、時間がかかる場合があります(テクニカルテストは3〜9分)。応答が作業がまだ保留中であると示した場合、アシスタントは同じ冪等キーで再度呼び出して進行状況を確認します。リトライしても2番目のプロジェクトや評価が作成されることはありません。
機能 説明
採用プロジェクトの作成(create_project) Create hiring projects(オプトイン)が必要です。タイトル、役職、オプションの説明から、ダッシュボードと同じAIによって書かれた4つのデフォルトステージと求人投稿を備えたプロジェクトを作成します。デフォルトでCV評価とAI面接も作成します。アシスタントは他の評価を指定したり、なしにしたりできます。求人投稿はオンになり、AIコンテンツチェックが承認すると通常1分以内に公開されます。1分間に10プロジェクト、1日300プロジェクトまでに制限されています。冪等キーはオプションです。省略すると引数から生成されるため、リトライしても2番目のプロジェクトが作成されることはありません。
評価の作成(create_assessment) Create assessments(オプトイン)が必要です。AI面接、CV評価、スキルテスト、ショーケース、テクニカルテスト、ロールプレイのいずれかを、職種とオプションの職務記述、名前、プロジェクト、言語(enやvi-VNなどのタグ。スキルテストとテクニカルテストは言語を無視)からAIで1つ作成します。プロジェクトに添付して、候補者をスキルテスト、テクニカルテスト、ショーケースに招待できるようにします。冪等キーは上記のとおりオプションです。
求人投稿の公開(publish_job_post) Create hiring projects が必要です。求人投稿をオンにし、AIコンテンツチェックが実行されたことを確認します。応答は、ページが現在公開されているか、チェック待ちか、拒否されたかを示します。採用プロジェクトがアクティブである必要があります。
求人投稿の非公開(unpublish_job_post) Create hiring projects が必要です。求人投稿をオフにして、公開リンクが開かないようにします。デフォルトではブーストもオフになります(withdraw_boostはtrue)。
求人投稿のブースト(boost_job_post) Create hiring projects が必要です。ブーストをoff、flowmingo、extendedのいずれかに設定します。ブーストは無料です。引き上げるには、求人投稿がオン、プロジェクトがアクティブ、会社のロゴと説明、AIコンテンツチェックが必要です。会社は1日50回まで引き上げられます。
プロジェクトのオープン、ドラフト、アーカイブ(set_project_state) Create hiring projectsが必要です。採用プロジェクトをactive、draft、archivedの間で移動します。下書きとアーカイブは求人リンクを閉じます。候補者データは保持されます。
スケジュールされた招待のキャンセル(cancel_scheduled_invite) Invite candidates が必要です。後日スケジュールされ、まだ送信されていない招待を、招待結果の招待IDを使用してキャンセルします。誰にもメールは送信されません。その人はアカウントとプロジェクトボードに残ります。
採用プロジェクトの削除(delete_project) Create hiring projects(オプトイン)が必要です。これはリクエストするだけです。即座に削除せず、リンクでの承認をリクエストし、オーナーまたは管理者が承認するまで何も削除されません。アクティブなプロジェクトのみ削除できます。人が承認すると、Flowmingoはプロジェクトとその求人投稿を削除します。候補者の応募は1つずつ削除されず、候補者のプロフィールと連絡先、評価、招待リンクは保持されます。元に戻せません。

セキュリティと信頼

  • あなたのデータは組織スコープです。アシスタントが他の会社のデータを閲覧することは絶対にありません。
  • OAuthでは、アシスタントがあなたのAPIキーを受け取ることはありません。1時間で期限切れになるアクセストークンを取得し、接続中は静かに更新されます。サインイン自体は、そのリフレッシュトークンの有効期限(デフォルトでは発行時または最後の更新から約30日)まで続くため、約30日間使用されないと失効し、再度サインインする必要があります。静的ヘッダー(オプションB)では、アシスタントのクライアントがキーを保持し、すべてのリクエストで送信するため、共有またはコミットするファイルにキーを入れないでください。
  • アシスタントの接続を切断する: 認証に使用したAPIキーを設定 → 連携 → APIキーで削除してください。アクセスは即座に停止します。アシスタントごとの切断はまだないため、1つずつ取り消す場合は、各アシスタントに専用のキーを付与してください。
  • /mcpエンドポイントへのリクエストはオリジンがチェックされます。不透明なnullオリジンは常に拒否され、チェックを許可リストにロックできますが、デフォルトではすべての実在オリジンが受け入れられるため、保護は資格情報であり、オリジンではありません。各セッションはそれを開いた資格情報にバインドされます。

認証方法については、認証 — 2つのオプションを参照してください。正確な読み取り、ガード付き書き込み、即座に実行されるアクションについては、できることを参照してください。準備ができたら、アシスタントを接続に進み、クライアントを選択してください。

MCPサーバーURL

MCPサーバーURLhttps://mcp.flowmingo.ai/mcp

アシスタントを接続

どのアシスタントを使用していますか?

Claude Code (CLI)

1つのコマンドで、ネイティブのStreamable HTTPにFlowmingoを追加できます。OAuthを優先し、静的--headerは代替手段です。

手順: 1) サーバーを追加、2) ログイン(ブラウザ→キーを貼り付け)、3) claude mcp listで確認。

# 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

注意: フラグは名前の前に置き、常に--transport httpを使用してください(sseは不可)。fl_YOUR_KEYを完全なキーに置き換えてください(上記の「認証」セクションの「完全なキーの例」を参照)。

動作確認 — 次のように尋ねてみてください: 「公開中の求人をリストアップして。」