お使いの AI から ROSTER を使えるようにする

ふだんお使いの AI（Claude、Claude Code、Codex CLI、ChatGPT など）から、ROSTER の候補者・選考・求人・企業・面談の予定・タスク・今日のブリーフを読めるようにできます。さらに、活動記録の追加・面談予定の登録・タスクの追加・選考の開始・候補者の新規登録と、推薦文・メール・面談準備ブリーフの下書きもその場で頼めます。ROSTER の画面を開かなくても、いつもの AI に「今日やるべき選考は？」「山田さんに電話した、と記録して」と言えるようになります。

接続に必要なのは URL 1 つだけです。API キーの発行や設定ファイルの編集は必要ありません。

まず ROSTER で 設定 > AIと接続 を開き、画面上部の「接続 URL」をコピーしてください。以降の手順で貼り付けます。

接続 URL は https://roster.co.jp/api/mcp です。設定画面を開かずに入力する場合は、この URL をそのまま使えます。

1. Claude の「設定」→「コネクタ」を開きます
2. 「カスタムコネクタを追加」を選びます
3. 名前に「ROSTER」、URL にコピーした接続 URL を貼り付けます
4. 「認証」と「OAuth クライアント」の欄は、Claude が自動で選んだ「検出済み」のままで「追加」を押します（変更は不要です）
5. 一覧の ROSTER で「接続」を押すと ROSTER のログイン画面が開くので、ログインして「許可する」を押します

公式プラグインを使うのが簡単です。Claude Code の中で次の 2 つを順に実行します。

1. /plugin marketplace add Swift-Palette/roster-claude-plugin
2. /plugin install roster@roster

続けて /mcp と入力し、roster を選んで認証します。ブラウザが開くので、ROSTER にログインして「許可する」を押してください。 プラグインには、朝の確認・活動記録・推薦文の下書きの手順も入ります。詳しくは Claude Code に ROSTER プラグインを入れる をご覧ください。

プラグインを使わず、接続だけを追加することもできます。

1. ターミナルで、設定画面に表示されているコマンド（claude mcp add で始まるもの）を実行します。URL を直接指定する場合は claude mcp add --transport http roster https://roster.co.jp/api/mcp です
2. Claude Code の中で /mcp と入力し、roster を選んで認証します
3. ブラウザが開くので、ROSTER にログインして「許可する」を押します

1. ターミナルで、設定画面に表示されている 2 つのコマンド（codex mcp add と codex mcp login）を順に実行します。URL を直接指定する場合の 1 つ目は codex mcp add roster --url https://roster.co.jp/api/mcp です
2. ブラウザが開くので、ROSTER にログインして「許可する」を押します

1. ChatGPT の「設定」→「コネクタ」（開発者モード）を開きます
2. 「新規」を選び、コピーした接続 URL を貼り付けます
3. ROSTER にログインして「許可する」を押します

カスタムコネクタを使えるかどうかは ChatGPT 側のプランと設定によります。項目が見当たらない場合は、ご利用のプランをご確認ください。

接続すると、AI は次の 24 個ができるようになります。

読み取り

• 候補者を検索する — 氏名・現職・スキルなどのキーワードで候補者を探します
• 選考の一覧を見る — 進行中の選考、自社が動く番のもの、企業の返事待ち、停滞しているものを絞り込めます
• 候補者の詳細を見る — プロフィール・進行中の選考・直近の活動を読みます
• 求人の詳細を見る — 条件・進行中の選考数・適合度の高い候補者 上位 3 名を読みます
• 今日のブリーフを読む — その日の面談・期限・放置されている選考のまとめを読みます（まだ作られていない日は、今日の面談・タスク・選考の件数をそのまま返します）
• ヘルプ記事を検索する — ROSTER の使い方を、この公式ヘルプから調べて答えます
• 求人を検索する — 求人名・企業名・要件などのキーワードで求人を探します
• 企業を検索する — 社名・業種などのキーワードで企業を探し、主担当の先方担当者も返します
• 企業の詳細を見る — 企業の情報・先方担当者・募集中の求人を読みます
• メンバーの一覧を見る — 組織のメンバーと権限を読みます（担当者を指定するときに使います）
• 選考ステージの一覧を見る — 組織の選考ステージを並び順どおりに読みます
• 面談の予定一覧を見る — 指定した期間（既定は今日から 1 週間）の面談・面接の予定を読みます
• タスクの一覧を見る — 未完了のタスクを、期日や担当者で絞って読みます
• 選考の集計を見る — 進行中の選考を、ステージ別・誰の番か・停滞で数えます
• 面談の空き枠を提案する — あなたの予定と営業時間から、面談の空き時間を提案します（予定は入れません）

