Founders Os

Founders OS

スタートアップや小規模事業の創業者向けオープンソース MCP サーバーです。

Founders OS では、CRM、プロジェクト、タスク、財務、フィード、メモリー、プレイブックなど、ビジネスに関するあらゆる情報を、Claude、Cursor、または MCP 互換の AI クライアントから利用できます。接続は 1 つで、ビジネス全体にアクセスできます。

OurThinkTank が開発しました。マーケティングサイトは foundersmcp.com です。

AI ツールを使うのが初めての方や、使い方を誰かに教える方は、まず こちらをお読みください。FoundersOS ができること・できないこと、AI アシスタントができること・できないこと、そして誠実に使い続けるための習慣について、わかりやすく説明しています。

含まれる機能

モジュール	ツール	説明
CRM	13	顧客、連絡先、やり取り、パイプラインダッシュボード
Tasks	12	エンティティとの連携、AI による割り当て、依存関係、進捗メモに対応したタスク
Projects	5	プロジェクトタグを基準とする独立したプロジェクトレコードと、タスクの集計
Playbooks	11	タスクや外部 MCP アクションに処理を振り分ける、再利用可能なオーケストレーションテンプレート
Tags	4	ソフトな検証と自動登録に対応した共有タグレジストリ
Financial	14	複式簿記台帳、損益計算書、複数企業、ユーザーごとのアクセス制御
Feeds	13	RSS／Atom／JSON リーダー、ブリーフィング、ブックマーク、ピン留め
Memory	5	個人と組織のスコープ、pgvector、重複排除、メタデータフィルターに対応したセマンティックメモリー
Surfaces	6	複数のドメインにまたがる読み取り機能：セッション開始、エンティティカード、週次振り返り、停滞リスト、セッションチェックポイント、プロジェクト履歴
Members	4	組織メンバーのディレクトリ、オーナーの指定
Audit + Restore	2	完全な監査ログ、ソフト削除からの復元
Diagnostic	5	Ping、バージョン、利用ガイド、機能エクスプローラー、デモ

12 個のモジュールに合計 94 個のツールが含まれています。

クイックスタート

Supabase プロジェクト、埋め込み API キー（デフォルトは OpenAI）、MCP 対応の AI クライアントが必要です。

1. Supabase をセットアップする

Supabase プロジェクトを作成し、SQL エディターで supabase/setup.sql を実行します。この 1 つのファイルで、拡張機能（vector、uuid-ossp、pg_trgm）、すべてのテーブル、インデックス、RLS ポリシー、関数、ビュー、メンテナンスジョブ、および 2026-05-30 以降に作成されたプロジェクトに対する Supabase の自動デフォルト権限の廃止との互換性に必要な Data API の権限付与を含む、完全なスキーマを最初からセットアップできます。foundersmcp.com/setup のウィザードでは、利用するプロバイダーに合わせて埋め込みの次元数を設定した同じ SQL が表示されます。デフォルトの次元数を使用しない場合は、こちらをお使いください。

2. AI クライアントを接続する

Founders OS MCP サーバーは npx で実行されます。Claude Desktop、Cowork、Cursor、Continue.dev、Zed、または仕様に準拠した MCP クライアントは、すべて同じ設定を使用します。

最も手軽な方法は、foundersmcp.com/setup のウィザードを使うことです。Supabase と埋め込みの認証情報を入力すると、コピーまたはダウンロードできる設定が生成されます。認証情報がブラウザーの外に送信されることはありません。以下のブロックを手動で貼り付けることもできます。

これをクライアントの mcp.json に貼り付けます（Claude Desktop では、設定内の MCP サーバーセクションです）。

