# DevChef MCP Tool Reference

Verbindung: `http://localhost:8099/mcp/sse`

## Telemetrie Tools

### devchef_projects
Alle aktiven Projekte mit Entry-Count und letztem Timestamp.

```json
{}
```

---

### devchef_read
Entries lesen mit optionalen Filtern.

```json
{
  "project": "my-app",
  "source":  "error",
  "level":   "error",
  "search":  "TypeError",
  "last_n":  50
}
```

`source`: `console` | `error` | `network` | `perf` | `system` | `feedback`
`level`: `log` | `info` | `warn` | `error`

---

### devchef_errors
Nur Error-Entries mit Stack Traces.

```json
{ "project": "my-app", "last_n": 20 }
```

---

### devchef_network
Fetch/XHR Log mit Status und Duration.

```json
{ "project": "my-app", "last_n": 30 }
```

---

### devchef_stats
Counts by Source und Level.

```json
{ "project": "my-app" }
```

**Response:**
```json
{
  "project": "my-app",
  "total": 142,
  "bySource": { "console": 80, "network": 40, "error": 22 },
  "byLevel":  { "log": 60, "info": 50, "warn": 20, "error": 12 }
}
```

---

## Odoo Tools

### devchef_odoo_projects
Odoo-Projekte auflisten.

```json
{}
```

---

### devchef_odoo_stages
Stages eines Projekts.

```json
{ "project_id": 5 }
```

---

### devchef_odoo_triage
Errors gruppieren, Dedup-Check, Backlog-Vorschlag.

```json
{ "project": "my-app", "last_n": 50 }
```

**Response:**
```json
{
  "unique_errors": 8,
  "new_for_odoo": 3,
  "groups": [
    {
      "fingerprint": "a1b2c3d4e5f60001",
      "count": 12,
      "exists_in_odoo": false,
      "example": { ... }
    }
  ]
}
```

---

### devchef_odoo_create_task
Einzelnen Task erstellen.

```json
{
  "entry": { "source": "error", "level": "error", "message": "...", "meta": {...} },
  "project_id": 5,
  "stage_id": 12,
  "assignee": "dev@example.com",
  "title": "Optionaler Titel"
}
```

---

### devchef_odoo_bulk_create
Alle neuen Error-Gruppen als Tasks anlegen.

```json
{
  "project": "my-app",
  "project_id": 5,
  "stage_id": 12,
  "last_n": 50
}
```

## Triage Workflow

```
1. devchef_errors     → aktuelle Fehler sehen
2. devchef_odoo_triage → gruppieren + Dedup-Check
3. devchef_odoo_create_task (einzeln) ODER devchef_odoo_bulk_create
```

## Entry Schema

```json
{
  "ts":      "2026-03-30T14:22:01.123Z",
  "source":  "console|error|network|perf|system|feedback",
  "level":   "log|info|warn|error",
  "message": "string",
  "meta":    {}
}
```