Aidoo for Odoo

aidoo-mcp

Aidoo を通じて、あらゆる MCP クライアントを Odoo ERP に接続します。

aidoo-mcp は小規模な stdio ブリッジです。Aidoo API キーを受け取り、ホスト型 Aidoo MCP サーバーとの認証済みセッションを開いて、Model Context Protocol のメッセージを双方向に中継します。アシスタントはキーに付与された権限の範囲内で、自然な言葉を使って Odoo のレコードを検索、作成、更新できます。

ブリッジが必要な理由

Aidoo MCP サーバーは https://mcp.aidoo.ai でホストされており、OAuth またはカスタムヘッダーを使ったリモートコネクターに対応しているクライアントは、何もインストールせずに直接接続できます。多くの MCP クライアントは今も stdio のみに対応しているか、Authorization ヘッダーを設定する方法がありません。このブリッジがそのギャップを埋めます。コマンドは 1 つで、ローカルサーバーも必要なく、お使いのマシンに Odoo の認証情報を置く必要もありません。

MCP client  <--stdio-->  aidoo-mcp  <--HTTPS-->  Aidoo  <--XML-RPC-->  Odoo

このブリッジは透過的に動作します。ペイロードを書き換えることはないため、Aidoo からツールがリリースされると、更新しなくてもワークスペースで公開されているすべてのツールを利用できます。

必要要件

• Python 3.10 以降（または Node.js 18 以降。下記の Node ビルドを参照）
• Odoo 接続が設定された Aidoo アカウント
• ワークスペースの API キーページで作成した、aid_live_ で始まる Aidoo API キー

インストール

uv を使えば、何もインストールせずに実行できます。

uvx aidoo-mcp --check

または、インストールして実行します。

pipx install aidoo-mcp
# or
pip install aidoo-mcp

Python より Node を使いたい場合は、npm/ ディレクトリに、Python に依存しない npx 用の同じブリッジが用意されています。

npx aidoo-mcp --check

セットアップの確認

export AIDOO_API_KEY=aid_live_your_key_here
aidoo-mcp --check

このコマンドはエンドポイントから応答があることを確認し、MCP ハンドシェイクを実行して、キーで利用できるツールを表示します。

[aidoo-mcp] https://mcp.aidoo.ai/health is reachable
[aidoo-mcp] authenticated with https://mcp.aidoo.ai/mcp (transport=http, key=aid_live_...cdef)
[aidoo-mcp] 8 tools available: aidoo_context, aidoo_create, aidoo_print, aidoo_query, ...

クライアントの設定

Claude Desktop

macOS では ~/Library/Application Support/Claude/claude_desktop_config.json、Windows では %APPDATA%\Claude\claude_desktop_config.json：

{
  "mcpServers": {
    "aidoo": {
      "command": "uvx",
      "args": ["aidoo-mcp"],
      "env": { "AIDOO_API_KEY": "aid_live_your_key_here" }
    }
  }
}

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "aidoo": {
      "command": "uvx",
      "args": ["aidoo-mcp"],
      "env": { "AIDOO_API_KEY": "aid_live_your_key_here" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json。Cursor と同じブロックを使用します。

VS Code

ワークスペース内の .vscode/mcp.json：

{
  "servers": {
    "aidoo": {
      "type": "stdio",
      "command": "uvx",
      "args": ["aidoo-mcp"],
      "env": { "AIDOO_API_KEY": "aid_live_your_key_here" }
    }
  }
}

その他の stdio クライアント

aidoo-mcp 実行可能ファイルを指定し、環境変数でキーを渡します。クライアントで環境変数を設定できない場合は、代わりにフラグを使用してください。

aidoo-mcp --api-key aid_live_your_key_here

Cursor、Windsurf、およびカスタムヘッダーに対応しているクライアントでは、ブリッジを使わずに https://mcp.aidoo.ai/sse を Authorization ヘッダー付きで直接指定することもできます。Aidoo のドキュメントを参照してください。

使い方

aidoo-mcp [--api-key KEY] [--url URL] [--transport {http,sse}]
          [--timeout SECONDS] [--retries N] [--check] [--quiet]

オプション	環境変数	デフォルト
--api-key	AIDOO_API_KEY	必須
--url	AIDOO_MCP_URL	https://mcp.aidoo.ai/mcp
--transport	AIDOO_MCP_TRANSPORT	URL パスから推定
--timeout	AIDOO_MCP_TIMEOUT	60
--retries		3

ログは stderr に出力されるため、stdout 上のプロトコルストリームに干渉しません。終了コード 2 は設定の問題、1 は接続を確立できなかったことを示します。

アシスタントへの依頼

List the five quotations I sent last week that are still pending.
Create a contact for Martin Dupont at Dupont SA, [email protected].
Generate the PDF of invoice INV/2026/0042.

セキュリティ

• キーは環境変数またはコマンドラインから読み取られ、HTTPS 経由でベアラートークンとして送信されます。すべてのログ行でマスクされます。
• Odoo の認証情報は Aidoo に保持されます。ブリッジがそれらを参照することはなく、Odoo と通信することもありません。
• キーごとに異なる権限が付与され、各呼び出しはリンクされたユーザーの Odoo アクセスルールに従って実行されます。アシスタントに必要な権限のみを付与してください。
• 共有キーは使わず、ユーザーごとにキーを 1 つ発行してください。不審な点がある場合は、ダッシュボードからキーを失効させてください。
• 脆弱性は非公開で報告してください。SECURITY.mdを参照してください。

トラブルシューティング

No API key found AIDOO_API_KEY 変数がプロセスに渡されていません。クライアントの設定ファイルはシェルのプロファイルを無視することが多いため、上記の env ブロックでキーを設定してください。

ハンドシェイクが 401 で失敗する キーが失効しているか、MCP の権限が無効になっています。ワークスペースの API キーのページで確認してください。

ツール一覧が想定より少ない ツールにはキーの権限が適用されます。不足している権限を付与してから、クライアントを再起動してください。

クライアントで何も起きない 設定を編集した後、クライアントを完全に再起動してから、MCP のログを確認してください。aidoo-mcp --check を実行すると、問題がこちら側とお客様側のどちらにあるかを数秒で確認できます。

社内ネットワークによって接続がブロックされる ブリッジには、mcp.aidoo.ai のポート 443 へのアウトバウンド HTTPS 接続が必要です。中間プロキシがストリーミング可能な HTTP を正しく処理できない場合は、--transport sse をお試しください。

開発

uv sync
uv run pytest
uv run ruff check .
uv run ruff format --check .

ライセンス

MIT。LICENSE を参照してください。