ood.ooo

Troubleshooting guide

Fix common issues fast. Find step-by-step solutions for connection errors, discovery problems, chat failures, and API key issues.

Quick diagnostics checklist

Verify system health in 6 simple checks

  • Can you log into the platform?
  • Can you access Configuration page?
  • Does "Test connection" work for Odoo?
  • Does "Test connection" work for AI provider?
  • Can you send a simple chat message?
  • Does the chat response arrive within 30 seconds?

If all checked: System working normally. If any unchecked: See specific issue below.

Connection issues

Resolve Odoo connection errors and authentication failures

Failed to connect to Odoo

Symptoms:

Connection error: Failed to connect to Odoo instance
Error: ECONNREFUSED or Timeout

Solutions:

  1. Wrong URL format
    Incorrect: odoo.example.com
    Incorrect: www.odoo.example.com
    Correct: https://odoo.example.com
    Correct: https://mycompany.odoo.com
  2. Firewall or network block: Check if your Odoo URL is accessible from your browser
  3. Incorrect database name: Use only the database name, not the full domain

Authentication failed

Solutions:

  • Verify credentials by logging into Odoo web interface
  • Odoo 19: Use API key | Odoo 16-18: Use password
  • Ensure user has "Administration / Settings" access
  • If 2FA enabled: Must use API key, not password

Discovery issues

Fix stuck progress, missing data, and completion errors

Discovery stuck at 0%

Solutions:

  1. Check MCP server status in Configuration → System Status
  2. Ensure Odoo user has "Internal User" or higher access level
  3. Keep browser tab active during discovery
  4. Try: Cancel discovery → Wait 30 seconds → Run again

Discovery failed - phase X error

This is normal!

Discovery skips phases for modules that aren't installed. Check which phases succeeded (example: 6/9 completed, 3/9 skipped).

Discovery token cost too high

If discovery uses 95,000 tokens instead of expected ~30,000:

  • This is normal for content-rich instances (100+ knowledge articles, 50+ website pages)
  • Optimization: Run discovery less frequently (quarterly vs monthly)
  • Use shared instances for teams (90% savings)

Chat issues

Troubleshoot AI responses and tool execution failures

AI not responding

Solutions:

  1. Check AI API key: Configuration → AI Settings → Test connection
  2. Check browser console (F12) for network errors
  3. Refresh page (F5) or log out and back in

Tool execution failed

Error: AccessError: You don't have access to this record

Solution: Add access rights in Odoo → Settings → Users → Your User → Access Rights

Response too generic

Cause: Discovery not run yet

Solution: Run deep discovery from Configuration → Odoo Configuration

AI hallucinates data

If AI invents product names or references non-existent customers:

  • Run discovery first - AI will reference real data from your instance
  • Be more specific in prompts: "Use execute_method to search for products matching 'laptop'"

API key issues

Fix invalid keys and authentication errors for Claude API

Invalid API key

Check your Anthropic API key:

  • Correct format: sk-ant-api03-xxxxx...
  • Generate new key: console.anthropic.com
  • Check your billing status and ensure you have credits available

Rate limit exceeded

Error: Rate limit reached
Status: 429 Too Many Requests

Solutions:

  1. Wait 1 minute - rate limits reset automatically
  2. Contact AI provider to increase limits
  3. Don't spam messages rapidly

Performance issues

Optimize slow responses and reduce token costs

Chat responses slow

Normal response times:

  • Without tools: 2-5 seconds
  • With 1-2 tools: 5-15 seconds
  • With 3+ tools: 15-30 seconds
  • Discovery active: 3-8 seconds (faster!)

If slower:

  • Check network speed
  • Check status.anthropic.com or status.openai.com
  • Add limits to prompts: "Show top 10 products" instead of "Show all products"

Browser memory warning

Cause: Long chat history (100+ messages)

Solutions:

  • Start new chat (previous chat saved automatically)
  • Clear browser cache (keep cookies)
  • Use incognito/private mode

Getting help

Contact support for issues not covered here

Contact support

Email: support@bob.ood.ooo

Include: Error message, steps to reproduce, screenshots, browser and version

Response time: 24-48 hours

Before contacting support

  1. What were you trying to do?
  2. What happened instead?
  3. Error message (exact text or screenshot)
  4. Browser and version
  5. Steps to reproduce
  6. When did it start happening?