API: mcp-system-and-messaging-tools

Ort: work7_laendletech/docs/api/api-mcp-system-and-messaging-tools.md

Überblick

• Base-URL / Prefix: /mcp
• Auth: JSON-RPC mit Work7-Kontext-Headern
• Format: JSON-RPC 2.0
• Source of truth: mcp/src/central-mcp-server/contracts/work7-tools.v1.md

Endpoint(s)

tools/call mit whatsapp_sessions.*

Zweck:

Werkzeuge fuer WhatsApp-Sessions und Messaging-nahe Interaktionen.

Bekannte Tools

• whatsapp_sessions.list
• whatsapp_sessions.get
• whatsapp_sessions.create
• whatsapp_sessions.send_message
• whatsapp_sessions.close

Standard Request-Schema

Feld	Typ	Pflicht	Beschreibung
jsonrpc	string	ja	2.0
id	string	ja	Request-ID
method	string	ja	tools/call
params.name	string	ja	z. B. messages.create
params.arguments	object	nein	Tool-spezifische Parameter

Standard Response 200

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": {
    "content": [
      {
        "type": "json",
        "json": {
          "success": true,
          "data": {}
        }
      }
    ]
  }
}

Fehler

HTTP	Bedeutung	Body-Hinweis
400	Ungültiger Tool-Call	JSON-RPC error
401	Auth fehlt	JSON-RPC error
403	Kontext fehlt / unzulässig	JSON-RPC error
500	Tool- oder Datenbankfehler	JSON-RPC error

Rate Limiting / Limits

• Max Requests: Nicht separat dokumentiert
• Timeout: Abhaengig von Remote MCP und Agent-Service
• Max Payload: Nachrichten- und Query-Payloads koennen groesser sein als typische CRUD-Argumente

Breaking Changes / Versionierung

• db.*, sessions.* und messages.* gehoeren nicht zum eingefrorenen externen Work7-v1-Contract.
• Die aktuelle source-of-truth Messaging-Domain ist whatsapp_sessions.*.
• Aenderungen an Session- oder Message-Semantik sind fuer Agent-Workflows breaking.

Beispiel (curl)

curl -sS -X POST "{{mcp_base_url}}/mcp" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: {{mcp_api_key}}" \
  -H "X-Work7-User-Id: 18" \
  -H "X-Work7-User-Role: 1" \
  -H "X-Work7-Company-Id: mueller-bau-de" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "tools/call",
    "params": {
      "name": "whatsapp_sessions.list",
      "arguments": {
        "phone_number": "+43123456789"
      }
    }
  }'

Verwandte Notes

• Feature-Spec: work7
• OpenAPI/Schema: MCP JSON-RPC

Follow-ups

• [ ] Postman Collection prüfen: passt es in bestehende Collection? Sonst neu anlegen → work7_laendletech/src/postman/ 📅 2026-04-16
• [ ] In Feature-Spec verlinken falls zugehörig 📅 2026-04-16