Blog

Paperclip：オープンソースフレームワークで一人会社を経営する方法

Herve Kom

Herve Kom

18 3月 2026

Paperclip：オープンソースフレームワークで一人会社を経営する方法

Paperclipは、AIエージェントを従業員のように統括するオープンソースのワンパーソンカンパニーフレームワークです。組織図、予算、ハートビートスケジューリング、ガバナンス承認、完全な監査ログを備えています。コマンド一つでローカルに立ち上げられ、エージェントが作業を行い、あなたは取締役会を運営します。

2026年には、ワンパーソンカンパニーを運営するということは、もはやすべてを自分で行うことを意味しません。それは、AIエージェントのチームに作業を指示し、あなたが戦略に集中することを意味します。Paperclipは、これを現実にするために構築されたオープンソースのワンパーソンカンパニーフレームワークです。これにより、ソロ創業者は、組織図、予算システム、ガバナンス層、そしてAIエージェントのためのタスクトラッカーを、すべて自己ホスト型ダッシュボードで手に入れることができます。もし、エージェントがやり取りするAPIを設計、モック、テストするためにApidogも使用している場合、Paperclipがそのスタックを完成させます。ApidogがAPI契約を所有し、Paperclipがそれを呼び出すエージェントを所有します。このガイドでは、Paperclipがどのように機能し、今日からそれをワンパーソンオペレーションに組み込む方法を詳しく説明します。

💡
最初のPaperclipハートビートの前に、Apidog (無料) を入手してください。タスクの説明にモックURLを埋め込むことで、エージェントは完璧な契約に基づいて構築できます（コストゼロ、予期せぬ事態もゼロ）。その後、Apidogテストが予算を使い果たす前にずれを検知し、ライブAPIに切り替えます。

ボタン

Paperclipとは何か？ワンパーソンカンパニーフレームワークがApidogユーザーにとって重要な理由

Paperclipのタグラインはそれを直接的に表現しています。「OpenClawが従業員なら、Paperclipは会社である。」

Paperclipは、AIエージェントのコレクションを、役職、報告ライン、月次予算、戦略的目標を持つ構造化された組織に変えるNode.jsサーバーとReact UIです。チャットボット、プロンプトマネージャー、ワークフローのドラッグアンドドロップビルダーではありません。それは、自律型企業のコントロールプレーンです。

このワンパーソンカンパニーフレームワークが今、重要である理由は以下の通りです。

2026年現在、AIエージェントを使用しているほとんどのソロ創業者は、混沌を管理しています。Claude Codeのタブが20個も開いており、どのエージェントがどのファイルを触ったのか記録がなく、トークン消費に上限がなく、エージェントがタスクを完了したのか、それとも幻覚を見たのかを知る方法がありません。Paperclipは、エージェントを実際の会社が従業員を扱うのと同じ方法で扱うことで、これらすべてを解決します。

Apidogを使用してエージェントが呼び出すAPIを定義およびモックするチームにとって、Paperclipは不足しているオーケストレーション層を追加します。ApidogはエージェントにAPI契約が何かを伝えます。Paperclipはエージェントにどのような作業を、いつ行い、いくら使うことが許されているかを伝えます。

ソロ創業者がApidog単独のアプローチよりもこのワンパーソンカンパニーフレームワークを選択する理由

Apidogは、APIの設計とテストを単独で行うことにおいて優れています。しかし、API設計は製品運営の一層に過ぎません。Paperclipは、目標分解、タスク割り当て、進捗追跡、コスト可視化、監査ログといった周辺プロセスを処理します。ApidogとPaperclipを組み合わせることで、ソロ創業者は、人間が方向性を設定し、AIエージェントが実行するソフトウェア会社のための完全なオペレーティングシステムを手に入れることができます。

Paperclipのワンパーソンカンパニーフレームワークの主要機能とApidogの役割

ハートビート: Apidog互換のエージェントアクティベーションループ

ハートビートはPaperclipのコア実行プリミティブです。各ハートビートで、エージェントは以下を行います。

  1. 自身のIDを確認するために GET /api/agents/me を呼び出します
  2. タスクの受信トレイを読み取るために GET /api/companies/:id/issues?status=todo,in_progress を呼び出します
  3. 親目標の系統を含む完全なコンテキストを取得するために GET /api/issues/:id を呼び出します
  4. 作業を実行します (コードの記述、APIの呼び出し、コンテンツ生成)
  5. ステータス更新と行った作業を説明するコメントとともに PATCH /api/issues/:id を呼び出します

ここでApidogの統合が真価を発揮します。タスクが外部APIの呼び出し（例えば、顧客データをプルして週次レポートを生成する）を含む場合、エージェントは開発中にApidogモックサーバーにアクセスし、本番環境では一行のコードも変更せずにライブエンドポイントに切り替えます。Apidogのリクエスト検証は、API契約のわずかなずれがエージェントの作業を静かに中断させる前にそれを捕捉します。

組織図と目標階層 ApidogをAPI層として

