Claude Terminal — BL Consulting

› How it works

1. Authenticate

The terminal authenticates via your Odoo API Key. Generate one in Odoo: Settings → Users → API Keys. Each session is validated against your Odoo instance.

2. Personal workspace

Each user gets an isolated directory with their own Claude config, MCP connections, and workspace. Your data is private and persistent between sessions.

3. MCP connected

Claude auto-connects to the MCP server and loads shared knowledge base (modules, guides, configurations). Full Odoo CRUD, reports, fiscal positions — 60+ tools.

› URL Parameters

argAPI_KEYYour Odoo API key (required)

argODOO_URLOdoo instance URL (required)

argODOO_DBDatabase name (required)

argODOO_USERUsername / login (default: admin)

argODOO_MODELCurrent model context (optional)

argODOO_RES_IDCurrent record ID (optional)

Quick Start

Generate an API key in your Odoo instance: Settings → Users → API Keys
Open the terminal with your credentials:

https://terminal.odoo-shell.space/?arg=API_KEY=your_key&arg=ODOO_URL=https://your-odoo.com&arg=ODOO_DB=your_db&arg=ODOO_USER=admin

Claude will authenticate, create your workspace, and connect to the MCP server
Shared knowledge base is pulled automatically on first login
Use claude login if you need to authenticate Claude Code separately

From Odoo (recommended)

Install the l10n_bg_claude_terminal module
Go to Settings → Preferences → Claude Terminal
Set the Terminal URL to this server
Check “Use External Terminal”
Enter your API Key
Click the AI button in any list/kanban view, or Claude in the chatter

› Features

Odoo ERP

40+ tools: CRUD operations, reports, fiscal positions, search, execute methods. Full XML-RPC & JSON-RPC support.

Bulgarian Localization

54+ modules knowledge base: VAT protocols, customs declarations, payroll, NRA API, tax computation, EKATTE cities.

Integrations

Google Calendar & Gmail, Telegram messaging, SSH remote execution, Git operations, Portainer Docker management.

Multi-user

Per-user isolated workspace with persistent config. Shared memory for team knowledge. identify() + memory_pull("*") on startup.