# MCP 経由で Claude Code をライブな Odoo に接続する方法

Published: 2026-08-27
Last updated: 2026-08-27
Canonical: https://erpipe.com/ja/guides/connect-claude-code-to-odoo
MCP endpoint: https://mcp.erpipe.com/mcp

## まず結論から

ERPipe をユーザースコープのリモート HTTP サーバーとして追加し、Claude Code のブラウザ OAuth フローを完了し、保存された接続を確認します:

```text
claude mcp add --transport http --scope user erpipe https://mcp.erpipe.com/mcp
claude mcp login erpipe
claude mcp get erpipe
```

読み取りアクセスから始めてください。Odoo のパスワード、ダッシュボードのクッキー、ベアラートークン、静的な認可ヘッダーを Claude Code に貼り付けないでください。ERPipe は Odoo のクレデンシャルをワークスペース接続の背後に保持し、Claude には統制された MCP ツール経路を与えます。

## 前提条件

- シェルレベルの `claude mcp login` コマンドのために、Claude Code 2.1.186 以降。
- 到達可能な HTTPS の Odoo 接続を 1 つ持つ [ERPipe ワークスペース](/app/login)。
- Claude が扱えるべき作業に一致するグループとレコードルールを持つ、専用の Odoo ユーザー。
- OAuth 同意のためのブラウザ、またはヘッドレスフローのための対話型 SSH ターミナル。

## 手順

1. **リモートサーバーを追加します。** `claude mcp add --transport http --scope user erpipe https://mcp.erpipe.com/mcp` を実行します。HTTP はリモート MCP サーバーに対して Claude Code が推奨するトランスポートです。
2. **認証します。** `claude mcp login erpipe` を実行します。ブラウザで ERPipe ワークスペースの同意を完了します。最初の接続では書き込みアクセスを許可しないままにします。
3. **結果を確認します。** `claude mcp get erpipe` を実行するか、Claude Code 内で `/mcp` を開きます。サーバーにはカノニカル URL と接続済みの状態が表示されるはずです。
4. **Odoo インスタンスを選択します。** サインイン中のワークスペースで利用可能なインスタンスの一覧を Claude に依頼し、明示的なインスタンスキーを 1 つ指定して使用します。デフォルトのデータベースを推測させないでください。
5. **読み取り専用のチェックを 1 回実行します。** 接続の状態を確認し、小さく既知のレコードセットを検索します。タスクを広げる前に、結果を Odoo と比較してください。

完全なマルチクライアント設定の契約と、コピーして使えるエージェントプロンプトは、[コネクタページ](/docs/connector) にあります。

## ユーザースコープかプロジェクトスコープか

上記のコマンドは `--scope user` を使用します。これはローカルユーザーのためのプライベートな、プロジェクト横断のサーバーエントリを保存します。同じオペレーターが複数のリポジトリから ERPipe を使う場合の、よりシンプルなデフォルトです。

`--scope project` は、エンドポイント設定をチーム向けにリポジトリの `.mcp.json` に置くべき場合のみ使用してください。Claude Code はプロジェクトスコープのサーバーについて信頼と承認を求めます。コミットするのはエンドポイントのみであり、クレデンシャルやトークンをコミットしてはいけません。

## ヘッドレスまたは SSH ログイン

Claude Code がローカルブラウザを開けない場合は、次を実行します:

```text
claude mcp login erpipe --no-browser
```

表示された認可 URL をローカルマシンで開き、同意を完了し、その後リダイレクト URL 全体を対話型ターミナルに貼り戻します。Claude Code の公式ガイダンスは、その貼り付けステップを受け取れるターミナルを要求するため、対話型の SSH セッションを使用してください。

## 期待される結果

`claude mcp get erpipe` は、`https://mcp.erpipe.com/mcp` のリモート HTTP サーバーを識別し、OAuth 後に接続済みと報告するはずです。Claude Code 内の `/mcp` には、サーバーとその利用可能なツールが一覧表示されます。

接続は無制限の Odoo アクセスを意味しません。Odoo の ACL は常に正（オーソリティ）であり、Odoo 宛のすべての操作は明示的なインスタンスキーを使用し、ワークスペースオーナーが有効化するまで書き込みはオフのままです。

