「売上が15%減」と
「8月はお盆」のあいだ。

go install github.com/na0fu3y/ochakai/cmd/ochakai@latest
ochakai use https://demo.ochak.ai
ochakai search "なぜ売上が落ちている?"   # 問いに効くものを並べる
ochakai get insights/reading-revenue  # 1 件を本文ごと返す

ブラウザでも読めます。下のコマンドを実行して http://127.0.0.1:8098 を開くとレビュー画面が出ます。

ochakai ui --url https://demo.ochak.ai

# 例は Apple Silicon の Mac。Intel Mac は darwin_amd64、Linux は linux_amd64 / linux_arm64、
# Windows は windows_amd64.zip に読み替える(すべて同じリリースページにある)
curl -LO https://github.com/na0fu3y/ochakai/releases/download/v0.27.5/ochakai_0.27.5_darwin_arm64.tar.gz
tar xzf ochakai_0.27.5_darwin_arm64.tar.gz
sudo mv ochakai /usr/local/bin/
ochakai use https://demo.ochak.ai
ochakai search "なぜ売上が落ちている?"

立てる Terraform 一式で Cloud Run + Cloud SQL を

git clone https://github.com/na0fu3y/ochakai && cd ochakai/deploy/terraform
cp terraform.tfvars.example terraform.tfvars   # project・region・invokers を書く
terraform init
terraform apply    # Cloud SQL の作成に 10〜15 分かかる

# 一度きりの手作業: スキーマの bootstrap(貼り付ける SQL は terraform output が出してくれる)
gcloud sql users set-password postgres --instance=ochakai --prompt-for-password
cloud-sql-proxy "$(terraform output -raw sql_connection_name)" --port 55432 &
psql "host=localhost port=55432 dbname=ochakai user=postgres"
# psql の中で「terraform output -raw database_bootstrap_sql」の出力を実行したら完了

terraform output -raw use_command   # チームに配る ochakai use コマンドを表示

Terraform を持ち込めないなら、同じものを gcloud だけで立てる経路がガイドにあります。

育てる 自分の知識を入れる

# 自分のテーブルの骨組みを投影する。ochakai がデータウェアハウスに触ることはない
# --max_rows は省けない。bq query は既定で先頭 100 行だけを出し、打ち切ったことを言わない
bq query --max_rows=100000 --format=json --nouse_legacy_sql \
  'SELECT table_schema, table_name, column_name, data_type, is_nullable, description
     FROM `your-project.your_dataset.INFORMATION_SCHEMA.COLUMNS`
    ORDER BY ordinal_position' \
  | ochakai seed - | ochakai import -

例は BigQuery です。seed が読むのは INFORMATION_SCHEMA.COLUMNS の列名を持つ JSON で、他のデータウェアハウスでも同じ列名で取り出せば同じように入ります。

取り込んだドキュメントはすべて draft として入ります。誰かが読み方を言い足してはじめて知識になります。範囲の絞り方、何をどの順で書くか、書いたものを検索が見つけられるかの確かめ方は、ガイド「最初のひと月」に。書いたものを腐らせずに保つ側は「育てて、回す」にまとめてあります。

claude mcp add ochakai -- ochakai mcp-stdio

{
  "mcpServers": {
    "ochakai": { "command": "ochakai", "args": ["mcp-stdio"] }
  }
}