#セルフホストガイド

OpenTax は、ご自身の Firebase プロジェクトと Next.js を動かせる環境があれば、自分専用の会計環境として動かせます。データはすべてご自身の Firebase に保存されます。

#必要なもの

• Node.js 22 以上
• Firebase プロジェクト（Authentication・Firestore・Cloud Storage を有効化）
• Firebase Admin SDK 用の認証情報（サービスアカウント鍵、または Application Default Credentials）
• Next.js を動かせるホスティング環境（ローカル、Vercel、Cloud Run など）

#1. リポジトリの取得

git clone https://github.com/arrenem/opentax.git
cd opentax
npm install

#2. Firebase プロジェクトの準備

1. Firebase コンソール でプロジェクトを作成します。
2. Firestore を作成します（ロケーションは asia-northeast1 など、利用者に近いリージョンを推奨）。
3. Cloud Storage を有効にします。
4. Authentication で、使うサインイン方法（メール/パスワード、Google など）を有効にし、承認済みドメイン に OpenTax を公開するドメインを追加します。
5. プロジェクト設定から Web アプリ を追加し、表示される設定値を控えます。

#3. 環境変数の設定

cp .env.local.example .env.local

.env.local とサービスアカウント鍵は絶対にコミットしないでください（.gitignore で除外済みです）。

#4. ルールとインデックスのデプロイ

cp .firebaserc.example .firebaserc   # "your-firebase-project-id" を自分の ID に書き換え
npx firebase-tools login
npx firebase-tools deploy --only firestore:rules,firestore:indexes,storage

リポジトリのルールは、クライアントからの Firestore / Storage への直接アクセスをすべて拒否します。データへのアクセスは、リクエストを認証・認可した Next.js サーバーが Admin SDK 経由でのみ行います。

推奨: oauthCodes.expiresAt と oauthTokens.expiresAt に Firestore の TTL ポリシーを設定すると、期限切れのデータが自動で削除されます。

#5. 起動

npm run dev              # 開発サーバー（http://localhost:3000）
npm run build && npm start   # 本番ビルド

開発環境（NODE_ENV !== 'production'）では、test@example.com / test1234 でサインインすると、ネットワーク不要のテストモードで画面を確認できます。本番ビルドでは無効です。

#6. 公開時の注意

• HTTPS で公開してください。エージェント接続は、ローカル開発用の http://localhost を除き HTTPS のみ受け付けます。
• リモート MCP の動的クライアント登録（POST /api/oauth/register）は MCP の仕様上、認証なしで呼び出せます。必要に応じて、ホスティング側のファイアウォールで /api/oauth/* にレート制限をかけてください。
• Vercel などリクエストボディに上限があるホスティングでは、リモート MCP 経由の証憑アップロードにサイズ制限がかかります（Vercel では約 3 MB）。大きなファイルは stdio アダプター経由でアップロードしてください。

次のステップ: MCP 接続ガイド でエージェントをつなぎます。

GitHub でこのページを編集する ↗