## 安全な最初のプロンプト

- このワークスペースで利用可能な Odoo インスタンスを一覧表示してください。暗黙的に 1 つを選ばないでください。
- 私が選択したインスタンス上で接続を検証し、参照できる Odoo バージョンと会社コンテキストを教えてください。
- Acme の未処理の顧客請求書を最大 10 件見つけてください。読み取りのみ。書き込みの準備や実行はしないでください。
- 構造化ドメインを構築する前に、依拠するモデルファクトを表示してください。

## トラブルシューティング

- **「Server already exists」と表示される。** `claude mcp get erpipe` で確認してください。すでにカノニカルエンドポイントを指しているなら、そのまま使い、重複を作成しないでください。
- **認証が必要。** `claude mcp login erpipe` を実行するか、`/mcp` を開いて ERPipe を選択し、ブラウザフローに従ってください。
- **ブラウザが開かない。** 対話型ターミナルで `claude mcp login erpipe --no-browser` を使用してください。
- **プロジェクトサーバーが承認待ち。** リポジトリで Claude Code を起動し、ワークスペースを信頼し、`.mcp.json` のサーバーを承認してください。ユーザースコープのセットアップにコミットされたプロジェクトエントリは不要です。
- **Odoo インスタンスが表示されない。** ERPipe ダッシュボードにサインインし、接続が有効でライブプローブが成功していることを確認してください。
- **Odoo のアクセスエラーが出る。** Odoo 側で専用ユーザーのグループまたはレコードルールを修正してください。ACL の問題を隠すためにゲートウェイのポリシーを広げないでください。
- **書き込みが利用できないまま。** 読み取り専用グラントではこれは想定内です。オーナーがターゲットの接続で明示的に書き込みを有効化し、同意時に書き込みアクセスを許可する必要があります。

## 証拠と限界

上記の 3 つのコマンドは、2026-08-27 にインストール済みの Claude Code 2.1.235 で構文チェックされ、Anthropic の最新の MCP ドキュメントと突き合わせました。このローカルのコンテンツ確認では、新規の ERPipe OAuth エンドツーエンドログインは実施していないため、このガイドは OAuth 検証済みではなく構文チェック済みとして位置づけられています。

ベンダーリファレンス: [Claude Code — Connect to tools via MCP](https://code.claude.com/docs/en/mcp)。

## FAQ

- **ローカルの Odoo MCP プロセスは必要ですか？** いいえ。Claude Code は ERPipe のリモート HTTP エンドポイントに接続し、ERPipe がワークスペースに登録された Odoo インスタンスに接続します。
- **Authorization ヘッダーを追加すべきですか？** いいえ。Claude Code のネイティブ OAuth フローを使用してください。静的ヘッダーは 2 つ目のクレデンシャル経路を作り、OAuth フォールバックを妨げることがあります。
- **なぜユーザースコープを使うのですか？** ローカルのプロジェクト横断で 1 つのプライベートな ERPipe エントリを利用可能にするためです。チームでエンドポイント設定を共有すべき場合にのみプロジェクトスコープを使用してください。
- **SSH 経由でも使えますか？** はい。`--no-browser` を使用し、URL をローカルで開き、リダイレクト URL を対話型 SSH ターミナルに貼り戻してください。
- **Claude は Odoo のパスワードを受け取りますか？** いいえ。Odoo のクレデンシャルは ERPipe のワークスペース接続上に留まります。Claude が受け取るのはワークスペースに紐付いた OAuth グラントです。
- **ログイン直後に Claude は書き込めますか？** いいえ。最初のグラントは読み取り専用にすべきです。書き込みにはオーナーによる設定と書き込み同意の両方が必要で、その後もオーナー承認を待つ場合があります。

## 関連

- [Odoo MCP サーバーとは何か？](/guides/what-is-odoo-mcp)
- [ローカルプロセス、ネイティブアドオン、リモートゲートウェイのどれにするか？](/guides/odoo-mcp-server-architecture)
- [AI による書き込みに Odoo の ACL だけでは不十分な理由](/guides/human-approval-odoo-ai-writes)
- [すべてのクライアントレシピ](/docs/connector)
- [ホステッドツールカタログ](/tools)