Odoo için MCP Server

Claude gibi AI asistanlarının Odoo ERP sistemleriyle etkileşim kurmasını sağlayan bir MCP server'ı. İş verilerine erişin, kayıtları arayın, yeni girdiler oluşturun, mevcut verileri güncelleyin ve doğal dil aracılığıyla Odoo örneğinizi yönetin.

Herhangi bir Odoo örneğiyle çalışır! Hızlı test ve demolar için herhangi bir standart Odoo yüklemesiyle YOLO modunu kullanın. Kurumsal güvenlik, erişim kontrolleri ve üretim kullanımı için Odoo MCP modülünü kurun.

Özellikler

• 🔍 Arayın ve alın herhangi bir Odoo kaydını (müşteriler, ürünler, faturalar, vb.)
• ✨ Yeni kayıtlar oluşturun alan doğrulaması ve izin kontrolüyle
• ✏️ Mevcut verileri güncelleyin akıllı alan işlemeyle
• 🗑️ Kaydı silin model düzeyinde izinleri saygı göstererek
• 🔢 Kayıtları sayın belirli kriterleri karşılayan
• 📋 Model alanlarını inceleyin veri yapısını anlamak için
• 📊 Server tarafı toplama — ham satırları çekmeden gruplandırın, toplayın ve sayın
• ⚡ İş akışı eylemleri — opt-in kaçış tepesi aracılığıyla herhangi bir genel Odoo methodunu çağırın (faturayı gönder, SO'yu onayla, vb.)
• 🔐 Güvenli erişim API anahtarı veya kullanıcı adı/şifre doğrulaması ile
• 🎯 Akıllı sayfalandırma büyük veri kümeleri için
• 🧠 Akıllı alan seçimi — model başına en uygun alanları otomatik olarak seçer
• 💬 LLM'ye optimize edilmiş çıktı hiyerarşik metin biçimlendirmesiyle
• 🌍 Çok dilli destek — tercih ettiğiniz dilde yanıtlar alın
• 🚀 YOLO Modu herhangi bir Odoo örneğiyle hızlı erişim için (modül gerekli değil)

Kurulum

Ön Koşullar

• Python 3.10 veya daha yüksek
• Bir Odoo örneğine erişim:
  • Standart mod (üretim): Sürüm 16.0+ ve Odoo MCP modülü kurulu
  • YOLO modu (test/demolar): XML-RPC etkinleştirilmiş herhangi bir Odoo sürümü (modül gerekli değil)

Önce UV'yi Kurun

MCP server'ı yerel bilgisayarınızda (Claude Desktop'ın kurulu olduğu yerde) çalışır, Odoo sunucunuzda değil. Yerel makinenize UV kurmak gereklidir:

curl -LsSf https://astral.sh/uv/install.sh | sh

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Kurulumdan sonra, UV'nin PATH'inizde olduğundan emin olmak için terminalinizi yeniden başlatın.

MCP Ayarları Aracılığıyla Kurulum (Önerilir)

MCP ayarlarınıza bu yapılandırmayı ekleyin:

{
  "mcpServers": {
    "odoo": {
      "command": "uvx",
      "args": ["mcp-server-odoo"],
      "env": {
        "ODOO_URL": "https://your-odoo-instance.com",
        "ODOO_API_KEY": "your-api-key-here"
      }
    }
  }
}

{
  "mcpServers": {
    "odoo": {
      "command": "uvx",
      "args": ["mcp-server-odoo"],
      "env": {
        "ODOO_URL": "https://your-odoo-instance.com",
        "ODOO_API_KEY": "your-api-key-here",
        "ODOO_DB": "your-database-name"
      }
    }
  }
}

{
  "mcpServers": {
    "odoo": {
      "command": "uvx",
      "args": ["mcp-server-odoo"],
      "env": {
        "ODOO_URL": "https://your-odoo-instance.com",
        "ODOO_API_KEY": "your-api-key-here",
        "ODOO_DB": "your-database-name"
      }
    }
  }
}

claude mcp add odoo \
  --env ODOO_URL=https://your-odoo-instance.com \
  --env ODOO_API_KEY=your-api-key-here \
  --env ODOO_DB=your-database-name \
  -- uvx mcp-server-odoo

