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

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

Odoo (MCP server) + Microsoft Copilot

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 — Microsoft Copilot にコネクタを追加

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

Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。

1. Copilot Studio でエージェントを開き（または新規作成し）、Tools で Add a tool → New tool → Model Context Protocol を選びます。
2. Server name（例: AnythingMCP）、コネクタでできることを説明する Server description、Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID を入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。
3. 認証で API key を選び、Type を Header、ヘッダー名を X-API-Key にして Create を選びます。
4. Add tool で Create a new connection を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
5. エージェントの Test ウィンドウで試します。Odoo (MCP server) のツールが必要になる依頼をしてみましょう。
6. Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。

ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。

セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。

利用可能なツール

プロンプトの例

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

FAQ

どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。

何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント（ライセンスまたは試用版）が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。

エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。

次のステップ

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