Calaf

Calaf MCP Server

Claude、ChatGPT、または MCP 対応のアシスタントを Calaf に接続できます。Calaf は MBA 採用活動を管理するサービスです。アシスタントは、指定された深さに応じてターゲット企業を調査し、構造化された「シード」を作成して検証し、リクルーティングブックに登録します。提案される人物は、必ず確認待ちの状態で追加されます。知らないうちにネットワークに登録されることはありません。

2 つのサーバーで 1 つの製品を提供します。 ai.calaf/calaf はアカウントに接続します（OAuth）。ai.calaf/seeds は認証不要の作成ワークフローです。フォーマットとバリデーターは、Calaf アカウントがなくても誰でも利用できます。

サーバー	エンドポイント	トランスポート	認証
Calaf	https://calaf.ai/api/mcp-account	Streamable HTTP	OAuth 2.1（動的クライアント登録）
Calaf Seed Tools	https://calaf.ai/api/mcp	Streamable HTTP	なし

接続後に試せること

• 「MBA 採用を行っているローワーミドルマーケットの PE ファンドを 30 社調査し、シードを検証して、私のブックにインポートして。」
• 「Calaf のシードフォーマットを読んでから、この会話にあるターゲットリストをシードにして、問題がなくなるまで検証して。」
• 「Calaf のワークスペースを一覧表示して、この面接対策の質問をコンサルティング用のワークスペースにインポートして。」
• 「Evercore のスーパーデーを終えたところです。記録して、応募状況を更新し、金曜日にフォローアップするタスクを設定して。」
• 「ローワーミドルマーケットの PE 用にワークスペースを作成し、ターゲットを 10 社追加して、アプローチのテンプレートを作成して。」
• 「優先度の高い 5 つのファンドのパートナーを調査して、私のブックに追加して」 — Calaf では確認待ちの一括登録として追加され、気づかないうちに登録されることはありません。

インストール

claude.ai（ウェブ／デスクトップ）

1. Settings → Connectors (claude.ai/settings/connectors) を開きます
2. Add custom connector を選び、名前に Calaf、URL に https://calaf.ai/api/mcp-account を入力します。Client ID/Secret は空欄のままにします
3. Connect をクリックすると Calaf の同意画面が表示されるので、サインインして承認します

有料の claude.ai プランが必要です（カスタムコネクタは Pro 以上で利用できます）。

Claude Code

claude mcp add --transport http calaf https://calaf.ai/api/mcp-account

その他の MCP クライアント

https://calaf.ai/api/mcp-account にリモート（Streamable HTTP）サーバーを追加します。OAuth フローは標準的なもので、動的クライアント登録と PKCE を使用します。クライアントは RFC 9728 の保護リソースメタデータを介して認可サーバーを検出します。

MCP クライアントをお持ちでない場合

コピー＆ペーストのワークフローは、あらゆるアシスタントで利用できます。Calaf の Guide と Settings には、あらゆる AI に シードフォーマット を教える、1 回貼り付けるだけのプロンプトが用意されています。アシスタントは公開バリデーター API（下記）を使って自己チェックでき、ファイルは Settings → Workspace → Seeds からインポートできます。

ツール — ai.calaf/calaf（アカウントサーバー）

get_seed_format · 読み取り専用

calaf_seed: 1 仕様（Markdown）の全体を返します。セクション、上限、パーサーの動作、シード作成時にアシスタントが従うべきルールが含まれます。作成を始める前に読み、その後 validate_seed で下書きを確認してください。

パラメーターはありません。

validate_seed · 読み取り専用

ドラフトのシードドキュメントを、Calaf アプリがインポートに使用するものとまったく同じパーサーで検証し、判定結果としてセクションごとの件数と正確な問題一覧を返します。問題の重大度が error の場合は何もインポートされません。dropped の場合はその行またはフィールドが破棄され、残りは取り込まれます。ファイルを渡す前に、問題がなくなるまで修正と再検証を行ってください。