{
  "mcpServers": {
    "odoo": {
      "command": "uvx",
      "args": ["mcp-server-odoo"],
      "env": {
        "ODOO_URL": "https://your-odoo-instance.com",
        "ODOO_API_KEY": "your-api-key-here",
        "ODOO_DB": "your-database-name"
      }
    }
  }
}

{
  "servers": {
    "odoo": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-server-odoo"],
      "env": {
        "ODOO_URL": "https://your-odoo-instance.com",
        "ODOO_API_KEY": "your-api-key-here",
        "ODOO_DB": "your-database-name"
      }
    }
  }
}

{
  "mcpServers": {
    "odoo": {
      "command": "uvx",
      "args": ["mcp-server-odoo"],
      "env": {
        "ODOO_URL": "https://your-odoo-instance.com",
        "ODOO_API_KEY": "your-api-key-here",
        "ODOO_DB": "your-database-name"
      }
    }
  }
}

{
  "context_servers": {
    "odoo": {
      "command": {
        "path": "uvx",
        "args": ["mcp-server-odoo"],
        "env": {
          "ODOO_URL": "https://your-odoo-instance.com",
          "ODOO_API_KEY": "your-api-key-here",
          "ODOO_DB": "your-database-name"
        }
      }
    }
  }
}

Alternatif Kurulum Yöntemleri

{
  "mcpServers": {
    "odoo": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "ODOO_URL=http://host.docker.internal:8069",
        "-e", "ODOO_API_KEY=your-api-key-here",
        "ivnvxd/mcp-server-odoo"
      ]
    }
  }
}

docker run --rm -p 8000:8000 \
  -e ODOO_URL=http://host.docker.internal:8069 \
  -e ODOO_API_KEY=your-api-key-here \
  ivnvxd/mcp-server-odoo --transport streamable-http --host 0.0.0.0

# Global olarak kurun
pip install mcp-server-odoo

# Veya isolated ortam için pipx kullanın
pipx install mcp-server-odoo

git clone https://github.com/ivnvxd/mcp-server-odoo.git
cd mcp-server-odoo
pip install -e .

Yapılandırma

Çevre Değişkenleri

Server aşağıdaki çevre değişkenlerini gerektirir:

*ODOO_API_KEY veya hem ODOO_USER hem de ODOO_PASSWORD gereklidir.

Notlar:

• Sunucunuzda veritabanı listeleme kısıtlanmışsa ODOO_DB belirtmelisiniz
• API anahtarı doğrulaması daha iyi güvenlik için önerilir
• Server ayrıca çalışma dizinindeki .env dosyasından çevre değişkenlerini yükler

Gelişmiş Yapılandırma

Taşıma Seçenekleri

Server, farklı kullanım durumları için birden fazla taşıma protokolünü destekler:

1. stdio (Varsayılan)

Standart giriş/çıkış taşıması - Claude Desktop gibi masaüstü AI uygulamaları tarafından kullanılır.

# Varsayılan taşıma - ek yapılandırma gerekli değil
uvx mcp-server-odoo

2. streamable-http

REST API tarzı erişim ve uzaktan bağlantı için standart HTTP taşıması.

# HTTP taşıması ile çalıştırın
uvx mcp-server-odoo --transport streamable-http --host 0.0.0.0 --port 8000

# Veya çevre değişkenlerini kullanın
export ODOO_MCP_TRANSPORT=streamable-http
export ODOO_MCP_HOST=0.0.0.0
export ODOO_MCP_PORT=8000
uvx mcp-server-odoo

HTTP uç noktası şurada kullanılabilir: http://localhost:8000/mcp/

Not: SSE (Server-Sent Events) taşıması MCP protokol sürüm 2025-03-26'da kullanım dışı bırakılmıştır. HTTP tabanlı iletişim için streamable-http taşımasını kullanın. Uygun oturum yönetimi için MCP kitaplığı v1.9.4 veya daha yüksek gerekir.

{
  "mcpServers": {
    "odoo-remote": {
      "command": "uvx",
      "args": ["mcp-server-odoo", "--transport", "streamable-http", "--port", "8080"],
      "env": {
        "ODOO_URL": "https://your-odoo-instance.com",
        "ODOO_API_KEY": "your-api-key-here",
        "ODOO_DB": "your-database-name"
      }
    }
  }
}

Odoo'yu Ayarlama

1. MCP modülünü kurun:

   • mcp_server modülünü indirin
   • Odoo örneğinize kurun
   • Ayarlar > MCP Server'a gidin