Paperclipの目標階層は、会社 → チーム → エージェント → タスクへと流れます。タスクを割り当てられたエージェントは常にその祖先チェーンを受け取るため、新任のエージェントは、「SEOトラフィックを増やす」という目標の一環として、「月間収益100万ドル達成」という大きな目標の一部としてブログ記事を書いていることを理解します。このコンテキストは、エージェントが広範な目標を犠牲にして局所的に最適化することを防ぎます。

この階層内で、ApidogはAPI仕様層として機能します。Apidogで内部サービスを定義し、それぞれにモックサーバーを公開し、エージェントはタスクの説明でそれらのApidogエンドポイントを参照します。APIが変更された場合、Apidog仕様を更新し、モックを再生成すると、すべてのダウンストリームエージェントは自動的に新しい契約を受け取ります。

予算執行: Apidogワークフローでの予算の暴走を止める

Paperclipのすべてのエージェントには budgetMonthlyCents フィールドがあります。エージェントの spentMonthlyCents がその上限に達すると、タスクの受け入れを停止します。上書きも例外もありません。リーンに運営するワンパーソンカンパニーにとって、これは残りの機能を可能にする機能です。エージェントに月20ドルの予算を与えれば、それが決して超過しないことを確実に知ることができます。

これをApidogのモックサーバーと組み合わせると、ライブAIプロバイダーに切り替える前に、モックに対してエージェント作業の全スプリントを実行できます（トークンコストゼロ）。プロトタイプ作成は無料。本番稼働には予算が割り当てられます。

