Control-N'AI 必要なソフトと API 一覧

Control-N'AI を使うために必要なものを整理したリストです。 インストーラー実行だけで使い始められるものが大半 で、追加の設定が必要なのは外部サービス（API・Tailscale）連携の部分のみです。

1. ソフトウェア（ローカルにインストールするもの）

🟢 インストーラーに同梱（追加作業不要）

これらはすべて Control-NAI-Setup.exe を実行するだけで自動的に組み込まれます。別途ダウンロード・インストールする必要はありません。

ソフト	用途	状態
Node.js v20	NAIのアプリエンジン（JavaScriptランタイム）	✅ 同梱
NSSM	NAIをWindowsサービスとして常駐させる	✅ 同梱
fuda-renderer.exe	名札画像レンダラー（Python製、EXE化済み）	✅ 同梱
SumatraPDF	札を直接プリンタに印刷する補助ツール	✅ 同梱
updater.ps1	自動アップデートスクリプト	✅ 同梱
sql.js	データベースエンジン（埋め込み型）	✅ 同梱

💡 あると便利なソフト（任意）

必須ではありません。「こんなことがしたい」と思った時に必要なものだけ入れてください。

ソフト	こんな時に便利	入手先
Tailscale	外出先・スマホからNAIへアクセスしたい時	https://tailscale.com/download/windows
Claude Desktop	NAIを自分でカスタマイズしたい上級者向け（普段使いには不要）	https://claude.ai/download
Node.js（公式版）	上記Claude Desktop で MCP 連携を使う時のみ	https://nodejs.org/ja/download

2. データベース

項目	内容
エンジン	SQLite（sql.js経由でNode.jsに埋め込み）
インストール作業	不要（NAI本体に内蔵）
データファイル	`C:\control-nai\hanaten.db`（1ファイルだけ）
バックアップ方法	上記ファイルをコピーするだけ
テーブル数	約50テーブル（顧客・伝票・請求・経理・設定・写真など）

別途 MySQL や PostgreSQL のような データベースサーバーソフトを立てる必要はありません。ファイルベースの軽量DB なので、PC1台で完結します。

3. 外部API・サービス

NAIは多くの機能を 外部APIサービス と連携して動作します。すべて取得は無料 or 従量課金で、使う機能の範囲だけ契約していただければ十分 です。

🟢 必須（最低限の運用に推奨）

API	用途	料金目安	取得先
SMTP（メール送信）	請求書PDFのメール送信	無料〜（既存のメール契約で使える）	お使いのメールプロバイダ（lolipop / Gmail / さくら等）の SMTP 設定情報

🟡 NAI内蔵のAI機能を使いたい方

💡 これらは Claude Desktop / Pro / Max とは別契約です。 Claude Desktop はあくまで「人間がチャットでClaudeと話すため」の契約で、 NAIが内部でAPIを呼ぶ機能（OCR等）は別途 API キーが必要です。

API	用途	料金目安	取得先
Google Gemini API	FAX伝票OCR・レシートOCR・経費自動分類（主力AI機能）	無料枠1日1,500リクエスト、超過時 ¥0〜500/月	https://aistudio.google.com
Anthropic Claude API	画面AIヘルプ・写真キャプション生成・名札テキスト分類の自動実行	月¥200〜1,000（使用量による）。未設定時はこれらAI機能はオフになります	https://console.anthropic.com
PhotoRoom	商品写真の背景除去・色調補正	月額有料プラン必須（透かし無しの商用利用には課金が必要、約月¥1,500〜）。Claude Desktopで代替不可	https://www.photoroom.com/api
Stability AI	AI背景生成（合成エディタ）	従量課金（数円/枚）。Claude Desktopで代替不可	https://platform.stability.ai

🔵 写真クラウド保存をしたい方

API	用途	料金目安	取得先
Google Drive API	撮影写真のクラウド保存	無料枠15GB、超過時月250円〜	Google Cloud Console

🟣 SNS自動投稿をしたい方

API	用途	料金目安	取得先
Google Business Profile API	Googleマップへの商品投稿	無料	Google Cloud Console
Instagram Graph API	Instagramへの商品投稿	無料	Meta for Developers

🟠 決済・配送連携をしたい方

API	用途	料金目安	取得先
STORES	請求書発行・カード決済	STORES契約に準ずる	STORES管理画面
佐川急便 e飛伝CSV	送り状CSV出力	e飛伝契約に準ずる	API不要（NAIからCSV出力）

⚪ その他（任意）

API	用途	料金目安	取得先
Google Places API	花店データベースの検索	無料枠大きめ	Google Cloud Console
GitHub Personal Access Token	NAIの修正提案を管理人へ送信	無料	https://github.com/settings/tokens

4. ハードウェア（必須ではないが推奨）

機器	用途	必須度
常時稼働できるPC	NAIサーバーとして24時間稼働	推奨（スマホアクセス用）
OKI C542 等のレーザープリンタ	札・領収証の印刷	札使用時
Tailscale 対応スマホ	外出先からのNAIアクセス	推奨
CTI対応PBX（Integra-F）	電話着信のポップアップ表示	任意

5. 設定の優先順位（おすすめの順番）

インストール直後
   ↓
①店舗情報登録（屋号・住所・電話・銀行口座）
   ↓
②SMTP設定（請求書メール送信）
   ↓
