Kosa MCP Server

Kosa MCP Server とは？

Kosa MCP Server は、Claude などの MCP クライアントをベンチャーキャピタルの Kosa レコードにつなぎ、エージェントが案件、企業、人物、ファンド、投資先の近況、関係の強さ、会議ブリーフを照会できるようにします。

Kosa は、自ら構築される AI ネイティブなベンチャーキャピタル向けのシステム・オブ・レコードだと説明しています。ファームのメール、カレンダー、会議、ドキュメントに接続し、手入力なしで人物、企業、案件、投資先の近況、関係性を抽出します。Kosa は「エージェントが作り、エージェントのために」と述べており、https://api.getkosa.ai/tools でホストされる Kosa MCP サーバーが、外部のエージェントからこのレコードにアクセスする手段です。すべての呼び出しは認証されたファームの範囲に限定され、公開データセットはありません。

Kosa MCP Server の使い方

Kosa アカウントが必要です。Kosa はアーリーアクセス段階にあり、新しいファームはウェブサイトのウェイトリストからアクセスを申請します。

サーバーはステートレスな Streamable HTTP で動作します。

https://api.getkosa.ai/tools

認証は PKCE と動的クライアント登録を備えた OAuth 2.1 で、クライアントがフローを自動的に検出し、サインインはブラウザで行います。アーリーアクセスのファームには API キーが発行されることもあり、Authorization: Bearer ヘッダーで送信します。

Claude Code

claude mcp add --transport http kosa https://api.getkosa.ai/tools

初回接続時に、Claude Code がブラウザで Kosa の認可フローを開きます。

ファームに API キーが発行されている場合は、ヘッダーで渡すこともできます。

claude mcp add --transport http kosa https://api.getkosa.ai/tools --header "Authorization: Bearer ${KOSA_API_KEY}"

Claude Desktop と claude.ai

Settings > Connectors を開き、Add custom connector を選んで https://api.getkosa.ai/tools を貼り付け、求められたらサインインします。

Cursor

~/.cursor/mcp.json または .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "kosa": {
      "url": "https://api.getkosa.ai/tools"
    }
  }
}

VS Code

.vscode/mcp.json に追加します。

{
  "servers": {
    "kosa": {
      "type": "http",
      "url": "https://api.getkosa.ai/tools"
    }
  }
}

Kosa MCP Server の主な機能

• ファーム単位のレコード：自分の Kosa ワークスペースにある案件、企業、人物、ファンド、投資会社。ファーム間で共有されることはありません。
• パイプラインとポートフォリオの分析：Kosa のドキュメントには、ステージ、ラウンド、セクターチーム別の案件フロー、ファンドの投資実行額、QSBS 適格日、投資先の財務情報を扱うツールが記載されています。
• 関係性のインテリジェンス：lookup-connection-strength や lookup-cross-team-overlap などのツールが、チームとある人物の関係の深さや、すでに誰が接触しているかを示します。
• 会議の準備：get-upcoming-meetings、get-meeting-brief、prep-board-meeting が今後の会議に必要な文脈をまとめます。
• ファーム内コンテンツの検索：ドキュメント、ユーザー自身のメール、会議の文字起こし、セマンティック検索。
• 権限ティア：各認証情報は read_only、read_write、full のいずれかを持ちます。案件の作成や移動などの書き込みには read_write、ファーム管理者向けのルーブリック系ツールには full が必要です。ティアを超える呼び出しは PERMISSION_DENIED を返します。
• ディスカバリー用リソース：kosa://schema/deals や kosa://enums/deal.stage などのスキーマ・列挙リソースで、書き込み前にフィールドやワークスペース固有の語彙を確認できます。

Kosa のドキュメントによると、ツールは合計 86 個（読み取り 56 個、書き込み 30 個）です。

Kosa MCP Server のユースケース

• 会議の準備：「次の会議についてまとめて。相手は誰か、過去のやり取り、その相手との案件履歴を教えて」。
• 見送り履歴：「昨年この会社を見送った理由は？」
• 紹介ルート探し：「この創業者を一番よく知っているのはチームの誰？」や「このラウンドに合う投資会社と、それぞれとの関係の深さは？」
• パイプラインのレビュー：「アクティブな案件をステージ別に表示し、停滞している案件に印を付けて」。
• ポートフォリオのレポート：「投資先企業の週次ブリーフを書いて」や「自分が担当する企業の ARR、ランウェイ、従業員数を表示して」。
• レコードの更新：read_write の認証情報があれば、「これらの案件を次のステージに移して」や「この会社の案件を作成して」。

Kosa MCP Server のトラブルシューティング

• 書き込みで PERMISSION_DENIED が返る：認証情報のティアが不足しています。レコードの変更には read_write、ルーブリック管理には full が必要です。
• HTTP 429：MCP と REST の呼び出しは、認証情報ごとの 1 分あたりのリクエスト枠を共有します。Retry-After ヘッダーの秒数だけ待ってから再試行してください。
• 未認証のレスポンス：エンドポイントにはサインインが必要です。クライアントから OAuth フローを完了するか、API キーが Authorization: Bearer で送られているか確認してください。
• ツールごとの上限：一部のツールには追加の制限があり、たとえば onboarding_start はユーザーごとに 1 時間 10 回、外部エンリッチメントやウェブ調査には会話ごとの予算があります。