Apidogを使ったPaperclipのワンパーソンカンパニーフレームワークとしての設定{#setup}

ゼロコンフィグのローカル起動 Apidogはすぐに接続

Paperclipを起動するには、単一のコマンドを実行します。

npx paperclipai onboard --yes

これにより、組み込みのPostgreSQLデータベースがブートストラップされ、マスター暗号化キーが生成され、すべてのデータベース移行が適用され、http://localhost:3100 でサーバーが起動します。Dockerは不要で、外部サービスも必要ありません。

起動後、UIを開き、会社を作成し、最初の目標を定義します。

"Build the #1 AI-powered API monitoring tool to $1M MRR."

次に、最初のエージェント、例えば claude_local アダプターを使用する「バックエンドエンジニア」エージェントを作成します。

{
  "adapterType": "claude_local",
  "adapterConfig": {
    "model": "claude-opus-4-6",
    "maxTokens": 4096
  },
  "budgetMonthlyCents": 2000
}

エージェントのタスクをApidogモックサーバーに向けます。タスクの説明にはApidogコレクションのURLを参照させ、エージェントが完全なAPI契約をコンテキストとして利用できるようにします。

Apidogモックとエージェントタスクの接続

Paperclipでは、タスクの説明は完全な祖先コンテキストを含むリッチなMarkdownです。ApidogモックのベースURLを直接埋め込むことができます。

## タスク: /usersエンドポイントにページネーションを追加

**Apidog Mock Base:** http://localhost:4523/m1/123456/users
**受け入れ条件:**
- エンドポイントは `page` および `limit` クエリパラメータを受け入れる
- `{ data: [], total: 0, page: 1 }` のエンベロープを返す
- エッジケース (page=0, limit>100) のユニットテストカバレッジ

エージェントはこれを読み取り、Apidogモックを呼び出して現在のレスポンス形式を確認し、実装を記述し、コメントとともに報告します。

Apidogを使ったPaperclipのワンパーソンカンパニーフレームワークでのエージェント、タスク、ハートビートの実行

Paperclip Apidogパイプラインを通じたイシュー管理

Paperclip CLIは、UIを開かずにタスクのライフサイクルを完全に制御できます。

# エージェントが新しいApidogで定義されたエンドポイントを実装するタスクを作成
pnpm paperclipai issue create \
  --company-id  \
  --title "Apidog仕様に従ってPOST /webhooksエンドポイントを実装" \
  --description "Apidogコレクションを参照: http://localhost:4523/..."

# タスクステータスを確認
pnpm paperclipai issue list --company-id  --status in_progress

# エージェントが詰まった場合にタスクを解放
pnpm paperclipai issue release

各ステータス変更は不変のアクティビティログに記録されるため、どのエージェントがどのタスクに触れ、何を言ったかを常に正確に把握できます。

Apidog統合型ワンパーソンカンパニーフレームワークにおけるガバナンスと承認

Paperclipのガバナンスモデルは、あなたを取締役会の役割に位置づけます。エージェントが採用されたり、主要な戦略が承認されたりする前に、Paperclipはあなたの明示的な承認を要求できます。

# 保留中の承認を確認
pnpm paperclipai approval list --company-id 

# 新しいエージェントの採用を承認
pnpm paperclipai approval approve  \
  --decision-note "承認しました。最初のスプリントにはApidogモックを使用してください。"

これにより、ワンパーソンカンパニーフレームワークが自律性の破綻に陥るのを防ぎます。エージェントが提案し、あなたが決定します。

Paperclip + Apidog ワンパーソンカンパニーフレームワークスタックにおけるテスト、ガバナンス、コスト管理

Paperclip Apidogユニットテストスイートの実行

Paperclipは、Vitestを搭載した完全なユニットテストスイートと、Playwrightを搭載したエンドツーエンドテストを同梱しています。それらを実行するのは簡単です。

# 全てのユニットテストを実行
pnpm test:run

# エンドツーエンドテストを実行
pnpm test:e2e

# ヘルスチェック — サーバーとApidogモックが到達可能であることを確認
curl http://localhost:3100/api/health

ユニットテストスイートは、イシューの状態遷移、予算執行、ハートビート実行ライフサイクル、エージェント認証といったコアビジネスロジックをカバーしています。新しいAIプロバイダーを接続するためにカスタムアダプターを追加する際、ユニットテストスイートを実行することで、既存のオーケストレーション動作が変更されていないことを確認できます。

ワンパーソンカンパニーフレームワークでは、これは従来のチームよりも重要です。コードレビューアがいません。ユニットテストスイートとApidogの契約テストがあなたのセーフティネットです。

3層の品質スタック: Paperclip + Apidog + ユニットテスト

ソロ創業者向けの実用的な品質パターン:

  1. ApidogがAPI契約を定義し、プッシュごとに自動契約テストを実行します
  2. Paperclipのイシューには、Apidogの仕様を参照する受け入れ基準が含まれています
  3. ユニットテスト (Vitest) が、実装が両方に一致することを確認します

この3層アプローチにより、ソロ創業者は、会議なしで5人チームがピアレビューから得るのと同じ品質保証を得ることができます。

結論

Paperclipは、ソロ創業者を会社に変えるオープンソースのワンパーソンカンパニーフレームワークです。組織図、予算管理、ガバナンス、目標アライメント、ハートビートスケジューリング、そして完全な監査証跡をAIエージェント管理にもたらします。すべてが自己ホスト型、すべてオープンソース、すべてあなたのものです。

Apidogを既に利用してAPIを設計・テストしている開発者にとって、Paperclipを追加することでスタックが完成します。ApidogはAPIが何をするかを扱い、Paperclipは誰が、いつ、なぜ、どれだけのコストでAPIを呼び出すかを扱います。これらが一体となって、初日から本番稼働レベルのワンパーソンカンパニーフレームワークを形成します。Apidogのモックサーバーがエージェント開発を促進し、Apidogの契約テストがエージェントの出力を検証し、Paperclipのガバナンス層は、あなたが承認していない行動をエージェントが起こさないようにします。

開始するには:

ワンパーソンカンパニーはもはや比喩ではありません。PaperclipとApidogがあれば、それはアーキテクチャとなります。

ボタン

よくある質問

Paperclipとは何ですか？ Paperclipは、AIエージェントを組織図、予算、ハートビートスケジューリング、ガバナンスで統括するオープンソースのワンパーソンカンパニーフレームワーク、すなわちNode.jsサーバーとReact UIです。人間の従業員の代わりにAIエージェントを使ってソフトウェア会社を運営するためのコントロールプレーンです。

PaperclipはApidogとどのように統合されますか？ Apidogは、エージェントが作業するAPI契約を定義します。Paperclipのタスク説明にApidogモックのURLを埋め込み、エージェントは開発中にそれらのモックを呼び出し、Apidogの契約テストが最終的な実装を検証します。Paperclipがオーケストレーションを処理し、ApidogがAPI仕様を処理します。

Paperclipは真のワンパーソンカンパニーに適していますか？ はい。ゼロコンフィグのローカルセットアップ（npx paperclipai onboard --yes）はインフラストラクチャを必要としません。予算制限によりコストの暴走を防ぎます。ハートビートシステムは繰り返し作業を自動的に処理します。Tailscale統合により、スマートフォンからエージェントを管理できます。同じ設定でローカルからクラウドへとスケールします。

ユニットテストはどのように実行しますか？ Vitestユニットテストスイートの場合は pnpm test:run を、Playwrightエンドツーエンドテストの場合は pnpm test:e2e を実行します。http://localhost:3100/api/health に対するヘルスチェックにより、テスト前にサーバーが正常に稼働していることを確認します。

PaperclipはどのようなAIエージェントをサポートしていますか？ PaperclipはClaude（ローカルおよびOpenClaw経由）、Codex、Cursor、Gemini、OpenCode、およびHTTPを話すかローカルプロセスとして実行されるあらゆるエージェントをサポートしています。アダプターシステムはオープンであり、エージェントがハートビートを受信できるなら、採用することができます。

Paperclipはオープンソースですか？ はい。PaperclipはMITライセンスであり、github.com/paperclipai/paperclip で活発にメンテナンスされています。プラグインSDK、アダプターパッケージ、スキル定義はすべて @paperclipai/* のスコープ付きNPMパッケージとして公開されています。

ApidogでAPIデザイン中心のアプローチを取る

APIの開発と利用をよりシンプルなことにする方法を発見できる

無料会員登録ダウンロード
Paperclip：オープンソースフレームワークで一人会社を経営する方法