③Claude API設定（AIアシスタント有効化）
   ↓
④Tailscale設定（外出先・スマホアクセス）
   ↓
⑤PhotoRoom + Stability AI（写真加工が必要なら）
   ↓
⑥Google Drive（写真クラウド保存が必要なら）
   ↓
⑦SNS連携（Instagram/GBP投稿が必要なら）
   ↓
⑧STORES連携（カード決済導入なら）

設定画面の 🧙 設定ウィザード から、各項目の手順書を順番に開けます。

6. 月額コスト目安（標準的な利用パターン）

💡 まず大事な区別

「Claude Desktop / Pro / Max（人間がClaudeとチャット）」と「NAI内蔵のAI機能（NAIが裏側でAPIを呼ぶ）」は 別の支出 です。

すでに Claude Desktop + Pro/Max をお持ちであれば、 コード改造・運用相談・修正提案づくり はそのClaude Desktopで完結し、追加の支払いは不要です。

NAI内蔵のAI機能（OCR・レシート自動分類・画面内のAIヘルプ等）を使う場合のみ、 NAIに自分のAnthropic APIキーを入れる必要があり、その分だけ別途課金されます。

構成パターン別の月額目安

構成	月額目安	備考
最小構成（メール送信のみ・既存メール契約利用）	¥0	NAI標準機能は全部使える
+ Claude Desktop で改造・運用相談（既契約）	追加 ¥0	Pro/Max ですでに払われている
+ Gemini OCR（伝票OCR・レシートOCR・経費分類）	¥0〜500	無料枠1日1,500件、ほぼ無料
+ Anthropic AIヘルプ（画面チャット・写真キャプション）	+¥200〜1,000	使った分だけの従量課金。手作業なら Claude Desktop でも対応可
+ 写真背景除去・色調補正（PhotoRoom）	+¥1,500〜	透かし無しの商用利用は有料プラン必須
+ AI背景生成（Stability AI）	+ 数円/枚	使った分だけ
+ 写真クラウド保存（Drive容量超過時）	+¥250〜	15GBまで無料
+ SNS投稿（GBP / Instagram）	+¥0	API完全無料
+ STORES連携	STORES契約に準ずる	NAI側は無料

「Claude Desktop で全部カバーする派」のオプション

NAI内蔵のAI機能を使わず、すべてClaude Desktopに任せる選択もあります:

NAI機能	Claude Desktop での代替
伝票OCR	FAX画像をClaude Desktopに貼って「伝票入力して」と頼む
レシート分類	レシート画像を貼って「経費伝票にして」と頼む
画面のAIヘルプ	Claude Desktop に直接質問

この運用なら Anthropic API キーは不要、月額追加は ¥0。（ただし PhotoRoom と Stability AI は写真加工専用なので Claude Desktop で代替不可）

結論

お客様のタイプ	想定月額
Claude Desktopで全部やる派（写真加工も使わない）	¥0（既契約のPro/Maxのみ）
Gemini OCR（伝票・レシート）のみ	¥0〜500
Gemini OCR + Anthropic AIヘルプ	¥200〜1,500
+ 写真背景除去	¥1,700〜3,000
+ AI背景生成も追加	¥2,000〜4,000
大型店フル機能利用	¥4,000〜6,000

実際の使用量により変動します。Gemini・Anthropic・Stability AI は 使った分だけ の従量課金（無料枠あり）、PhotoRoom は 月額固定プラン です。

💡 重要な変更点（v1.x.x〜）

伝票OCR・レシートOCR・経費分類は Gemini 2.5 Flash で動作
Gemini は 1日1,500リクエストまで無料のため、ほとんどの花店で OCRはほぼ無料 で使えます
Anthropic は画面AIヘルプ・写真キャプション・名札解析など補助用途のみ

💡 PhotoRoom について重要

無料枠は試用目的のみ（生成画像にPhotoRoomの透かしが入るため、商用利用には不適）
商品写真として使うには 有料プラン契約が必要（月¥1,500程度から）
写真加工機能を使わないなら、契約不要

7. APIキーの管理

NAI内で扱うAPIキーは、設定画面 → APIキー に入力するだけで使えます。直接ファイルを編集する必要はありません。

配置場所	入力方法
`shop_info` テーブル（DB内）	設定画面の各入力欄に貼り付け → 保存
`.env` ファイル	上級者向け、通常は触らなくて構いません

APIキーの保管:

どのキーも 絶対に他人に教えない・SNSに貼らない でください
漏洩時は各サービスの管理画面で キーの再発行（取り消し＋新規発行） をしてください

まとめ — まずこれだけ準備すればスタートできます

インストーラー実行 → NAI本体・札レンダラー・SumatraPDF・自動更新の仕組みが入る
メール（SMTP）情報 → 既存のメールアカウントの送信設定情報をご用意
Claude API キー（任意） → AI機能を使うなら取得
Tailscale サインイン（任意） → スマホ・外出先で使うなら設定

これだけで業務を始められる状態になります。それ以外のAPIは必要になった時に順次追加していただければOKです。

困ったとき

設定画面 → 🧙 設定ウィザード → 各APIの取得手順書
設定画面 → 🤖 AIアシスタント（紫色のボタン）に質問
それでも分からない時は管理人までご連絡ください

何卒よろしくお願い申し上げます 🌸

Control-N'AI

🌸 ご挨拶