Odoo ↔ Claude MCPブリッジ — デプロイガイド

この小さなプロジェクトは、お使いのOdooインスタンス（via-italia.odoo.com）と Claudeを結びつけ、インターフェースをクリックすることなく、私がOdoo内のデータを直接読み書きできるようにします（在庫、請求書、顧客、督促状など）。

これはクラウドホスティングサービス（Render、最初は無料）上で継続的に稼働します。 Claudeは正式な認証（OAuth）を介して接続します。初回のみ、ログインページで秘密トークンの入力を求められます。以降は、シークレットがURLに表示されることなく、Claudeは自動的に接続されたままになります。

Gitコマンドラインは一切不要です。すべてブラウザ上で行います。

ステップ0 — 始める前に必要なもの

• Odoo APIキー：via-italia.odoo.comで生成します（自分の設定 → アカウントのセキュリティ → 新しいAPIキー）。これは保管しておき、ステップ3で貼り付けます。

• アクセスを保護するための秘密トークン。今すぐ生成してください（Renderとのみ共有し、他のどこにも共有しないでください）：

  • Macの場合：ターミナルを開き、openssl rand -hex 24 と入力し、結果をコピーします。

  • それ以外の場合：約40文字のランダムな文字列を生成できるパスワードジェネレーターで問題ありません。

Related MCP server: odoo-mcp-server

ステップ1 — これらのファイルをGitHubにアップロードする（Gitなし）

1. github.com にアクセスし、アカウントをお持ちでない場合は無料アカウントを作成します。

2. New repository をクリックします。名前：odoo-mcp-bridge（または任意の名前）。Public のままにします（アカウントを連携せずにRenderへデプロイするために必要）。他には何もチェックしないでください。Create repository をクリックします。

3. 新しい空のリポジトリのページで、uploading an existing file をクリックします。

4. このフォルダ内の6つのファイル（Dockerfile、proxy.py、oauth_provider.py、requirements.txt、start.sh、README.md）をアップロードエリアにドラッグ＆ドロップします。

5. Commit changes をクリックします。

https://github.com/あなたのアカウント名/odoo-mcp-bridge のような形式のリポジトリURLをメモしておきます。

ステップ2 — Renderでサービスを作成する

1. render.com にアクセスし、無料アカウントを作成します。

2. New + → Web Service を選択します。

3. Public Git Repository を選択し、ステップ1のGitHubリポジトリのURLを貼り付けます。Connect をクリックします。

4. サービス名：via-italia-odoo-mcp（または任意の名前）。

5. Renderは Dockerfile を自動的に検出します — Docker モードのままにします。

6. インスタンスタイプ：まずは Free（テストには十分です）。

ステップ3 — 環境変数

この作成ページで、Advanced → Add Environment Variable を展開し、以下を追加します：

（ODOO_DB は不要です。Odooが自動的に検出します。）

Create Web Service をクリックします。最初のデプロイには2〜3分かかります — ビルドログが流れるのが見えます。

ステップ4 — 動作確認

デプロイが "Live" と表示されたら、サービスには https://via-italia-odoo-mcp.onrender.com のようなアドレスが割り当てられます。

まずブラウザで https://via-italia-odoo-mcp.onrender.com/healthz をテストします：ok と表示されるはずです。

コネクタのアドレス（Claudeに渡すもの）は、単に次の通りです：

https://via-italia-odoo-mcp.onrender.com/mcp

このURLにはトークンは含まれていません — 安全に共有できます。保護は次のステップで行われます。

ステップ5 — Claudeを接続する

Claudeで：Customize → Connectors → "+" → Add custom connector を選択し、ステップ4のURLを貼り付け、Add をクリックし、次に Connecter をクリックします。

ログインページが開き、BRIDGE_SECRET（ステップ0で生成したトークン）の入力を求められます — 入力して確定します。以降、Claudeは接続されたままになります。サービスを再デプロイしない限り（メモリ内のセッションが消去されます）、再度行う必要はありません。

その後、Claudeとの会話に戻り、接続を確認するように依頼します（例：「最近のOdoo見積もりをリストアップして」）。

ステップ6 — 読み取り/書き込みに切り替える

読み取りが機能し、慣れてきたら、Render → サービス → Environment に戻り、ODOO_YOLO を read から true に変更し、再デプロイします（Renderは変数変更後に自動的に行います）。これでClaudeは請求書の作成、在庫の更新なども行えるようになります — Odooに実際に書き込む準備ができたときにのみ有効にしてください。

知っておくべき制限事項

• Renderの Free プランでは、15分間トラフィックがないとサービスがスリープします：一時停止後の最初のリクエストは、起動に30〜60秒かかります。よりスムーズな日常利用には、有料プラン（月額約7ドル）でこのスリープがなくなります。

• セッション（発行されたOAuthトークン）はサービスによってメモリに保持され、ディスクには保存されません：再デプロイや再起動で消去され、Claude側で「Connecter」をやり直す必要があります（BRIDGE_SECRET を再入力するだけです。それ以上は不要です）。