アカウントを作成する

Codens family は Auth Codens という統合認証基盤を共有しています。1 つのアカウントで Red / Blue / Green / Purple / Yellow すべてにログインできます。

https://auth.codens.ai/ja/signup を開きます。
メールアドレスとパスワードを入力するか、Google / GitHub の SSO を選択します。
確認メールのリンクからメールアドレスを認証します。

新規アカウントには Free Trial として 30,000 credits（14 日間）が付与されます。クレジットカード登録は不要です。詳細は Pricing を参照してください。

2

Organization をセットアップ

Codens family は organization 単位で課金とリソースを管理します。個人利用でも 1 つの organization が必要です。

サインアップ直後の画面で organization 名を入力（後から変更可能）。
必要に応じてメンバーを招待。Admin / Member のロールを選択できます。
請求情報は後から Auth Codens の billing 設定で登録できます。

各プロダクトごとに独立した organization_id を持ちます。SSO トークンは共通ですが、Red / Blue / Green / Purple の各サービス上では別々の UUID が割り当てられます。MCP 経由で利用する場合は organization_id 省略時に自動解決されるため、明示指定は不要です。

3

利用するプロダクトを選ぶ

必要なものから順番に有効化できます。全部入れる必要はありません。後から追加可能です。

プロダクト	こんなときに	セットアップ
Purple	タスクを切って AI に実装させ PR まで欲しい	purple.html
Red	Sentry / バグ報告から自動修正 PR が欲しい	red.html
Blue	E2E テストを AI に作って実行させたい	blue.html
Green	要件を整理して PRD / Plan を構造化したい	green.html
Auth	SSO / API key / 組織管理を設定したい	auth.html

4

MCP をセットアップする（推奨）

AI agent（Claude Code / Cursor / Cline など）から直接 Codens を呼ぶには codens-mcp をインストールします。GUI ダッシュボードだけで利用するなら省略可ですが、AI 駆動開発の本領は MCP 経由でこそ発揮されます。

# 1. インストール
pip install codens-mcp

# 2. ~/.claude/settings.json に登録（Claude Code の場合）
{
  "mcpServers": {
    "codens": { "command": "codens-mcp", "args": [] }
  }
}

# 3. Device Code Flow でログイン
codens-mcp login

詳しい手順とトラブル対応は MCP セットアップを参照してください。

5

最初のプロジェクトを作る

GitHub リポジトリを Codens の各プロダクトに紐付けます。同じ repo を複数プロダクトに登録することもできます（unified register tool で 1 コール）。

方法 A. ダッシュボード経由：各プロダクトの管理画面（Red / Blue / Green / Purple）から「New Project」→ GitHub OAuth → repo を選択。

方法 B. MCP 経由（agent からまとめて登録）：

// 同じ repo を 4 プロダクト全部に 1 コールで登録
await tools.codens_register_project_unified({
  repo_full_name: "Corevice/your-repo",
  products: ["purple", "red", "blue", "green"]
});

プロダクトごとの細かい設定（GitHub App インストール / Sentry webhook / Notion link 等）は各プロダクトのセットアップページを参照してください。

Getting Started