COGOのインストール

COGOは1つのコンテナ（または1つのバイナリ）です。重要なことは2つだけ：更新をまたいでノートが生き残るように /vault にボリュームをマウントすること、そして — サーバーでは — トークンを設定することです。

サーバー上では、COGOはトークンなしでの起動を拒否します（誰もあなたのボールトに入り込めないように）。長いものを生成して保管してください — 以降 YOUR-TOKEN と呼びます：

openssl rand -hex 32

COGO_ALLOW_INSECURE=1 はローカルのループバック限定の実行のために存在します — サーバーでは決して使わないでください。

自分のマシンで（ローカル、2分）

Docker Desktop がインストールされていれば：

docker run -d --name cogo -p 127.0.0.1:8095:8080 \
  -v cogo-vault:/vault -e COGO_ALLOW_INSECURE=1 \
  ghcr.io/diegoparras/cogo

http://localhost:8095 を開きます。完了です — 信頼度で色付けされたボールトが見え、ノートのキャプチャや編集がすべてブラウザから行えます。

-p 127.0.0.1:8095:8080 はあなたのマシンにのみ公開します — ネットワーク上の誰にも見えません。
-v cogo-vault:/vault はノートをボリュームに保持し、削除されないようにします。
-e COGO_ALLOW_INSECURE=1 は「ローカルだと分かっている、トークンを求めるな」の意味です。ローカル専用。

Dockerなし — ランタイム不要の単一静的バイナリ：

cogo serve -http 127.0.0.1:8080 -vault ./vault

EasyPanelを使うサーバーで（推奨）

EasyPanelはdocker-composeと相性がよくありません — 「Compose」タイプは使わないでください。よりシンプルで、HTTPSを自動的に付ける App タイプを使います。

EasyPanelのプロジェクトで + Add Service → App、名前を cogo にします。
Source — GitHub（リポジトリ diegoparras/cogo、ブランチ main、Build = Dockerfile；常に動きます）、または Docker Image ghcr.io/diegoparras/cogo:latest （パッケージが公開されている必要があります）。
Environment：
```
COGO_MCP_TOKEN=YOUR-TOKEN
COOKIE_SECURE=1
```
（COGO_VAULT=/vault はすでに既定値です。）
Mounts → Add Mount — タイプ Volume、名前 cogo-vault、マウントパス /vault。これを飛ばすと、更新のたびにノートが消えます。
Domains → Add Domain — あなたのドメイン、ポート 8080（COGOの内部ポート）。 HTTPS証明書はEasyPanel自身が発行します。ヘルスチェックのパスを聞かれたら：/healthz。
Deploy し、ドメインを開き、ビューアに求められたら YOUR-TOKEN を貼り付けます。

起動時にアプリがクラッシュする場合は、COGO_MCP_TOKEN を忘れています — COGOは意図的に、無防備なままインターネットに座ることを拒否します。

VPSに手作業で

最も安全な形（銀行グレード）：ポートをまったく公開しない — ループバックにバインドし、トンネル経由で到達します。

# on the VPS:
docker run -d --name cogo -p 127.0.0.1:8080:8080 \
  -v cogo-vault:/vault -e COGO_MCP_TOKEN=YOUR-TOKEN \
  ghcr.io/diegoparras/cogo

# on your machine (SSH tunnel):
ssh -N -L 8080:127.0.0.1:8080 user@your-vps

http://localhost:8080 を開きます。堅牢化デプロイの詳細（トンネル / VPN、プロキシ経由のTLS、制限）は docs/seguridad.md にあります。

Claude Codeを接続する（MCP）

ローカル — 最もシンプル：ネットワークなしで、各セッションが自分のCOGOを起動します。 .mcp.json で：

{ "mcpServers": { "cogo": { "command": "cogo", "args": ["serve", "-vault", "./vault"] } } }

リモート — HTTP経由、トークンをヘッダーに入れて：

{
  "mcpServers": {
    "cogo": {
      "type": "http",
      "url": "https://your-domain/mcp",
      "headers": { "Authorization": "Bearer YOUR-TOKEN" }
    }
  }
}

そこから先は、どのセッションでも pack "<topic>" を頼めば色付きのコンテキストが得られ、 capture で発見を記録できます。今日Claudeが学んだことを、明日Cursorが読みます：同じボールトです。

更新

EasyPanel：もう一度 Deploy（または Rebuild）を押します。/vault ボリュームのおかげで、ノートは残ります。
素のDocker：docker pull ghcr.io/diegoparras/cogo を実行し、同じ -v cogo-vault:/vault でコンテナを再作成します。

オプション：AIモデル

COGOはモデルなしでも完璧に動きます。ノート間の矛盾を検出させ、Guard を研ぎ澄ませたい場合は、ビューア → メニュー → Settings · AI model を開き、ローカル（Ollama）またはリモート（OpenRouter、DeepSeek）のモデルを接続します。トークンの消費は同じメニューに表示されます。

ドキュメントを読む