Parameter	Type	Required	Description
seed	string | object	yes	完全なシード JSON ドキュメント。テキスト、または JSON オブジェクトそのもの

Returns（構造化データ）：valid、セクションごとの counts（orgs、contacts、templates、prep、keyDates、orgKinds、ladderRungs）、hasVocab、hasPlanner、および path（例：orgs[3].name）、message、severity を含む issues[]。

list_workspaces · 読み取り専用

呼び出し元の Calaf ワークスペースのキー、表示名、表示順を一覧表示します。import_seed の workspace 引数にはキーを指定してください。

パラメーターはありません。 Returns：key、name、emoji を含む workspaces[]。

import_seed · 書き込み（非破壊、冪等）

有効なシードを呼び出し元のワークスペースのいずれかにインポートします。アプリによるインポートと同じ形で取り込まれます。

• Organizations — アカウント全体で名前に基づいて重複を排除し、その後ワークスペースに関連付けます
• Templates — ワークスペース内で重複を排除します
• Prep questions — アカウント全体で重複を排除します
• People — 直接書き込まれることはありません。 ファイル内の連絡先は、Calaf で確認可能なバッチとしてステージングされます。ユーザーはまとめて承認、絞り込み、破棄でき、承認したバッチはワンクリックで取り消せます。ステージングするには、人物に所属組織の指定が必要です。

同じファイルを再インポートしても、データが二重に取り込まれることはありません。削除や上書きは一切行われません。

Parameter	Type	Required	Description
workspace	string	yes	list_workspaces から取得したワークスペースキー
seed	string | object	yes	完全なシード JSON ドキュメント
parts	string[]	no	処理する部分：orgs、templates、prep、contacts（＝人物をステージング）。デフォルトではファイルに含まれるすべての部分が対象です

Returns（構造化データ）：ok、部分ごとの件数を示す landed、failed[]、および people、orgs、buildId、skippedWithoutOrg、skippedInvalid を含む staged。

export_seed · 読み取り専用

ワークスペースを calaf_seed ドキュメントにシリアライズします。逆方向の一連の処理として、データを読み取り、改善してから再インポートできます（重複排除により、往復してもデータが二重になることはありません）。プライバシーのデフォルト設定：人物、ユーザーの個人的なメモ、ほかのシードから取り込まれたコンテンツは、明示的に指定（include_people、include_notes、include_seeded）しない限り含まれません。除外件数と上限による切り詰め件数は常に報告されます。プランによる制限はありません。データの移植性が課金の壁に阻まれることはありません。

get_profile_schema / get_firm_profile / submit_firm_profile

企業について、社内調査レベルの深さで調べます。get_profile_schema はモジュールの構成（概要、本社、リーダーシップ、報酬、プロセス、企業文化・採用に関するメモ）と、提出時に満たすべき情報源の要件（MBA レベルの報酬情報源を使用する、推測より null を優先する、リーダーシップ情報は情報源で確認する）を返します。get_firm_profile はフィールドごとの出典情報とともに現在の状態を読み取り、チャットでの編集が実際の情報と照合して統合されるようにします。submit_firm_profile は、情報源を付したモジュールをユーザー自身のオーバーレイに書き込みます。書き込まれた情報は、その企業ページにアシスタントによる調査としてバッジ付きで表示されます。統合時のルールは、空のフィールドは補完し、アシスタントが書き込んだフィールドは更新し、ユーザーが入力したフィールドは上書きしない（競合として報告）です。また、clear はアシスタントが所有するフィールドのみを削除します。情報源は必須です。情報源のない主張はまとめて破棄されます。

log_touchpoint · 書き込み

アプリ独自の自動処理を伴って、やり取り（コーヒーチャット、メール、イベント、返信など）を記録します。自動処理には、連絡先のステータス段階の更新（後退はしません）、任意のフォローアップの予定設定（ユーザーのカレンダーに登録）、任意のお礼タスクの翌日設定、実際のアクティビティがあった企業の「調査中」から「ネットワーキング」への移行が含まれます。

