Norsk English (UK) English (US) Svenska Deutsch Français Español 中文 (简体)

// GUIDES

Isabyte MCP Server

Isabyte MCP Server

Ein eigenständiger Model-Context-Protocol-Server, der jeden MCP-fähigen KI-Client zum Experten für Isabyte Power Tools macht.

Der Isabyte MCP Server bettet den gesamten Skill-Korpus von Isabyte Power Tools in ein schlankes Linux-Image (ca. 50 MB) ein und stellt ihn über den Streamable-HTTP-Transport des Model Context Protocol bereit. Verbinden Sie Claude Desktop, Cline, Cursor, Continue oder einen anderen MCP-Client, und Ihr KI-Assistent wird zum Isabyte-Spezialisten mit fundiertem Wissen über jede Komponente, jeden Parameter und jedes Muster im Katalog.

Ein Server, ein Katalog. Die Skill-Dateien beschreiben das Designsystem selbst — den Komponentenkatalog, die Parameter und die Design-Tokens, die allen Isabyte-Power-Tools-Paketen gemeinsam sind —, derselbe Server liefert Ihrem Assistenten also fundiertes Wissen, egal mit welchem Paket Sie bauen.

Ausführen

  1. Laden Sie das ZIP-Archiv herunter und entpacken Sie es.
  2. Laden Sie das Image in Ihre lokale Docker-Engine: bash load.sh
  3. Starten Sie den Server: docker run --rm -p 7180:7180 isabyte-mcp-server:<version>
  4. Prüfen Sie, ob er läuft: curl http://localhost:7180/health gibt {"status":"ok","skills":10} zurück.
  5. Verbinden Sie einen beliebigen MCP-Client mit http://localhost:7180/mcp.

Konfiguration des MCP-Clients

Jeder Client hat sein eigenes Konfigurationsformat, und ein falscher Schlüssel führt dazu, dass ein Client den Eintrag ignoriert oder auf einen älteren Transport zurückfällt. Unter Den MCP-Server zum Laufen bringen finden Sie den genauen Eintrag für jeden Client. Die häufigste Form ist diese, die Cursor verwendet:

{
  "mcpServers": {
    "isabyte-expert": {
      "url": "http://localhost:7180/mcp"
    }
  }
}

Andere Clients weichen ab: VS Code verwendet den Schlüssel servers mit "type": "http", Windsurf serverUrl, Gemini CLI httpUrl, Cline "type": "streamableHttp" und opencode einen Schlüssel mcp mit "type": "remote". Claude Code und OpenAI Codex fügen den Server per Befehl hinzu.

