Wofür ist der neoom MCP gedacht?
Mit dem neoom MCP bekommt dein KI-Assistent Zugriff auf das Produktwissen von neoom. Statt Handbücher und Artikel selbst zu durchsuchen, stellst du deine Frage im Chat, und der Assistent holt die Antwort direkt aus den neoom-Quellen. Das spart dir Zeit bei Installation, Inbetriebnahme und Support.
Der Zugriff umfasst zwei Quellen mit öffentlich freigegebenen Inhalten:
- Wissensbasis: Handbücher, Wissensdatenbank-Artikel (docs.neoom.com) und Support-Fälle.
- Produkt-Ontologie: Produkte, Kompatibilität, Voraussetzungen, Einschränkungen und Fehlerbilder.
Typische Einsatzfälle:
- Installation und Inbetriebnahme: Was ist bei einer bestimmten Kombination von Komponenten zu beachten?
- Anlagenfragen: Geht eine Funktion bei dieser Anlage, und welche Voraussetzungen gelten?
- Störungen: Was kann hinter einer Fehlermeldung oder einem Fehlercode stecken, und welche Angaben fehlen zur Klärung?
- Support: Antwortentwürfe für Kundenanfragen vorbereiten, die du vor dem Versand prüfst. Einen Beispiel-Prompt dafür findest du im Artikel System-Prompt für Support-Antwortentwürfe.
Interne Informationen von neoom gehören nicht dazu. Hängt eine Antwort daran, sagt dir der Assistent das, und du klärst den Punkt mit dem neoom-Support.
Die technische Anbindung beschreibt der Rest dieses Artikels.
1. Token anfordern
Den Token erstellt neoom für dich. Erstelle dafür ein Support-Ticket unter support.neoom.com. Du erhältst den Token danach separat und verschlüsselt.
2. Einrichten
Trage in deinem MCP-Client die URL `https://mcp.neoom.com/` (Transport Streamable HTTP) und den Header `Authorization: Bearer <dein Token>` ein. Ersetze `DEIN_TOKEN` in den Beispielen durch deinen Token.
Claude Code
```bash
claude mcp add --transport http neoom https://mcp.neoom.com/ --header "Authorization: Bearer DEIN_TOKEN"
```
VS Code (`.vscode/mcp.json`, fragt den Token beim Start ab und speichert ihn nicht in der Datei)
```json
{
"inputs": [
{ "type": "promptString", "id": "neoom-token", "description": "neoom MCP Token", "password": true }
],
"servers": {
"neoom": {
"type": "http",
"url": "https://mcp.neoom.com/",
"headers": { "Authorization": "Bearer ${input:neoom-token}" }
}
}
}
```
Cursor (`~/.cursor/mcp.json`, Datei nicht in ein Repository einchecken)
```json
{
"mcpServers": {
"neoom": {
"url": "https://mcp.neoom.com/",
"headers": { "Authorization": "Bearer DEIN_TOKEN" }
}
}
}
```
Eigene Anwendungen und Agenten: Jeder MCP-Client mit Streamable HTTP und frei setzbarem Header funktioniert, mit denselben zwei Angaben.
Achtung: Nicht geeignet sind die Connectors in Claude (Web und Desktop). Sie melden sich per Login an und können keinen Token mitschicken. Ein Login ist außerdem nur mit einer freigeschalteten E-Mail-Domain möglich.
3. Verbindung prüfen
Dieser Aufruf listet die verfügbaren Werkzeuge. Kommt eine JSON-Liste zurück, ist alles eingerichtet.
```bash
curl -s https://mcp.neoom.com/ \
-H "Authorization: Bearer DEIN_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```
Antwortet der Server mit `401`, fehlt der Token, ist falsch geschrieben, abgelaufen oder von neoom gesperrt.
Fehlen in der Liste die Werkzeuge der Produkt-Ontologie, etwa `suche`, ist sie gerade nicht erreichbar. Verbinde dich später neu, viele Clients laden die Werkzeuge nur beim Verbinden.
Alternativ mit dem MCP Inspector: `npx @modelcontextprotocol/inspector` starten, Transport „Streamable HTTP“, URL `https://mcp.neoom.com/`, Header `Authorization` mit `Bearer DEIN_TOKEN`.
4. Welche Werkzeuge es gibt
Dein Assistent wählt die Werkzeuge selbst. Die wichtigsten je Quelle:
Quelle | Inhalt | Wichtigste Werkzeuge |
|---|---|---|
Wissensbasis | Handbücher, Wissensdatenbank-Artikel, Support-Fälle | `search_documents` (Suche), `get_document` (ganzes Dokument) |
Produkt-Ontologie | Produkte, Kompatibilität, Voraussetzungen, Einschränkungen, Fehlerbilder | `anleitung` (einmal zu Beginn), `suche` (Einstieg), `eintraege`, `konfiguration_auswerten`, `klaerungsstand`, `rueckfrage_plan` |
Beispielfragen an deinen Assistenten:
- „Was muss ich bei der Installation einer KJUUBE mit Solax-Wechselrichter beachten?“
- „Der BEAAM bleibt dauerhaft auf ‚updating‘. Was kann ich tun?“
Nenne in deiner Frage das Produkt, etwa STAAK Flex oder BLOKK. Sonst fragt dein Assistent eventuell zuerst danach, weil die Antwort davon abhängt.
Hängt eine Antwort an internen Informationen, steht dort ein Hinweis wie „Details intern“. Kläre den Punkt dann mit dem neoom-Support.
Fehlt etwas oder ist eine Angabe falsch, kann dein Assistent das mit dem Werkzeug `rueckmeldung` an neoom melden.
Als Quelle liefert die Wissensbasis die öffentlichen Links auf docs.neoom.com mit. Links in interne Ablagen bekommst du nicht.
5. Gut zu wissen
- Limit: Bis zu 30 Abfragen der Wissensbasis pro Minute und 1.000 pro Tag (`search_documents`, `get_document`). Die Werkzeuge der Produkt-Ontologie zählen nicht mit. Der Tag wechselt um Mitternacht UTC, in Österreich im Winter um 01:00 Uhr, im Sommer um 02:00 Uhr. Darüber kommt der Fehler `rate_limited` mit der Wartezeit in Sekunden (`retry_after`).
- Token wie ein Passwort behandeln: Lege ihn nur in einem Passwortmanager oder Secret-Speicher ab, nie in Code-Repositories, Tickets, Chats oder Prompts. Der Token hat ein Ablaufdatum. Einen neuen Token beantragst du wie den ersten über ein Support-Ticket.
- Verdacht auf Missbrauch oder Verlust: Erstelle sofort ein Support-Ticket unter support.neoom.com. Wir sperren den Token und stellen dir einen neuen aus.
- Keine personenbezogenen Daten: Anfragen werden protokolliert. Schreibe keine Namen, Adressen, Seriennummern oder anderen Kundendaten in deine Fragen.
- Antworten prüfen: Die Antworten erstellt eine KI auf Basis der neoom-Quellen. Verbindliche Auskünfte, etwa zu Garantie oder Tausch, gibt der neoom-Support.
Fragen, neuer Token oder Sperrung: Erstelle ein Support-Ticket unter support.neoom.com.