下書き・分析（ご契約プランの AI 回数を 1 回ずつ使います）

• 推薦文の下書きを作る — 企業へ推薦する文章の下書きを作ります
• 候補者に合う求人を探す — 募集中の求人を、点数と理由つきで挙げます
• 面談準備ブリーフを作る — 経歴の要点・これまでの選考・求人要件との照合・確認したい質問をまとめます
• メールの下書きを作る — 日程調整・フォロー・お見送り・企業への推薦送付のメールの下書きを作ります（送信はしません）

書き込み（記録・予定・タスク・選考を「足す」だけ）

• 活動を記録する — 「〇〇さんに電話した」のような終わったことを、候補者・企業・選考の記録に 1 件追加します
• 面談の予定を登録する — 面談・面接の予定を入れます
• 候補者を新規登録する — 候補者を 1 名登録します（同じ方がいないかを登録前に確かめます）
• タスクを追加する — 期日・担当者つきでタスクを 1 件追加します（同じ内容の未完了タスクがあれば追加しません）
• 選考を開始する — 候補者を求人の選考に載せます（すでに選考中なら新しく作りません）

聞き方の例です。

• 「ROSTER で今日やるべき選考を教えて。」
• 「ROSTER で山田さんの選考状況をまとめて。」
• 「ROSTER で山田さんに電話した、と記録して。」
• 「ROSTER で明日 15 時に山田さんの面談を入れて。」
• 「ROSTER で山田さんの推薦文の下書きを作って。」
• 「ROSTER に候補者を登録して。山田太郎さん、090-1234-5678、いま A 社でエンジニア。」
• 「ROSTER で山田さんに合う求人を探して、よさそうなものを選考に載せて。」
• 「ROSTER で明日の面談の準備メモを作って。」
• 「ROSTER で A 社の佐藤さんに電話した、と記録して。」
• 「ROSTER で金曜までに A 社へ書類を送る、とタスクに入れて。」

活動を記録する 「〇〇さんに電話した」「A 社を訪問した」のような、もう終わったことを 1 件記録します。記録先は候補者・企業・選考のいずれかで、ROSTER の画面から手で書いたときと同じ場所・同じ形で残ります。実施日時をさかのぼって指定することもできますが、未来の日時は指定できません（これから先の予定は「面談の予定」で入れてください）。

面談の予定を登録する 日時・所要時間・場所を指定して、面談・面接の予定を 1 件入れます。担当者を指定しなければ、頼んだご本人が担当者になります。カレンダー連携をしている場合は、画面から登録したときと同じようにカレンダーにも入ります。

同じ担当者の予定と時間帯が重なるときは、登録せずに重なっている予定をお知らせします。それでも入れたい場合は、AI に「重なっていても入れて」と伝えてください。空いている時間を先に知りたいときは「空き枠を提案して」と頼めます（あなたの予定と、設定 > 組織 の営業時間・曜日・祝日の設定から探します）。

タスクを追加する 「〇〇までに△△する」のようなやることを 1 件追加します。期日・担当者・何についてのタスクか（候補者・企業・求人・選考・面談・成約）を付けられます。担当者を指定しなければ、頼んだご本人が担当者になります。同じ内容の未完了タスクがすでにあるときは、追加せずにそのタスクをお知らせします。タスクの完了・変更・削除は ROSTER の画面から行ってください。