update_contact · 書き込み

すでにアドレス帳に登録されている人の情報を補完します。本人確認に使う項目（メールアドレス／電話番号／LinkedIn／学校／役職／グループ）は、空欄の場合のみ入力します。ユーザーの値が優先され、差異は報告されます。関係性の項目（親密度 1〜5、ステージ、次回のフォローアップ、つながりの種類）は明示的に設定します。「Jane を休眠扱いにする」という依頼自体が設定内容だからです。企業との紐付けは、まだ紐付けがない場合にのみ追加されます。append_note は、ユーザー自身のメモの上書きではなく、その下に日付と記入者を添えたメモを追加します。人物の作成は、段階的なレビューを行う import_seed 経由に限定されます。

add_task · 書き込み

期限付きのタスクを作成します。連絡先や企業に紐付けることもできます。タスク、フォローアップ、期限がユーザーのカレンダーに表示されるため、これがカレンダーにつながるアシスタントの手段です。

get_contacts / get_firms · 読み取り専用

ページ分割された概要を取得します（連絡先には、まだ空欄の詳細項目も表示されます。調査する価値があります）。アシスタントは自身の記憶ではなく、実際のアドレス帳を参照できます。

log_firm_work / get_firm_work / remove_firm_work · 業務記録

コーヒーチャットで話す内容となる、取引や業務項目を扱います。log_firm_work は企業の業務記録に項目を追加し、情報源や確度（Confirmed / Reported / Rumored）などの出典情報も記録します。get_firm_work は記録を読み込み、アシスタントが記録した行を示します。remove_firm_work が削除できるのは、アシスタント自身が記録した項目のみです。ユーザーが手動で記録した項目の削除は拒否されます。これは、段階的な人物登録と同じ種類の保証です。

get_applications · 読み取り専用

採用選考のパイプラインを取得します。各応募について、企業、プログラム、ステータス、期限、次回の面接日を確認できます。

schedule_interview · 書き込み

応募のタイムラインに面接ラウンドを追加し、ユーザーのカレンダーにも登録します。今後の予定（scheduled）にも、過去の面接（completed: true と結果を指定）にも対応します。保存のたびにアプリ独自の同期も実行され、応募の次回面接日が再計算されます。また、ワークスペースで実際に使われているステージの順序に沿ってステータスが進みます（ステータスが後戻りしたり、終了した結果が再開されたりすることはありません）。

add_application / update_application · パイプライン

add_application はパイプラインに行を追加します（企業＋プログラム。デフォルトは Watching。重複は拒否されます）。update_application は、アプリのボードと同じ方法でステータスを変更します。ステータスの変更はステージ履歴に追記され、応募日も補完されます。また、結果（offer_accepted / offer_declined / rejected / withdrawn）を記録します。提示された報酬額は、ユーザーがまだ入力していない場合にのみ補完されます。差異は報告されますが、反映はされません。

get_tasks / complete_task / snooze_task · ToDo の一連の流れ

範囲（open / overdue / today / this week / done）を指定してタスクを一覧表示し、タスクを完了済みにする（削除はしません）か、期限を延長します。add_task と合わせることで、カレンダーの ToDo の一連の流れをチャットから管理できます。

add_firm / update_firm / add_office · アドレス帳

add_firm はアプリ独自の 2 層書き込み（企業のグローバル登録＋ワークスペースへの追加）を実行します。インポート時と同様に重複を防ぎます。既存の企業は新規登録せずに追加し、アシスタントが追加した企業には出所を示すマークが付きます。update_firm は指定された項目（ステータス、志望先、優先度）を設定し、文章形式の情報（理由／インテリジェンスのメモ、ティア、所在地）は空欄の場合にのみ補完します。ユーザーの記述は常に優先され、差異は報告されます。add_office は項目を追加します。同じラベルの重複は拒否されます。