Sobald die Verbindung steht, kann Ihr Assistent jeden Isabyte-Skill als MCP-Resource (isabyte-skill://) lesen oder über die MCP-Tools list_isabyte_skills und read_isabyte_skill, die denselben Text für Clients liefern, die Tools, aber keine Resources unterstützen. Der Prompt isabyte_expert_guidance speist jeden Skill als fundierenden Kontext ein.

Sicherheit

Standardmäßig bindet sich der Server ohne Authentifizierung an 0.0.0.0 — für eine einzelne lokale Workstation ist das in Ordnung. Wenn der Container über localhost hinaus erreichbar ist:

  • Binden Sie ihn nur an localhost: -p 127.0.0.1:7180:7180
  • Oder verlangen Sie ein Bearer-Token: -e MCP_AUTH_TOKEN="$(openssl rand -hex 24)" und ergänzen Sie "headers": { "Authorization": "Bearer YOUR_TOKEN" } in Ihrer Client-Konfiguration.

Den MCP-Server zum Laufen bringen

Ein KI-Coding-Agent braucht zwei Dinge, bevor er den Server sinnvoll nutzt: eine Verbindung (den Server in der MCP-Konfiguration Ihres Clients) und eine Anweisungsdatei in Ihrem Projekt, die dem Agenten sagt, wann er ihn verwenden soll. Ohne die Anweisungsdatei sieht der Agent den Server zwar, weiß aber nicht, dass er die Isabyte-Dokumentation lesen soll, bevor er Isabyte-Code schreibt — also rät er.

Die Anweisungsdatei. Ihr Inhalt ist für jeden Client derselbe; nur Dateiname und Ordner unterscheiden sich, laden Sie sie daher unten für Ihren Client herunter. Sie ist bewusst auf Englisch: Der Agent liest sie, nicht Ihr Team. Ein Browser-Download kann keine Ordner anlegen, verschieben Sie die Datei daher an den Pfad, der für Ihren Client angegeben ist. Gibt es in Ihrem Projekt bereits eine Datei mit diesem Namen, hängen Sie den Inhalt dort an, statt sie zu ersetzen. Die Dateien für Cursor, Windsurf und Continue beginnen mit einem kurzen Header, der den Client die Datei in jeder Sitzung laden lässt; lassen Sie ihn ganz oben in der Datei stehen.

Bevor Sie beginnen. Der Server muss laufen (siehe Ausführen). Jedes Beispiel unten registriert ihn unter dem Namen isabyte-expert unter http://localhost:7180/mcp. Wenn Sie den Server mit MCP_AUTH_TOKEN gestartet haben, ergänzen Sie außerdem den Header Authorization: Bearer aus Sicherheit im Header-Feld der Konfiguration Ihres Clients.

Resources oder Tools — es funktioniert auf beiden Wegen. Der Server bietet die Isabyte-Dokumentation doppelt an, mit demselben Text: als MCP-Resources (isabyte-skill://…) und über zwei MCP-Tools, list_isabyte_skills und read_isabyte_skill. Manche Clients lesen Resources, und jeder Client unten kann Tools aufrufen, sodass der Agent die Dokumentation immer lesen kann. Die Anweisungsdatei sagt ihm, dass er das Tool verwenden soll, wenn sein Client keine Resources lesen kann.

Ein Testprompt für jeden Client. Sobald der Client verbunden ist, öffnen Sie eine neue Sitzung in Ihrem Projekt und fragen: „Füge dem Registrierungsformular eine Isabyte-Datumsauswahl hinzu.“ Der Agent sollte isabyte-skill://isabyte-controls.md lesen oder read_isabyte_skill für isabyte-controls aufrufen, bevor er Code schreibt. Schreibt er Isabyte-Code, ohne vorher die Isabyte-Dokumentation zu lesen, wird die Anweisungsdatei nicht geladen.

Claude Code

MCP-Konfiguration — dieser Befehl schreibt .mcp.json in das Projektstammverzeichnis, sodass jeder, der das Projekt öffnet, den Server erhält:

claude mcp add --transport http --scope project isabyte-expert http://localhost:7180/mcp

Anweisungsdatei — CLAUDE.md im Projektstammverzeichnis. CLAUDE.md herunterladen

Prüfen, ob es funktioniert — führen Sie in einer Sitzung /mcp aus: isabyte-expert sollte als verbunden aufgeführt sein. Probieren Sie dann den Testprompt aus.

Häufige Probleme — beim ersten Start von Claude Code im Projekt werden Sie gebeten, die Server in .mcp.json zu genehmigen; haben Sie abgelehnt, bleibt der Server deaktiviert. Claude Code liest AGENTS.md nur, wenn das Projekt keine CLAUDE.md hat; legen Sie den Inhalt daher in CLAUDE.md ab.

OpenAI Codex

MCP-Konfiguration — codex mcp add isabyte-expert --url http://localhost:7180/mcp fügt Folgendes zu ~/.codex/config.toml hinzu:

[mcp_servers.isabyte-expert]
url = "http://localhost:7180/mcp"

Anweisungsdatei — AGENTS.md im Projektstammverzeichnis. AGENTS.md herunterladen

Prüfen, ob es funktioniert — codex mcp list oder /mcp in der Terminal-UI von Codex. Probieren Sie dann den Testprompt aus.

Wenn Sie den Server mit MCP_AUTH_TOKEN gestartet haben, legen Sie das Token in einer Umgebungsvariablen ab und ergänzen Sie den Eintrag um bearer_token_env_var = "ISABYTE_TOKEN" (den Namen der Variablen); Codex sendet es als Header Authorization: Bearer.

Häufige Probleme — eine .codex/config.toml auf Projektebene wird nur in einem Projekt gelesen, das Sie als vertrauenswürdig markiert haben. Die Dokumentation von Codex führt MCP-Resources nicht auf, daher liest der Agent die Isabyte-Dokumentation mit den Tools list_isabyte_skills und read_isabyte_skill. Wird ein langes Tool-Ergebnis abgeschnitten, erhöhen Sie output_token_limit für read_isabyte_skill in config.toml, oder bitten Sie den Agenten, den Skill Abschnitt für Abschnitt zu lesen.

GitHub Copilot

MCP-Konfiguration — in VS Code .vscode/mcp.json:

{
  "servers": {
    "isabyte-expert": {
      "type": "http",
      "url": "http://localhost:7180/mcp"
    }
  }
}

Anweisungsdatei — .github/copilot-instructions.md. copilot-instructions.md herunterladen

Prüfen, ob es funktioniert — führen Sie MCP: List Servers über die Befehlspalette aus: isabyte-expert sollte laufen, und MCP: Browse Resources listet seine isabyte-skill://-Resources auf. Probieren Sie den Testprompt im Agent-Modus aus.

Häufige Probleme — diese Datei verwendet den Schlüssel servers, nicht mcpServers. Der Copilot Cloud Agent auf GitHub.com läuft in der Cloud und kann daher keinen Server auf Ihrem localhost erreichen. Er nutzt nur MCP-Tools, keine Resources; mit einem Server, den er erreichen kann, liest er die Dokumentation daher mit list_isabyte_skills und read_isabyte_skill.

Cursor

MCP-Konfiguration — .cursor/mcp.json im Projekt:

{
  "mcpServers": {
    "isabyte-expert": {
      "url": "http://localhost:7180/mcp"
    }
  }
}

Anweisungsdatei — .cursor/rules/isabyte-mcp.mdc. isabyte-mcp.mdc herunterladen

Prüfen, ob es funktioniert — der MCP-Bereich in den Einstellungen von Cursor sollte isabyte-expert als aktiviert anzeigen; Verbindungsfehler finden Sie im Output-Panel unter „MCP Logs“. Probieren Sie dann den Testprompt aus.

Häufige Probleme — eine Regel in .cursor/rules/ muss auf .mdc enden; eine einfache .md-Datei wird dort ignoriert. Cursor liest außerdem eine AGENTS.md im Projektstammverzeichnis; hat Ihr Projekt bereits eine, können Sie den Inhalt stattdessen dort anhängen.

Windsurf

MCP-Konfiguration — öffnen Sie in Cascade über das Menü „…“ den Bereich „MCPs“ und bearbeiten Sie die Rohkonfiguration (mcp_config.json):

{
  "mcpServers": {
    "isabyte-expert": {
      "serverUrl": "http://localhost:7180/mcp"
    }
  }
}

Anweisungsdatei — .windsurf/rules/isabyte-mcp.md. isabyte-mcp.md herunterladen

Prüfen, ob es funktioniert — der Bereich „MCPs“ sollte isabyte-expert mit seinen Tools und Resources auflisten. Probieren Sie dann den Testprompt in Cascade aus.

Häufige Probleme — Windsurf heißt inzwischen Devin Desktop. Es liest weiterhin .windsurf/rules/, sein standardmäßiger Agent Devin Local liest MCP-Server jedoch aus .devin/mcp_config.json statt aus der Cascade-Konfiguration; fügen Sie den Server dort mit devin mcp add -s project isabyte-expert http://localhost:7180/mcp hinzu. Eine Regeldatei darf höchstens 12.000 Zeichen enthalten.

Gemini CLI

MCP-Konfiguration — dieser Befehl schreibt .gemini/settings.json im Projekt:

gemini mcp add --transport http isabyte-expert http://localhost:7180/mcp

Der Eintrag, den er schreibt, verwendet httpUrl:

{
  "mcpServers": {
    "isabyte-expert": {
      "httpUrl": "http://localhost:7180/mcp"
    }
  }
}

Anweisungsdatei — GEMINI.md im Projektstammverzeichnis. GEMINI.md herunterladen

Prüfen, ob es funktioniert — führen Sie /mcp aus: isabyte-expert sollte verbunden sein, und seine Tools und Resources sollten aufgelistet werden. Probieren Sie dann den Testprompt aus.

Häufige Probleme — in settings.json steht httpUrl für Streamable HTTP, das dieser Server spricht; url steht für den älteren SSE-Transport und stellt keine Verbindung her. Gemini CLI liest AGENTS.md nur, wenn context.fileName in seinen Einstellungen die Datei aufführt; verwenden Sie daher GEMINI.md. Gemini CLI kürzt Tool-Ergebnisse, die länger als 40.000 Zeichen sind, standardmäßig (tools.truncateToolOutputThreshold); der größte Isabyte-Skill ist länger, daher sollte der Agent ihn Abschnitt für Abschnitt lesen (read_isabyte_skill akzeptiert einen Parameter section).

Cline

MCP-Konfiguration — wählen Sie im Panel „MCP Servers“ Configure → „Configure MCP Servers“ und fügen Sie Folgendes hinzu:

{
  "mcpServers": {
    "isabyte-expert": {
      "type": "streamableHttp",
      "url": "http://localhost:7180/mcp"
    }
  }
}

Anweisungsdatei — .clinerules/isabyte-mcp.md. isabyte-mcp.md herunterladen

Prüfen, ob es funktioniert — das Panel „MCP Servers“ sollte isabyte-expert als verbunden anzeigen, mit den Tools list_isabyte_skills und read_isabyte_skill. Probieren Sie dann den Testprompt aus.

Häufige Probleme — ohne "type": "streamableHttp" fällt Cline auf den älteren SSE-Transport zurück und kann keine Verbindung herstellen. Die Dokumentation von Cline erwähnt MCP-Resources nur am Rande, daher liest der Agent die Isabyte-Dokumentation mit den Tools.

Continue

MCP-Konfiguration — eine Datei .continue/mcpServers/isabyte-expert.yaml:

name: Isabyte MCP server
version: 0.0.1
schema: v1
mcpServers:
  - name: isabyte-expert
    type: streamable-http
    url: http://localhost:7180/mcp

Anweisungsdatei — .continue/rules/isabyte-mcp.md. isabyte-mcp.md herunterladen

Prüfen, ob es funktioniert — geben Sie im Agent-Modus @ ein: Die Resources von isabyte-expert sollten unter den Kontextanbietern erscheinen. Probieren Sie dann den Testprompt aus.

Häufige Probleme — Continue nutzt MCP-Server nur im Agent-Modus. Die YAML-Datei braucht ihre Zeilen name, version und schema, sonst wird sie nicht geladen. Der Header Authorization gehört im Servereintrag unter requestOptions: → headers:.

opencode

MCP-Konfiguration — opencode.json im Projektstammverzeichnis:

{
  "mcp": {
    "isabyte-expert": {
      "type": "remote",
      "url": "http://localhost:7180/mcp",
      "enabled": true
    }
  }
}

Anweisungsdatei — AGENTS.md im Projektstammverzeichnis, dieselbe Datei, die OpenAI Codex liest. AGENTS.md herunterladen

Prüfen, ob es funktioniert — opencode mcp list zeigt, ob isabyte-expert verbunden ist. Probieren Sie dann den Testprompt aus.

Häufige Probleme — opencode liest CLAUDE.md nur, wenn das Projekt keine AGENTS.md hat. Seine Dokumentation beschreibt nur MCP-Tools, daher liest der Agent die Isabyte-Dokumentation mit den Tools list_isabyte_skills und read_isabyte_skill.

Claude Desktop

Claude Desktop hat keine Anweisungsdatei auf Projektebene. Fügen Sie in einem Claude-Projekt stattdessen den Inhalt einer der oben verlinkten Dateien in die Projektanweisungen ein. Seine benutzerdefinierten Connectors (Customize → Connectors → Add custom connector) verbinden sich aus der Cloud von Anthropic, nicht von Ihrem Computer, und können daher keinen Server auf localhost erreichen: Der Server muss über HTTPS aus dem Internet erreichbar sein.

Wenn es immer noch nicht funktioniert

  • curl http://localhost:7180/health schlägt fehl: Der Server läuft nicht.
  • Die Adresse muss auf /mcp enden.
  • Der Client meldet 401: Der Server wurde mit MCP_AUTH_TOKEN gestartet, und der Client sendet keinen Authorization: Bearer-Header oder das falsche Token.
  • Der Agent schreibt Isabyte-Code, ohne die Isabyte-Dokumentation zu lesen (eine Resource oder read_isabyte_skill): Die Anweisungsdatei liegt nicht an dem für Ihren Client angegebenen Pfad, oder Sie haben seit dem Hinzufügen keine neue Sitzung gestartet.
  • Wenn Sie die MCP-Konfiguration eines Clients ändern, starten Sie den Client neu oder beginnen Sie eine neue Sitzung.
Ein unbehandelter Fehler ist aufgetreten. Neu laden 🗙

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please reload the page.