選考を開始する 候補者を求人の選考に載せ、最初のステージに入れます。対象は募集中・一時停止の求人だけです。同じ候補者が同じ求人の選考にすでに入っているときは、新しく作らずにその選考をお知らせします。ステージを進める・選考を終える操作は ROSTER の画面から行ってください。

推薦文の下書きを作る ROSTER に入っている面談の記録・職務経歴・求人の条件を材料に、企業へ推薦する文章の下書きを作ります。作るのは下書きだけで、送信も PDF 化もしません。内容の確認と編集は ROSTER の画面で行ってください。この操作はご契約プランの AI 回数を 1 回使い、上限に達しているときはその旨をお伝えします。

候補者に合う求人を探す・面談準備ブリーフを作る・メールの下書きを作る いずれも ROSTER の画面（候補者の「求人マッチ」、面談の「準備ブリーフ」、候補者の「メール下書き」）と同じ仕組みで作り、ご契約プランの AI 回数を 1 回ずつ使います。結果は AI 履歴に残りますが、候補者や選考のデータは書き換えません。メールは下書きを作るだけで送信しません。署名は付かないので、送るときに足してください。

候補者を新規登録する 氏名だけあれば登録できます。ふりがな・メールアドレス・電話番号・生年月日・現在の勤務先・役職・スキル・希望条件・流入ソース・メモも、分かる範囲で一緒に渡せます。

同じ方がすでに登録されていないかを、登録の前に必ず確かめます。 メールアドレスが同じ方、電話番号が同じ方、氏名と生年月日が同じ方が見つかった場合は、登録せずにその方をリンク付きでお知らせします（氏名と連絡先がよく似ている方も同じようにお知らせします）。同じ方であれば、そのリンクから開いて更新してください。同姓同名の別人など、確かに別の方だと分かっている場合は、AI に「別人なので登録して」と伝えると登録できます。

判定に使う「同じ」の基準は、ROSTER の画面や CSV 取り込みの重複チェックと同じものです（大文字小文字・全角半角・ハイフンの有無などは同じ値として扱います）。ただし info@… のような共有アドレスや 090-1234-5678 のような見本の番号は、複数の方が同じ値をお持ちのことがあるため、一致の根拠にしません。

AI から登録した候補者には「AI 経由で登録」という記録が 1 件付くので、あとから見分けられます。すでにある候補者の書き換えや削除は AI からはできません。

次の操作は、AI からはできません。ROSTER の画面から行ってください。

• データの削除（候補者・企業・求人・記録・面談のいずれも）
• すでにある候補者・企業・求人の書き換え（氏名や連絡先の修正も画面から行ってください）
• 選考のステージの変更（書類選考 → 一次面接 など）
• 成約の登録・請求・返金などお金に関わる操作
• メールの送信（下書きは作れますが、送るのはご自身のメールから行ってください）
• タスクの完了・変更、選考の終了
• 企業・求人の新規登録

理由は単純で、取り消しに人の手が要る操作・お金が動く操作・社外に出てしまう操作を、AI の解釈だけで実行させないためです。

設定 > AIと接続 の「AI からの書き込みを許可する」をオフにすると、書き込みと下書き・分析（AI 回数を使うもの）はすべて AI 側の一覧から消え、読み取りだけになります。この設定を変更できるのはオーナー・管理者です。

AI から追加した記録・予定・下書き・候補者・選考は、AI 経由で作られたものだと分かる印を付けて保存しています。あわせて、いつ・どの接続元から・何をしたかが 設定 > AIと接続 の「呼び出しの記録」と、設定 > 監査ログの両方に残ります。書き込みの操作には「追加」の印が付くので、読み取りと見分けられます。

