Kumbaa

Kumbaa MCP サーバー

家族のアーカイブを、あらゆる AI アシスタントで利用できます。 Kumbaa は、ひとつの家族のためのプライベートなウェブサイトです。家系図、家族の人々の人生の物語、古い写真を保管し、家族が招待した親族だけが閲覧できます。Model Context Protocol に対応した Claude、ChatGPT、その他のアプリに接続すると、家族について質問したり、写真を見たりできます。また、アーカイブの管理者であれば、人を追加して家系図に登録したり、写真に説明やタグを付けたり、親族を招待したりできます。

https://kumbaa.app/mcp

ホスト型のリモートサーバー（Streamable HTTP）です。インストールも API キーも不要です。ツールを初めて使用するときに、家族のウェブサイトで使っているものと同じ Kumbaa アカウントでサインインし、接続を承認します。一度接続すれば、所属するすべての家族のアーカイブに、それぞれの役割に応じてアクセスできます。

このリポジトリに含まれているのは、接続手順と設定のみです。Kumbaa のサービスとサーバーコードはここにはありません。

接続する前に

すでに家族のアーカイブに参加している Kumbaa アカウントが必要です。招待に使われたメールアドレスで家族のウェブサイト（<family>.kumbaa.app）に一度サインインするか、kumbaa.app でアーカイブを作成してください。アシスタントはそのアカウントとして動作します。まだサインインしていない場合、すべてのツールから、まずウェブサイトにサインインするよう案内されます。

試してみる

• 「父方の曾祖父母は誰ですか？」
• 「ナニについて教えてください。生まれたのはいつで、子どもは誰ですか？」
• 「1965 年の結婚式の写真を探して、写っている人を教えてください。」
• 「古い実家の写真を見せてください。」
• 「1990 年生まれのいとこのプリヤを、ラヴィとミーナの娘として追加してください。」（管理者）
• 「この 3 枚の写真に説明を付けて、ディワリのアルバムに入れてください。」（管理者）
• 「アシャさん（[email protected]）を閲覧者として家族に招待してください。」（管理者）

接続する

アプリ	方法
Claude（ウェブ、デスクトップ、モバイル）	Settings → Connectors → Add custom connector → https://kumbaa.app/mcp。手順の詳細：kumbaa.app/claude。
ChatGPT	上記の URL を使ってアプリとして追加します（Plus、Pro、Business、Enterprise、Edu で Developer mode を使用）。手順の詳細：kumbaa.app/chatgpt。
Claude Code	claude mcp add --transport http kumbaa https://kumbaa.app/mcp を実行し、続いて /mcp でサインインします。
VS Code（Copilot）	コマンドパレット → MCP: Add Server → HTTP → https://kumbaa.app/mcp を選ぶか、clients/vscode-mcp.json を .vscode/mcp.json にコピーします。
Gemini CLI	gemini extensions install https://github.com/sanjaybhagia/kumbaa-mcp を実行し、続いて /mcp auth kumbaa を実行します。
Codex CLI	clients/codex-config.toml を ~/.codex/config.toml に追加し、続いて codex mcp login kumbaa を実行します。
Cursor	Settings → MCP → Add server を選ぶか、mcp.json を ~/.cursor/mcp.json にコピーします。認証の詳細を参照してください。
Windsurf	clients/windsurf-mcp_config.json を ~/.codeium/windsurf/mcp_config.json に追加します。
その他	https://kumbaa.app/mcp を指定してください。ローカル（stdio）サーバーのみを実行するアプリについては、llms-install.md を参照してください。

ツール

家族のメンバーなら誰でも閲覧ツールを使えます。内容を変更するツールは家族のオーナーとキュレーターが使えます。ビューアーが変更ツールを使おうとすると、キュレーターのみが使えることが通知されます。

