MCP-Server für KI-Agenten

Ladehase bietet einen MCP-Server (Model Context Protocol). Damit können KI-Agenten wie Claude, ChatGPT oder Cursor deine Ladestationen abfragen, Tarife vorschlagen, Ladungen starten oder Berichte erstellen. Die Werkzeuge entstehen aus denselben Endpunkten wie die REST-API.

• Adresse: https://api.ladehase.com/mcp
• Transport: Streamable HTTP (JSON-RPC über POST)
• Anmeldung: Authorization: Bearer lh_live_… oder lh_test_…

Claude

In Claude Desktop öffnest du die Einstellungen unter «Entwickler» und bearbeitest die Konfiguration:

{
  "mcpServers": {
    "ladehase": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.ladehase.com/mcp", "--header", "Authorization:Bearer lh_test_…"]
    }
  }
}

In Claude Code genügt ein Befehl:

claude mcp add --transport http ladehase https://api.ladehase.com/mcp --header "Authorization: Bearer lh_test_…"

ChatGPT

In ChatGPT fügst du unter «Einstellungen», «Connectors» einen eigenen Connector hinzu (Entwicklermodus). Als Adresse gibst du https://api.ladehase.com/mcp ein und als Authentifizierung den API-Schlüssel als Bearer-Token.

Cursor

Leg im Projekt die Datei .cursor/mcp.json an:

{
  "mcpServers": {
    "ladehase": {
      "url": "https://api.ladehase.com/mcp",
      "headers": { "Authorization": "Bearer lh_test_…" }
    }
  }
}

Werkzeuge

Der Server liefert mit tools/list alle Werkzeuge mit Beschreibung und JSON-Schema. Die Namen entsprechen den Endpunkten der API-Referenz in Kleinbuchstaben mit Unterstrich, zum Beispiel:

• list_devices, get_device_state: Ladepunkte und ihr Zustand
• create_session, stop_session, list_sessions: Ladungen starten, stoppen, auswerten
• preview_tariff_draft, create_tariff: Tarife berechnen und anlegen
• create_code, render_signs: QR-Codes und Schilder
• get_report_summary: Kennzahlen
• create_access_grant: Zugänge für Bewohnende oder Mitarbeitende

Lesende Werkzeuge sind als readOnlyHint markiert, verändernde Werkzeuge wie Stoppen, Sperren oder Rückerstatten als destructiveHint. Gute Agenten fragen vor solchen Aktionen nach.

Beispiel

curl -X POST https://api.ladehase.com/mcp \
  -H "Authorization: Bearer lh_test_…" \
  -H "Content-Type: application/json" \
  -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "list_devices", "arguments": {} } }'

Einheiten für Agenten

Der Server teilt Agenten beim Verbinden mit, dass Beträge in Rappen, Energie in Wh und Energiepreise in Hundertstel-Rappen pro kWh angegeben sind. Gib diese Regel in eigenen Anweisungen trotzdem nochmals mit, wenn ein Agent Tarife anlegen soll.

Schreibende Werkzeuge abschalten

Schreibende Werkzeuge lassen sich für eine Organisation deaktivieren. Der Agent kann dann nur noch lesen und erhält bei verändernden Aufrufen eine verständliche Meldung. Schreib uns an developer@ladehase.com, wenn du das für deine Organisation möchtest.