• 接続すると、データは接続先の AI サービスへ送られます。 この機能は、お客様が選んだ外部の AI（Claude、Claude Code、Codex CLI、ChatGPT 等）から ROSTER のデータを読み書きできるようにするものです。AI が候補者・求人・選考の情報を読み取ると、その内容は接続先の事業者のサーバーへ送信され、同社の規約に従って取り扱われます。接続先の事業者は当社の委託先ではなく、送信の可否はお客様の選択と責任によります。接続する前に、接続先のサービスの利用規約・プライバシーポリシーをご確認ください。 組織の管理者は、設定 > AIと接続 で書き込みの許可範囲を制御でき、書き込みごと停止することもできます。
• 見える範囲は、ログインしたご本人と同じです。 接続の許可を出した方が ROSTER で閲覧できるデータだけが対象で、それ以外は AI からも読めません。他の組織のデータが混ざることはありません。
• 足すことしかできません。 AI ができる書き込みは「活動記録の追加」「面談予定の登録」「候補者の新規登録」「タスクの追加」「選考の開始」と、下書き・分析（推薦文・メール・面談準備ブリーフ・求人マッチ）だけで、削除・上書き・ステージ変更・タスクの完了・メール送信の機能は用意していません。組織の設定で書き込みごとオフにもできます。
• 同じ方を二重に作りません。 候補者の新規登録では、メールアドレス・電話番号・氏名と生年月日で既存の方を先に探し、見つかったときは登録せずにお知らせします。
• 書き込みの回数にも上限があります。 短時間に大量の記録が作られないよう、1 分あたりの回数を制限しています。
• メールの本文は全文を渡しません。 候補者の活動履歴は、内容の冒頭だけを抜粋して渡します。全文は ROSTER の画面でご確認ください。
• 記録が残ります。 AI が ROSTER のデータを読んだり書いたりするたびに、日時・操作の種類・接続元のアプリが記録され、設定 > AIと接続 の「呼び出しの記録」で確認できます。書き込みは設定 > 監査ログにも残ります。

AI が追加した活動記録・面談の予定・推薦文の下書き・候補者・タスク・選考は、あとから 1 件ずつ取り消せます。

設定 > AIと接続 の「呼び出しの記録」を開き、「追加」の印が付いた行の右端にある「取り消す」を押してください。何が消えるのかを確認する画面が出たあと、その書き込みだけが削除されます。

• 活動記録 … 候補者・企業・選考の記録から、その 1 件が消えます。
• 面談の予定 … ROSTER から消え、カレンダー連携をしている場合はカレンダーの予定も取り消されます（画面から面談を削除したときとまったく同じ動きです）。面談の削除はオーナー・管理者のみ行えます。
• 推薦文の下書き … AI 履歴からその下書きが消えます。
• 候補者 … 画面から候補者を削除したときと同じように消えます（削除はオーナー・管理者のみ）。
• タスク … タスクの一覧からその 1 件が消えます。
• 選考 … 画面から選考を削除したときと同じように消え、その選考に付いた未完了のタスクも閉じます（削除はオーナー・管理者のみ。成約が付いた選考は消せません）。

求人マッチ・面談準備ブリーフ・メールの下書きは、データを書き換えない下書きなので取り消しの対象ではありません。

取り消した行には「取り消し済み」と表示され、以後は取り消せません。取り消しの操作そのものも 設定 > 監査ログに残ります。取り消しは元に戻せませんのでご注意ください。

なお、AI から追加された記録・面談には、画面上でも「AI から追加」の印が付いています。候補者の活動タブ・企業のやり取り・選考のタイムライン・面談の一覧と詳細のいずれでも、その行が AI 由来かどうかが一目で分かります。選考のタイムラインの記録は、これまでどおりその行のメニューからも削除できます。

設定 > AIと接続 の「接続中のアプリ」から、対象のアプリの「取り消す」を押してください。取り消すと、そのアプリからは ROSTER のデータを読むことも書くこともできなくなります。再び使いたくなったときは、同じ手順でもう一度つなぎ直せます。

つなぎ方や動作でお困りのことがあれば、お問い合わせフォーム からご連絡ください。

• Claude Code に ROSTER プラグインを入れる
• 推薦文・求人票・メール下書きを AI で作る
• AI の利用回数はいつ減るのか