2. MCP erişimi için modelleri etkinleştirin:

   • Ayarlar > MCP Server > Etkinleştirilen Modeller'e gidin
   • Erişmek istediğiniz modelleri ekleyin (örn. res.partner, product.product)
   • Model başına izinleri yapılandırın (oku, yaz, oluştur, sil)

3. API anahtarı oluşturun:

   • Ayarlar > Kullanıcılar & Şirketler > Kullanıcılar'a gidin
   • Kullanıcınızı seçin
   • "API Anahtarları" sekmesinde yeni bir anahtar oluşturun
   • MCP yapılandırmanız için anahtarı kopyalayın

YOLO Modu (Sadece Geliştirme/Test) ⚠️

YOLO modu, MCP server'ının MCP modülü gerektirmeden herhangi bir standart Odoo örneğine doğrudan bağlanmasını sağlar. Bu mod tüm MCP güvenlik kontrollerini atlayarak SADECE geliştirme, test ve demolar için tasarlanmıştır.

🚨 UYARI: YOLO modunu asla üretim ortamlarında kullanmayın!

YOLO Modu Seviyeleri

1. Salt Okunur Mod (ODOO_YOLO=read):

   • Tüm okuma işlemlerine izin verir (arama, oku, say)
   • Tüm yazma işlemlerini engeller (oluştur, güncelle, sil)
   • Demolar ve test için güvenlidir
   • Yanıtlarda "SALT OKUNUR" göstergeleri gösterir

2. Tam Erişim Modu (ODOO_YOLO=true):

   • Kısıtlama olmaksızın TÜM işlemlere izin verir
   • Tüm modellere tam CRUD erişimi
   • ÇOK TEHLİKELİ — sadece yalıtılmış ortamlarda kullanın
   • Yanıtlarda "TAM ERİŞİM" uyarıları gösterir

YOLO Modu Yapılandırması

{
  "mcpServers": {
    "odoo-demo": {
      "command": "uvx",
      "args": ["mcp-server-odoo"],
      "env": {
        "ODOO_URL": "http://localhost:8069",
        "ODOO_USER": "admin",
        "ODOO_PASSWORD": "admin",
        "ODOO_DB": "demo",
        "ODOO_YOLO": "read"
      }
    }
  }
}

{
  "mcpServers": {
    "odoo-test": {
      "command": "uvx",
      "args": ["mcp-server-odoo"],
      "env": {
        "ODOO_URL": "http://localhost:8069",
        "ODOO_USER": "admin",
        "ODOO_PASSWORD": "admin",
        "ODOO_DB": "test",
        "ODOO_YOLO": "true"
      }
    }
  }
}

YOLO Modunu Ne Zaman Kullanın

✅ Uygun Kullanımlar:

• Test verileriyle yerel geliştirme
• Hassas olmayan verilerle hızlı demolar
• MCP modülünü kurmadan önce MCP istemcilerini test etme
• Yalıtılmış ortamlarda prototip oluşturma

❌ Asla Kullanmayın:

• Üretim ortamlarında
• Gerçek müşteri verisi bulunan örneklerde
• Paylaşılan geliştirme sunucularında
• Hassas bilgiler bulunan herhangi bir ortamda

YOLO Modu Güvenlik Notları

• Odoo'nun standart XML-RPC uç noktalarına doğrudan bağlanır
• Tüm MCP erişim kontrollerini ve model kısıtlamalarını atlayır
• Hız sınırlandırması uygulanmaz
• Tüm işlemler kaydedilir ancak kısıtlanmaz
• Model listeleme etkinleştirilmiş olanlar yerine 200+ modeli gösterir

Kullanım Örnekleri

Yapılandırıldıktan sonra Claude'a şunları sorabilirsiniz:

Arama ve Alma:

• "İspanya'daki tüm müşterileri göster"
• "Stok 10 birimden az olan ürünleri bul"
• "Bugünün 1000 dolardan fazla satış siparişlerini listele"
• "Geçen aydan ödenmemiş faturaları ara"
• "Kaç aktif çalışanımız olduğunu say"
• "Microsoft için iletişim bilgilerini göster"

Oluştur ve Yönet:

