Zum Inhalt springen
MCP-Server · für Entwickler

Ihre PV-Prognose in Claude Code, Cursor und VS Code

Mit dem Solariance MCP-Server lesen KI-Assistenten Ihre Anlagen und Prognosen – nur lesend, mit einem persönlichen API-Token. Eine URL, sieben Tools, kein eigener Code.

Claude Code, ein Befehl

Terminal
Shell
claude mcp add --transport http solariance https://api.solariance.de/v1/mcp \
  --header "Authorization: Bearer <your-api-token>"
Stand heute

VerfügbarClaude Code, Cursor, VS Code und Claude Desktop mit API-Token

Geplantclaude.ai und ChatGPT mit Ihrer Solariance-Anmeldung

Geplant heißt: noch nicht veröffentlicht, ohne Termin.

Was Sie fragen können

Fragen, die Ihr Assistent beantwortet

Die Tools wählt der Assistent selbst. Diese Fragen funktionieren genau so:

  • „Wie viel produziert meine PV-Anlage morgen?“

    list_systems, get_energy_forecast

  • „Wann lade ich mein E-Auto morgen am besten zwei Stunden mit 11 kW, um möglichst viel Solarstrom zu nutzen?“

    find_surplus_window

  • „Zeig mir die Leistungskurve meines Dachs für morgen, Stunde für Stunde.“

    get_power_forecast

  • „Vergleiche alle meine Anlagen für heute und morgen. Welche erzeugt am meisten pro kWp?“

    get_portfolio_forecast

Einrichtung

In drei Schritten verbunden

Etwa fünf Minuten. Sie brauchen ein Solariance-Konto mit mindestens einer PV-Anlage – der Free-Tarif reicht.

  1. 1

    API-Token erstellen

    Erstellen Sie in Ihrem Konto unter „API Tokens verwalten“ einen Token. Für den MCP-Server reicht „Nur Leseberechtigung“. Der Token wird nur einmal angezeigt – kopieren Sie ihn sofort.

    Zu den API-Tokens

  2. 2

    Server in Ihrem KI-Tool eintragen

    Ersetzen Sie <your-api-token> durch Ihren Token. Wählen Sie Ihr Tool:

    Claude Code

    Im Terminal ausführen.

    Terminal
    Shell
    claude mcp add --transport http solariance https://api.solariance.de/v1/mcp \
      --header "Authorization: Bearer <your-api-token>"

    Claude Desktop

    Unter Settings › Developer › Edit Config öffnet sich claude_desktop_config.json. Eintrag ergänzen und Claude Desktop neu starten. Nötig ist Node.js ab Version 18, weil mcp-remote den Token weiterreicht.

    claude_desktop_config.json
    JSON
    {
      "mcpServers": {
        "solariance": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://api.solariance.de/v1/mcp",
                   "--header", "Authorization:${AUTH_HEADER}"],
          "env": { "AUTH_HEADER": "Bearer <your-api-token>" }
        }
      }
    }

    Cursor

    In ~/.cursor/mcp.json (alle Projekte) oder .cursor/mcp.json (ein Projekt).

    mcp.json
    JSON
    {
      "mcpServers": {
        "solariance": {
          "url": "https://api.solariance.de/v1/mcp",
          "headers": { "Authorization": "Bearer <your-api-token>" }
        }
      }
    }

    VS Code

    In .vscode/mcp.json. VS Code fragt beim ersten Start nach dem Token und speichert ihn sicher, damit er nie in der Datei steht.

    .vscode/mcp.json
    JSON
    {
      "inputs": [
        { "type": "promptString", "id": "solariance-token",
          "description": "Solariance API token", "password": true }
      ],
      "servers": {
        "solariance": {
          "type": "http",
          "url": "https://api.solariance.de/v1/mcp",
          "headers": { "Authorization": "Bearer ${input:solariance-token}" }
        }
      }
    }

    Behandeln Sie den Token wie ein Passwort: Wer ihn hat, kann Ihre Anlagen und Prognosen lesen. Gerät er in falsche Hände, löschen Sie ihn unter API-Tokens; er funktioniert dann sofort nicht mehr.

  3. 3

    Fragen

    Starten Sie das Tool neu und fragen Sie: „Welche PV-Anlagen habe ich in Solariance?“ Der Assistent ruft list_systems auf und zählt sie auf.

Tools

Sieben Tools, alle nur lesend

Der Server kann in Ihrem Konto nichts ändern, anlegen oder löschen.

list_systems
Welche Anlagen das Konto hat: ID, Name, Ort, kWp.
get_system
Die vollständige Konfiguration einer Anlage, einschließlich Stromtarif.
get_energy_forecast
kWh pro Tag, Spitzenleistung und ihre Uhrzeit, für heute und die nächsten Tage.
get_portfolio_forecast
Die kWh pro Tag aller Anlagen und ihre Summe in einem Aufruf, mit der stärksten und schwächsten Anlage je Tag.
get_power_forecast
Die Leistungskurve eines Tages, stündlich oder in 15-Minuten-Schritten.
get_weather_forecast
Temperatur und Einstrahlung an der Anlage, Stunde für Stunde.
find_surplus_window
Die beste Zeit für Wallbox, Wärmepumpe oder Haushaltsgerät: kWh vom Dach, kWh aus dem Netz, gesparte Euro.

Leistung in kW, Energie in kWh, Uhrzeiten in der Zeitzone der Anlage.

Gut zu wissen

Grenzen und Daten

  • Prognosehorizont

    Free: heute und morgen. Plus und Premium: bis zu fünf Tage. Fragen über Ihren Tarif hinaus beantwortet der Server mit einer kurzen Erklärung, nicht mit einem Fehler.

  • Anfragen

    Bis zu 60 MCP-Anfragen pro Minute und 2.000 pro Tag und Konto. Prognose-Tools zählen außerdem zu den Prognoseabrufen Ihres Tarifs: 30 pro Stunde in Free und Plus, geteilt mit Ihrer App und anderen Tokens, 500 in Premium.

  • Nur lesend

    Alle sieben Tools lesen nur. Ein Token mit „Nur Leseberechtigung“ reicht und ist die Empfehlung.

  • Ihre Daten

    Ihr KI-Tool erhält die Ergebnisse der Tools, etwa Standort und Prognosen Ihrer Anlagen, und verarbeitet sie nach den Bedingungen seines Anbieters. Solariance speichert, welches Tool wann aufgerufen wurde, nie Ihre Unterhaltung.

  • Verlässlichkeit

    Prognosen können abweichen oder zeitweise nicht verfügbar sein (AGB § 11). Steuern Sie damit nie etwas Sicherheitskritisches.

Fehlerhilfe

Wenn etwas nicht klappt

Bereit für die erste Frage an Ihre Prognose?

Token erstellen, eine Zeile in Ihr Tool, erste Frage stellen.

Claude und Claude Code sind Produkte von Anthropic, ChatGPT von OpenAI, Cursor von Anysphere und Visual Studio Code von Microsoft. Diese Seite beschreibt den eigenen MCP-Server von Solariance; er ist kein Produkt dieser Unternehmen.