{
  "mcpServers": {
    "founders-os": {
      "command": "npx",
      "args": ["-y", "@ourthinktank/founders-os@latest"],
      "env": {
        "SUPABASE_URL": "https://your-project.supabase.co",
        "SUPABASE_SECRET_KEY": "sb_secret_...",
        "FOUNDERS_OS_COMPANY_ID": "your-company",
        "FOUNDERS_OS_USER_ID": "your-name",
        "FOUNDERS_OS_TIMEZONE": "America/Los_Angeles",
        "EMBEDDING_PROVIDER": "openai",
        "EMBEDDING_MODEL": "text-embedding-3-small",
        "EMBEDDING_DIM": "1536",
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

一覧とプロバイダーのオプションについては、環境変数をご覧ください。

3. 試してみる

What can you do?                                  -> show_capabilities
Catch me up                                       -> get_session_start
Add Acme Corp as a new prospect                   -> add_customer
Log a call with Sarah at Acme - discussed pricing -> log_interaction
Create a task to send the proposal by Friday      -> create_task + link_task
What's stuck or overdue?                          -> get_stuck_list
Show me everything about Acme Corp                -> get_entity_card
Remember for the org: targeting SMB fintech in Q3 -> memory_store
Show me OTT's P&L for Q1                          -> get_pl_report
Run the customer-onboarding playbook for Acme     -> run_playbook
Give me my weekly retro for LinkedIn              -> get_weekly_retro
Let's checkpoint - wrap up this session           -> checkpoint
What's happened on founders-os lately?            -> get_project_history

---

CRM（13 ツール）

顧客組織とその組織に属する連絡先を管理するパイプラインです。顧客は組織、連絡先は個人として、それぞれ常に別のレコードで管理されます。そのため、履歴を失うことなく、連絡先を別の顧客に移動できます。

顧客： add_customer、get_customer、update_customer、remove_customer、search_customers、list_customers

連絡先： add_contact、update_contact、remove_contact、search_contacts

やり取り： log_interaction、list_interactions

ダッシュボード： get_dashboard

パイプラインのフェーズ： prospect -> lead -> opportunity -> customer -> renewal（さらに churned、inactive）。

---

タスク（12 ツール）

組織と個人のスコープ、エンティティとのリンク、AI による割り当て、タスクの依存関係、進捗メモ、タスクからメモリーへの連携機能を備えた統合タスク管理です。

create_task、get_task、update_task、complete_task、remove_task、list_tasks、link_task、unlink_task、list_entity_tasks、add_task_note、assign_task、get_task_summary

スコープ： org（チームに公開、デフォルト）と personal（作成者のみ）。

AI への割り当て： 担当者に @claude または @gpt を指定します。get_task_summary では、専用の AI 作業キューを確認できます。list_tasks(assigned_to='@claude') を指定すると、AI に割り当てられた作業に絞り込めます。

依存関係： タスクに blocked_by_task_id を設定します。ブロッカーを完了すると、レスポンスに unblocked_tasks が表示されます。

タスクからメモリーへの連携： タスクの完了時に store_as_memory=true を設定すると、完了メモが組織スコープのメモリーエントリとして保存されます。

エンティティとのリンク： タスクは task_links 中間テーブルを介して、顧客、連絡先、やり取り、取引、プロジェクト、プレイブック、メモリー、その他あらゆる種類のエンティティにリンクできます。作成時にリンクするか、後から link_task でリンクできます。

---

プロジェクト（5 ツール）

プロジェクトタグ（例：#acme-rebuild）を軸にした、独立したレコードです。get_project は、ステータス、リンクされたタグ、ステータスごとにグループ化された最近のタスク、タグ付けされた顧客を含むプロジェクトカードを返します。

create_project、get_project、update_project、remove_project、list_projects

list_projects は、レジストリにあるものの、まだプロジェクトレコードがない # で始まるタグも示します。これにより、レジストリとプロジェクトディレクトリの同期を保てます。

---

プレイブック（11 ツール）

名前を付けて再利用できるオーケストレーションテンプレートです。プレイブックを一度定義し、顧客（またはその他の対象）に対して実行すると、完全なプロジェクトを立ち上げられます。ネイティブの Founders OS タスクを作成し、接続された MCP ツールがある場合は、GitHub リポジトリの作成、Slack への投稿、カレンダーイベントのスケジュール設定などの外部アクションも実行します。コネクターが利用できない場合、そのステップはタグ付きの [manual] タスクに適切にフォールバックするため、プレイブックは引き続き機能します。

create_playbook、get_playbook、update_playbook、remove_playbook、list_playbooks、add_playbook_step、update_playbook_step、remove_playbook_step、run_playbook、get_playbook_run、list_playbook_runs

ステップの種類： native_task（Founders OS タスク）または external_action（MCP ツール呼び出し）。外部ステップには、connector、action、プレースホルダーを含む params オブジェクトを指定します。

プレースホルダー： {{customer.name}}、{{customer.slug}}、{{playbook.start_date}}、{{playbook.start_date+Nd}}、{{contact.primary.name}}、{{memory:key}} は、実行時に解決されます。

実行ログ： get_playbook_run は実行ログ全体を返し、list_playbook_runs はプレイブックごとの履歴を表示します。

---

タグ（4 ツール）

ソフトバリデーションに対応した共有タグレジストリです。タグは参考情報として扱われます。認識されないタグがあっても警告が表示されるだけで、操作がブロックされることはありません。また、新しいタグは初回使用時に自動登録されます。

list_tags、create_tag、rename_tag、remove_tag

規約： プロジェクトには #project-name、人物には @person、メタ状態には !state（例：!needs-review）を使用します。bug や release のような単純なカテゴリ名には、接頭辞を付けなくても構いません。

バリデーションチェック： 既存タグと照合した誤字の検出、既知の連絡先の検出（@ の使用を促します）、既知の顧客の検出（エンティティのリンクを促します）、状態を表す語の検出（! の使用を促します）。

---

財務（14 ツール）

FOUNDERS_OS_COMPANY_ID の値に基づく、シンプルな複式簿記の台帳です。ユーザーごとのアクセス制御により、会社の帳簿を特定のチームメイトにのみ公開できます。

add_transaction、list_transactions、remove_transaction、add_category、list_categories、remove_category、add_account、list_accounts、remove_account、transfer_between_accounts、get_pl_report、get_financial_summary、get_financial_access、set_financial_access

複数企業： インスタンスごとに異なる FOUNDERS_OS_COMPANY_ID を設定すると、帳簿を分けて管理できます。

アクセス制御： set_financial_access は、メンバーに対して会社の財務ツールへのアクセスを許可または取り消します。get_financial_access は現在の許可状況を報告します。デフォルトでは、FOUNDERS_OS_COMPANY_ID の所有者にアクセス権があります。それ以外のユーザーは、明示的に許可されるまでアクセスできません。

---

フィード（13 ツール）

Postgres を利用したストアを備える、組み込みのフィードリーダー（RSS、Atom、JSON Feed）です。購読、要約、検索、ブックマーク、ピン留めができます。

購読： subscribe_feed、unsubscribe_feed、list_feeds、refresh_feeds、import_starter_feeds、pin_feed、unpin_feed

アイテム： get_feed_items、read_feed_item、get_feed_briefing

ブックマーク： bookmark_item、remove_bookmark、list_bookmarks

カテゴリ： tech、startups、business、finance、product、design、engineering、ai、crypto、science、news、personal、other。

---

メモリ（5 ツール）

個人および組織のスコープ、重複に近い項目の検出、メタデータフィルター、ページネーションに対応した、pgvector ベースのセマンティックメモリです。

memory_store、memory_recall、memory_update、memory_forget、memory_summarize_and_store

スコープ：

• org - 同じ Supabase プロジェクトを参照するすべてのチームメンバーが閲覧できます
• personal - FOUNDERS_OS_USER_ID が一致するユーザーのみが閲覧できます

memory_recall のフィルター： min_score、source_tool、created_after、created_before、offset、limit、project、scope。

重複排除： memory_store と memory_summarize_and_store は、コサイン類似度が 0.92 以上の既存メモリを確認し、強制保存またはスキップするオプションを含む競合を提示します。

埋め込みプロバイダー（EMBEDDING_PROVIDER で設定）：

プロバイダー	デフォルトモデル	次元数	認証情報
openai（デフォルト）	text-embedding-3-small	1536	OPENAI_API_KEY
bedrock	amazon.nova-2-multimodal-embeddings-v1:0	1024	AWS 認証情報チェーン
ollama	nomic-embed-text	768	OLLAMA_BASE_URL

002_memory_schema.sql を実行する前に、モデルに合わせて EMBEDDING_DIM を設定してください。次元数は永続的な設定です。後からプロバイダーを変更する場合は、メモリテーブルの再埋め込みが必要です。

---

サーフェス（6 個のツール）

タスク、CRM、財務、フィードのデータを組み合わせ、AI エージェント向けにすぐ表示できるダッシュボードを生成する、ドメイン横断の読み取りビューです。

ツール	返される内容
get_session_start	オリエンテーション用ダッシュボードです。タスクのシグナル、AI キュー、財務の状況、CRM のアクティビティ、フィードの未読件数、推奨アクション、初回実行フラグ、4 段階のレンダリング契約を返します。毎セッションの開始時に呼び出してください。
get_entity_card	顧客、連絡先、取引、プロジェクトなど、あらゆるエンティティの全体像を返します。未完了のタスク、最近のやり取り、リンクされたレコードを 1 回の呼び出しで取得できます。
get_weekly_retro	完了したタスクをタグごとにグループ化し、完了時のメモとともに振り返ります。LinkedIn にそのまま投稿できる形式にできます。
get_stuck_list	トリアージが必要な、停滞中、長期間更新されていない、期限超過のタスクを表示します。更新なしの日数と推奨アクションも含まれます。
checkpoint	get_session_start と対になる、セッション終了時の処理です。順序付きの締めくくり手順（要約、リポジトリの変更をコミットリンクとして記録、記録の保存、フォローアップタスクの提案、引き継ぎドキュメントの作成）、実行する正確なメモリ呼び出し、前回のチェックポイントを返し、未完了項目を次回に引き継ぎます。メモリを利用するため、新しいエンティティの追加や移行は不要です。
get_project_history	プロジェクトのチェックポイントを新しい順に並べた時系列です。セマンティックメモリ検索に対する「何が、どの順番で起きたか」を示す補完機能です。チェックポイントだけでなくすべてのメモリを取得するには、kind: 'all' を渡してください。

---

メンバー（4 個のツール）

組織メンバーのディレクトリです。FOUNDERS_OS_USER_ID のスラッグを表示名に対応付け、会社のオーナーを示し、メンバーの追加や削除をサポートします。

add_member、list_members、remove_member、set_member_owner

FOUNDERS_OS_COMPANY_ID のオーナーは財務アクセス権のデフォルトの保持者です。他のメンバーには set_financial_access でアクセス権を付与できます。

---

監査と復元（2 個のツール）

get_audit_log は、すべてのドメインにわたる構造化された監査証跡（作成、更新、削除、復元、財務アクセス権の変更、プレイブックの実行）を返します。

restore_item は、ソフト削除されたあらゆる種類のレコードのソフト削除を取り消し、レコードを以前の状態に戻します。監査ログから元の削除イベントと復元するエンティティ ID を見つけてください。

---

診断とメタ情報（5 個のツール）

ツール	説明
ping	接続テストです。新しいパッケージバージョンが利用可能な場合は、更新通知を含めます。
get_version	実行中のパッケージバージョン、レンダリング契約のバージョン、npm で公開されている最新バージョンを返します。
get_usage_guide	モジュール、規約、一般的なワークフローをまとめた、必要に応じて参照できるガイドです。
show_capabilities	各モジュールのプロンプト例を含む、わかりやすい概要を表示します。
list_demos	同梱のインタラクティブなチュートリアル（ウェルカムツアー、競合解決、週間タスクの実行など）を一覧表示または実行します。

---

レンダリング契約

レンダリングを伴うツールには render フィールドがあり、4 段階の優先順位を示します。これにより、AI クライアントは対応している最も視覚的な出力を選択できます。視覚プリミティブツール（artifact／widget／canvas）、インラインのリッチ出力（HTML／SVG／JSX）、Markdown テーブル、文章の順です。この契約は、注意喚起の強さ順に次の 3 つの経路で提供されます。

1. MCP 登録時のサーバー instructions フィールド — 接続時に読み込まれます。仕様に準拠するすべての MCP クライアントが対象です。
2. get_session_start.rendering_contract — セッションのオリエンテーション時に、優先順位の全内容を返します。すべてのクライアントが対象です。
3. 応答ごとの rendering_contract リマインダー — 単独で利用できる短縮版です。コールドスタート時の安全策になります。

正規のソースは packages/mcp-server/src/contract.ts にあるため、プラグインなしで、すべての MCP クライアントがこれらの経路を通じてリッチなレンダリングを利用できます。（長時間のセッションでより確実に従わせるため、システムプロンプト内の優先位置に契約を反映する Claude プラグインは、後続リリースで計画されており、今回のリリースには含まれません。）現在の contract_version は 4 です。不一致がある場合、get_session_start と get_version で contract_version_warning が表示されます。

---

初回起動時のオンボーディング

データベースが空の場合、ツールは応答にオンボーディングのヒントを添えます。get_session_start は新規インストールを検出し、最初の顧客の追加、最初のタスクの作成、必要に応じた財務アカウントの設定を含むガイド付きの手順を提案します。これにより、92 個のツールを一度にすべて提示するのではなく、会話形式で利用を始められます。

特定の機能のガイド付きツアーを利用するには、AI に「ウェルカムデモを実行して」または「競合解決の手順を見せて」と依頼してください。list_demos は、同梱されている対話形式のスクリプトを返します。

---

環境変数

# Supabase (required)
SUPABASE_URL=https://your-project.supabase.co
SUPABASE_SECRET_KEY=sb_secret_...

# Identity - set distinct values per teammate so personal memory scopes work
FOUNDERS_OS_USER_ID=your-name            # defaults to "default"
FOUNDERS_OS_COMPANY_ID=your-company      # defaults to "default"
FOUNDERS_OS_TIMEZONE=America/Los_Angeles # used by date-aware tools and YTD math

# Embedding provider for memory tools
EMBEDDING_PROVIDER=openai                # openai | bedrock | ollama
EMBEDDING_MODEL=text-embedding-3-small   # provider default used if omitted
EMBEDDING_DIM=1536                       # MUST match the vector() size in 002_memory_schema.sql

# OpenAI (required if EMBEDDING_PROVIDER=openai)
OPENAI_API_KEY=sk-...

# Bedrock (uses AWS credential chain - no key needed on AWS with IAM role)
# AWS_DEFAULT_REGION=us-east-1
# AWS_ACCESS_KEY_ID=...
# AWS_SECRET_ACCESS_KEY=...

# Ollama (required if EMBEDDING_PROVIDER=ollama)
# OLLAMA_BASE_URL=http://localhost:11434

---

開発

# Clone
git clone https://github.com/ourthinktank/founders-os.git
cd founders-os

# Install
npm install

# Build
npm run build

# Watch
npm run dev

プロジェクト構成

founders-os/
├── packages/
│   ├── mcp-server/                  # @ourthinktank/founders-os npm package
│   │   ├── src/
│   │   │   ├── index.ts             # Entry point (stdio transport)
│   │   │   ├── supabase.ts          # Database client
│   │   │   ├── contract.ts          # Canonical rendering contract
│   │   │   └── tools/
│   │   │       ├── crm/             # Customers, contacts, interactions, dashboard
│   │   │       ├── tasks/           # Task management
│   │   │       ├── projects/        # Project records
│   │   │       ├── playbooks/       # Reusable orchestration templates
│   │   │       ├── tags/            # Shared tag registry
│   │   │       ├── financial/       # Ledger + access control
│   │   │       ├── rss/             # Feed reader
│   │   │       ├── memory/          # Semantic memory
│   │   │       ├── surfaces/        # Cross-domain reads
│   │   │       ├── members/         # Org directory
│   │   │       ├── audit.ts         # Audit log
│   │   │       ├── restore.ts       # Soft-delete recovery
│   │   │       ├── diagnostic.ts    # Ping + version
│   │   │       ├── meta.ts          # Usage guide + capabilities + demos
│   │   │       ├── first-run.ts     # Empty-database hints
│   │   │       ├── dates.ts         # Date/timezone helpers
│   │   │       └── permissions.ts   # Financial access checks
│   │   └── demos/                   # Interactive walkthrough scripts
├── integrations/
│   └── setup-page/                  # Config wizard hosted at foundersmcp.com/setup
├── supabase/
│   ├── setup.sql                    # Complete schema for fresh installs (run once)
│   └── migrations/                  # Future schema changes (currently empty)
├── docs/                            # Specs and design docs
└── README.md

テスト用のローカルインストール

ビルドした後、npx の代わりにローカルのエントリーポイントを MCP クライアントに指定してください。

{
  "mcpServers": {
    "founders-os": {
      "command": "node",
      "args": ["/absolute/path/to/founders-os/packages/mcp-server/dist/index.js"],
      "env": {
        "SUPABASE_URL": "https://your-project.supabase.co",
        "SUPABASE_SECRET_KEY": "sb_secret_...",
        "FOUNDERS_OS_USER_ID": "your-name",
        "FOUNDERS_OS_COMPANY_ID": "your-company",
        "EMBEDDING_PROVIDER": "openai",
        "EMBEDDING_DIM": "1536",
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

---

コントリビューション

Founders OS は MIT ライセンスのオープンソースです。現在、外部からのコントリビューションは受け付けていませんが、近日中に開始する予定です。それまでの間、イシューの報告は歓迎しており、ぜひお寄せください。GitHub から報告してください。適切な報告の方法については CONTRIBUTING.md と 行動規範 をご覧ください。セキュリティに関する問題は、公開イシューではなく SECURITY.md の手順に従って報告してください。

ライセンス

MIT ライセンスです。詳しくは LICENSE をご覧ください。