• "Acme Corporation için yeni bir müşteri iletişimi oluştur"
• "'Premium Widget' adlı yeni bir ürün ekle, fiyatı 99,99 dolar"
• "Yarın saat 2 PM için bir takvim etkinliği oluştur"
• "John Doe müşterisinin telefon numarasını +1-555-0123 olarak güncelle"
• "SO/2024/001 siparişinin durumunu onaylı olarak değiştir"
• "Daha önce oluşturduğumuz test iletişisini sil"

Mevcut Araçlar

search_records

Herhangi bir Odoo modelinde filtrelerle kayıt arayın.

{
  "model": "res.partner",
  "domain": [["is_company", "=", true], ["country_id.code", "=", "ES"]],
  "fields": ["name", "email", "phone"],
  "limit": 10
}

Alan Seçim Seçenekleri:

• fields atlanır veya null olarak ayarlanır: Yaygın alanların akıllı seçimini döndürür
• Alan listesi belirt: Sadece o belirli alanları döndürür
• ["__all__"] kullan: Tüm alanları döndürür (dikkatli kullanın)

get_record

ID'ye göre belirli bir kaydı alın.

{
  "model": "res.partner",
  "record_id": 42,
  "fields": ["name", "email", "street", "city"]
}

Alan Seçim Seçenekleri:

• fields atlanır veya null olarak ayarlanır: Meta veri ile yaygın alanların akıllı seçimini döndürür
• Alan listesi belirt: Sadece o belirli alanları döndürür
• ["__all__"] kullan: Tüm alanları meta veri olmaksızın döndürür

list_models

MCP erişimi için etkinleştirilmiş tüm modelleri listeleyin.

{}

list_resource_templates

Mevcut kaynak URI şablonlarını ve bunların desenlerini listeleyin.

{}

create_record

Odoo'da yeni bir kayıt oluşturun.

{
  "model": "res.partner",
  "values": {
    "name": "New Customer",
    "email": "customer@example.com",
    "is_company": true
  }
}

update_record

Mevcut bir kaydı güncelleyin.

{
  "model": "res.partner",
  "record_id": 42,
  "values": {
    "phone": "+1234567890",
    "website": "https://example.com"
  }
}

delete_record

Odoo'dan bir kaydı silin.

{
  "model": "res.partner",
  "record_id": 42
}

post_message

Bir kaydın chatter'ına mesaj gönder (mail.thread). subtype="note" (varsayılan) dahili logtur; subtype="comment" takipçileri bilgilendirir. HTML işaretlemesi için body_is_html=true ayarlayın. İsteğe bağlı partner_ids ve attachment_ids mevcut ortakları ve ekleri referans alır.

{
  "model": "res.partner",
  "record_id": 42,
  "body": "Called customer, will follow up Tuesday"
}

{
  "model": "sale.order",
  "record_id": 17,
  "body": "<p>Shipping confirmed for Monday</p>",
  "subtype": "comment",
  "body_is_html": true
}

aggregate_records

Server tarafı toplama. Soru "listesi" yerine "toplamlar/sayımlar/gruplandırmalar" olduğunda bunu kullanın — çalışmayı raw satırları çekmek yerine PostgreSQL'e iter. Odoo 19+ üzerinde formatted_read_group'a gönderir (yeni adanmış method) ve eski sürümlerde yanıt normalizasyonu ile read_group'a geri döner. Arayanlar, desteklenen her sürümde tutarlı bir yanıt şekli görürler. aggregates atlanırsa, varsayılan olarak ["__count"] olur, böylece her grup her zaman bir sayım taşır.

{
  "model": "sale.order",
  "groupby": ["date_order:month"],
  "aggregates": ["amount_total:sum"],
  "domain": [["state", "in", ["sale", "done"]]]
}

{
  "model": "res.partner",
  "groupby": ["country_id"]
}

call_model_method

Genel XML-RPC execute_kw kaçış tepesi — CRUD tarafından kapsanmayan iş akışı eylemleri için (faturayı gönder, satış siparişini onayla, toplama doğrula, vb.) herhangi bir genel methodunu herhangi bir modelde çağırır. Sadece ODOO_YOLO=true (tam YOLO) ve ODOO_MCP_ENABLE_METHOD_CALLS=true her ikisi de ayarlandığında kullanılabilir; aksi takdirde araç kaydedilmez. Yalnızca genel ASCII Python tanımlayıcıları method adları olarak kabul edilir