add_note / get_notes / update_note · ノート

ユーザーのノートブックにあるアシスタントのメモ帳です。メモの作成（企業や人物との任意の紐付け）、所有者のマーク付きの一覧表示、アシスタント自身が書いたメモのみの編集に対応します。ユーザーのメモの編集は拒否されます。これは他と同じ保証です。

create_workspace / rename_workspace / archive_workspace · コンテナ

アプリ独自の方法で新しいワークスペースを作成し（プランごとの上限が適用されます）、名前を変更するか、アーカイブ／復元します。アーカイブは元に戻せる設計になっているため、ここで何かが削除されることはありません。

add_template / get_templates / update_template · アウトリーチテンプレート

ワークスペースごとに再利用できるメールテンプレートです。アシスタントのテンプレートには印が付いていて編集できますが、ユーザー自身のテンプレートと初期設定のテンプレートは編集できません。

add_prep_question / get_prep / draft_prep_answer · 面接対策

対策用の質問バンクに質問を追加し（重複は除外され、任意で企業と紐付け可能）、未回答の質問を一覧表示して、空の欄にのみ回答案を作成します。回答案には「下書き」の印が付くため、ユーザーが手直しできます。ユーザーがすでに回答した質問は、きっぱりと拒否されます。面接でのユーザー自身の語りは、ユーザー自身のものだからです。

ツール — ai.calaf/seeds（公開サーバー）

get_seed_format と validate_seed は上記と同じです。アカウントも認証も不要です。フォーマットは MCP リソース（https://calaf.ai/seed-format.md、text/markdown）としても提供されます。

人物情報の取り扱い方針

架空の企業は午後のひとときを無駄にしますが、架空の人物は存在しない相手へのメールにつながります。そのため、この API 経由で提案された人物情報が、連絡先リストに直接追加されることは決してありません。Calaf のレビュー画面に名前付きのバッチとして届き、ユーザーはリスト全体を確認して、1 回の操作でまとめて承認または破棄できます。承認後もバッチを取り消せます。承認された各行には、どのアシスタントが、いつ、どのシードから登録したかという来歴が記録されます。

信頼とデータ

• OAuth のみ。パスワードは使いません。 接続には動的クライアント登録を用いた OAuth 2.1 を使用します。アシスタントが認証情報を見ることはありません。Calaf → 設定 → 接続済みアシスタント、または AI 側の設定から、アシスタントとの接続をいつでも解除できます。
• ユーザー自身の連絡先リストのみ。 すべての読み取りと書き込みは、接続したユーザー自身のアカウント権限（データベースの行レベルセキュリティ）のもとで実行されます。接続されたアシスタントがアクセスできるのは、そのユーザーのデータだけです。
• 追加のみを前提に設計。 インポート時には重複が除外され、削除も上書きも行われません。
• ヘルスチェック： アカウントサーバーは匿名リクエストに対し、MCP 認可仕様で求められる HTTP 401 と OAuth チャレンジを返します。認証チャレンジを正しく認識しないディレクトリのヘルスチェッカーでは、「unhealthy」と表示される場合があります。実際の MCP クライアントでは正しくネゴシエーションされます。

プレーン HTTP バリデーター（MCP 不要）

curl -X POST https://calaf.ai/api/seed-validate \
  -H 'content-type: application/json' \
  -d @your-seed.json

同じパーサーと同じ形式の判定結果を使用するため、CI のステップ、スクリプト、HTTP リクエストしか送れないアシスタントで利用できます。

リンク

• セットアップガイド：calaf.ai/connect.md
• シード形式：calaf.ai/seed-format.md
• 製品：calaf.ai · サポート：[email protected]
• レジストリの登録項目：ai.calaf/calaf、ai.calaf/seeds — このリポジトリは両方のドキュメントを掲載しています。サーバー自体はリモートです（ここからインストールするコードはありません）。