ツール	機能
list_families	所属している家族アーカイブ、自分の各アーカイブでの役割、現在のアーカイブを一覧表示します。
switch_family	別の家族アーカイブを現在のものに切り替えます。
list_people	家系図に登録されている全員、または名前に一致する人を、日付、親、パートナー、子どもとともに一覧表示します。
get_person	1人のプロフィール（名前、日付、場所、人物紹介、家族関係、写真）を表示します。
list_albums	家族のフォトアルバムを、年と写真の枚数とともに一覧表示します。
get_album	1つのアルバムとその写真、および各写真に写っている人を表示します。
find_photos	キャプション、場所、人物、アルバムで写真を検索したり、詳細がまだ登録されていない写真を探したりします。
view_photo	1枚の写真を、キャプション、年、場所、写っている人とともに表示します。
add_person	家系図に人物を追加します。
update_person	人物の詳細を変更します。
remove_person	家系図から人物を削除します（写真は残ります）。事前に確認します。
link_people	親、子ども、配偶者、兄弟姉妹の関係を追加または削除します。削除する場合は事前に確認します。
update_marriage	結婚の日付、場所、ストーリーを変更します。
set_tree_start	家系図を開いたときに最初に表示する人物を設定します。
set_portrait	写真を人物のポートレートに設定します。
update_photo	写真のキャプション、年、場所、アルバム、写っている人を変更したり、家族と共有したりします。
update_photos	同じ変更を複数の写真に一度に適用します。
upload_photo	画像のURLまたはファイルから写真を追加します。すぐに共有しない場合は、キュレーターの承認を待ちます。
delete_photo	写真を完全に削除します。事前に確認します。
save_album	アルバムを作成または変更します。
delete_album	アルバムを削除します。写真は残ります。事前に確認します。
list_members	家族アーカイブのメンバーと、招待済みの人を一覧表示します。
invite_people	親族をビューアーまたはキュレーターとしてメールで招待します。
revoke_invitation	まだ使用されていない招待を取り消します。
change_member_role	メンバーをキュレーターまたはビューアーに変更します。
remove_member	メンバーのアクセス権を取り消します。事前に確認します。
rename_family	家族アーカイブの名前を変更します。

すべてのツールにはタイトルと、読み取り専用または破壊的操作を示す注釈があります。人物、写真、アルバム、家族関係、メンバーを削除する操作には、本人の明確な同意が必要です。サーバーは、アシスタントに先に同意を得るよう求めます。所有権の譲渡、家族アーカイブの削除、バックアップ、顔検出はウェブサイトでのみ行えます。

プライバシー

各呼び出しは、ウェブサイトと同様に、その時点でのその家族への所属状況に基づいて確認されます。所属していない家族は、存在しない家族と同じように扱われます。プライバシーポリシーをご覧ください。

プラン

家族アーカイブは14日間無料で、その後は家族ごとに月額US$6.99、または年額US$69です。家族から招待された人は誰でも無料で参加できます。アシスタントとの接続に追加料金はかかりません。kumbaa.app/pricingをご覧ください。

認証の詳細

• PKCE（S256）を使用する OAuth 2.1 のパブリッククライアントです。認可サーバーは https://clerk.kumbaa.app（Clerk）です。
• クライアントはクライアント ID メタデータドキュメント（CIMD、 client_id_metadata_document_supported: true）で自身を識別します。Claude、Claude Code、ChatGPT がこれを使用し、 VS Code と Gemini CLI もサポートしているとしています。動的クライアント登録も有効です （registration_endpoint: https://clerk.kumbaa.app/oauth/register）。Cursor、 mcp-remote など、これのみを使用するアプリ向けです。
• ディスカバリー：認証されていないリクエストには、次の内容を含む 401 が返されます。 WWW-Authenticate: Bearer resource_metadata="https://kumbaa.app/.well-known/oauth-protected-resource/mcp"。 また、https://kumbaa.app/.well-known/oauth-protected-resource と https://kumbaa.app/.well-known/oauth-authorization-server も利用できます。
• アクセストークンは、正確に https://kumbaa.app/mcp（aud クレーム）を対象として発行されます。 ウェブサイトのセッショントークンや、ほかのアドレスを対象とするトークンは拒否されます。
• 公式 MCP Registry 名：app.kumbaa/kumbaa（server.json）。

リンク

kumbaa.app · 機能 · Claude · ChatGPT · 料金 · プライバシー · 利用規約 · サポート · [email protected]

シドニーで Arigato Consulting Pty Ltd. が開発しています。このリポジトリ内のファイルは MIT ライセンスです。 LICENSE をご覧ください。