MCP 経由で Odoo (MCP server) を Cursor に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Odoo (MCP server) をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Odoo (MCP server) + Cursor

Odoo 自身の MCP サーバー（Odoo AI、Odoo Online saas-19.4 と Odoo 20）を通じて Claude、ChatGPT、Copilot を Odoo に接続します。任意のモデルの検索、レコードのグループ化と集計、モデルとフィールドの一覧表示ができ、管理者が許可すればレコードの作成と更新も行えます。操作範囲は Odoo ユーザーと、管理者が公開する AI Tools によって決まります。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

ODOO_URL, ODOO_MCP_API_KEY

ステップ 1 — 認証情報を取得

セットアップは約 5 分です。Odoo 自身の MCP サーバーを備えた Odoo データベースが必要です。対象は saas-19.4 以降の Odoo Online、または Odoo 20 で、AI アプリがインストールされている必要があります。バージョンは Settings の一番下に表示され、MCP サーバーのあるデータベースでは API キーの作成時に MCP スコープを選べます。

1. Odoo で自分のアバターをクリックし、My Preferences（または My Profile）→ Security → Add API Key を開きます。パスワードを確認し、キーに名前を付けます。
2. Scope を MCP にし、Expires で有効期間を選びます。キーは一度しか表示されないので、すぐにコピーしてください。アシスタントに見せてよい範囲のアクセス権を持つ専用の Odoo ユーザーで作成します。キーはそのユーザーとして動作します。
3. キーを ODOO_MCP_API_KEY に貼り付けます。40 文字の小文字の 16 進数で、Bearer という語は付けません。
4. ODOO_URL には、Odoo を開くときのアドレスをホスト名まで入力します（例: https://mycompany.odoo.com）。/odoo、/web、/mcp と末尾のスラッシュは付けません。/mcp はコネクターが自動で付け加えます。
5. コネクターをインストールし、odoo_mcp_ai_tool_mcp_retrieve_initial_context を実行します。ログイン中のユーザー、タイムゾーン、現在の会社、切り替え可能なすべての会社が表示されます。

どの Odoo コネクターを使うか: このコネクターは Odoo 自身の MCP サーバーを持つデータベース向けで、どのツールを使えるか、どの変更を許可するかは Odoo の管理者が決めます。Odoo 19.0（MCP サーバーがありません）、MCP サーバーのない Odoo.sh や自社サーバー、またはパートナー、販売オーダー、請求書、製品向けの固定ツールを使いたい場合は、Odoo コネクター（JSON-2 API、Odoo 19 以降）を使います。Odoo 14 から 18 には Odoo 14-18 (JSON-RPC) を使います。

ツールはデータベースから提供されます: インストール時に AnythingMCP が Odoo の MCP サーバーに公開ツールを問い合わせます。標準では Get Models、Get Fields、Search、Read group、MCP Retrieve initial context の 5 つで、すべて読み取り専用です。Odoo はこれらをキーの所有ユーザーの権限で実行します。管理者は開発者モードの Settings → Technical → Server Actions で、ツールの Usage タブにある Available in MCP にチェックを入れると、Create Records、Update Records、メニュー、Web サイト、画像のツールなどを追加で公開できます。その後、ここでコネクターを開いて Discover tools をクリックします。画像生成は Odoo AI のクレジットを消費します。

読み取れるデータ: Odoo ユーザーが開けるあらゆるモデル（連絡先、販売オーダー、請求書、製品など）です。odoo_mcp_ai_tool_get_models で目的のモデルを探し、odoo_mcp_ai_tool_get_fields でフィールドを一覧し、odoo_mcp_ai_tool_search で Odoo のドメインを使ってレコードを検索し、odoo_mcp_ai_tool_read_group で日、週、月、四半期、年ごとにグループ化して集計します。月別の売上、顧客別の請求書、ステージ別のリードなどです。

変更の前に必ず確認: インストール時点では書き込みツールは 1 つも有効になっていません。管理者がレコードの作成や更新を有効にした後は、AI が対象のレコードと正確な値を示し、あなたの承認を待ってから書き込みます。

インストール時はオフ: odoo_mcp_ai_tool_create_records と odoo_mcp_ai_tool_update_records。Odoo では管理者が MCP に公開するまで非表示で、ここでもオフの状態でインストールされます。レコードを作成したり、ドメインに一致するすべてのレコードの値を変更したりするためです。アシスタントに Odoo を変更させる場合にだけ、ツールごとに有効にしてください。

制限: Search は標準で 50 件、1 回の呼び出しで最大 200 件を返します。そのため AI は大きな結果をページ送りで読み、合計には Read group を使い、何千行も取得することはしません。API キーは Expires で選んだ日に失効するので、その際は新しいキーを作成して貼り付けてください。

よくあるエラー: 401 は、キーが間違っている、期限切れ、または MCP スコープなしで作成されたことを示します。/mcp での 404 は、データベースに MCP サーバーがないこと（saas-19.4 より古い、または AI アプリが未インストール）を示します。その場合は Odoo または Odoo 14-18 (JSON-RPC) コネクターを使ってください。Odoo は Get Fields をパラメーターなしで公開していますが、model_name と include_description がないと失敗するため、AI は常に両方を渡します。

このコネクターは、Odoo が公開していないツールを追加すること、キーの背後にある Odoo ユーザーのアクセス権を超えること、Odoo の MCP サーバーがないデータベースで動作することはありません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Cursor にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう。エージェントが Odoo (MCP server) のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「今年の確定済み販売オーダーの売上を月別に教えてください。各月の合計をお願いします。」
• 「支払期限を過ぎた未払いの請求書がある顧客と、それぞれの未払い額を教えてください。」
• 「連絡先の山田建設を探して、メールアドレス、電話番号、担当営業を見せてください。」
• 「前四半期に数量ベースで最も多く売れた製品トップ 10 は何ですか。」
• 「連絡先の佐藤花子のメールアドレスを [email protected] に変更してください。更新する前にレコードを見せてください。」

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続