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

// GUIDES

Isabyte MCP-server

Isabyte MCP-server

En fristående Model Context Protocol-server som gör vilken AI-klient som helst med MCP-stöd till expert på Isabyte Power Tools.

Isabyte MCP-servern bakar in hela kunskapsbasen av Isabyte Power Tools-skills i en lättviktig Linux-image (~50 MB) och exponerar den via Model Context Protocols transport Streamable HTTP. Anslut Claude Desktop, Cline, Cursor, Continue eller någon annan MCP-klient så blir din AI-assistent specialist på Isabyte, med förankrad kunskap om varje komponent, parameter och mönster i katalogen.

En server, en katalog. Skill-filerna beskriver själva designsystemet — komponentkatalogen, parametrarna och designtokens som delas av alla Isabyte Power Tools-paket — så samma server ger din assistent rätt underlag oavsett vilket paket du bygger med.

Så kör du den

  1. Ladda ned zip-filen och packa upp den.
  2. Läs in imagen i din lokala Docker-motor: bash load.sh
  3. Starta servern: docker run --rm -p 7180:7180 isabyte-mcp-server:<version>
  4. Kontrollera att den mår bra: curl http://localhost:7180/health returnerar {"status":"ok","skills":10}.
  5. Anslut valfri MCP-klient till http://localhost:7180/mcp.

Konfiguration av MCP-klienten

Varje klient har sitt eget konfigurationsformat, och med en felaktig nyckel ignorerar klienten posten eller faller tillbaka på en äldre transport. Under Få MCP-servern att fungera nedan finns den exakta posten för varje klient. Den vanligaste formen är den här, som Cursor använder:

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

Andra klienter skiljer sig åt: VS Code använder nyckeln servers med "type": "http", Windsurf serverUrl, Gemini CLI httpUrl, Cline "type": "streamableHttp" och opencode en mcp-nyckel med "type": "remote". Claude Code och OpenAI Codex lägger till servern med ett kommando.

När klienten är ansluten kan assistenten läsa varje Isabyte-skill som en MCP-resurs (isabyte-skill://) eller via MCP-verktygen list_isabyte_skills och read_isabyte_skill, som returnerar samma text för klienter som stöder verktyg men inte resurser. Prompten isabyte_expert_guidance injicerar alla skills som underlag.

Säkerhet

Som standard binder servern till 0.0.0.0 utan autentisering — det går bra för en enskild lokal arbetsstation. Om containern kan nås utanför localhost:

  • Bind bara till localhost: -p 127.0.0.1:7180:7180
  • Eller kräv en bearer-token: -e MCP_AUTH_TOKEN="$(openssl rand -hex 24)" och lägg till "headers": { "Authorization": "Bearer YOUR_TOKEN" } i klientkonfigurationen.

Få MCP-servern att fungera

En AI-kodagent behöver två saker innan den kan använda servern på rätt sätt: en anslutning (servern i klientens MCP-konfiguration) och en instruktionsfil i ditt projekt som talar om för agenten när den ska använda servern. Utan instruktionsfilen ser agenten servern men vet inte att den ska läsa Isabyte-dokumentationen innan den skriver Isabyte-kod, så den gissar i stället.

Instruktionsfilen. Innehållet är detsamma för alla klienter; bara filnamnet och mappen skiljer sig, så ladda ned filen för din klient nedan. Den är på engelska med avsikt: det är agenten som läser den, inte ditt team. En nedladdning i webbläsaren kan inte skapa mappar, så flytta filen till sökvägen som anges för din klient. Om projektet redan har en fil med det namnet lägger du till innehållet i den i stället för att ersätta den. Filerna för Cursor, Windsurf och Continue börjar med ett kort inledande block som gör att klienten läser in filen i varje session; behåll det allra överst i filen.

Innan du börjar. Servern måste vara igång (se Så kör du den). Alla exempel nedan registrerar den under namnet isabyte-expert på http://localhost:7180/mcp. Om du startade servern med MCP_AUTH_TOKEN lägger du också till headern Authorization: Bearer från Säkerhet i fältet för headers i klientens konfiguration.

Resurser eller verktyg — det fungerar i båda fallen. Servern erbjuder Isabyte-dokumentationen två gånger, med samma text: som MCP-resurser (isabyte-skill://…) och via två MCP-verktyg, list_isabyte_skills och read_isabyte_skill. Vissa klienter läser resurser, och alla klienter nedan kan anropa verktyg, så agenten har alltid ett sätt att läsa dokumentationen. Instruktionsfilen säger åt den att använda verktyget när klienten inte kan läsa resurser.

En testprompt för alla klienter. När klienten är ansluten öppnar du en ny session i projektet och skriver: ”Lägg till en Isabyte-datumväljare i registreringsformuläret.” Agenten bör läsa isabyte-skill://isabyte-controls.md, eller anropa read_isabyte_skill för isabyte-controls, innan den skriver någon kod. Om den skriver Isabyte-kod utan att först läsa Isabyte-dokumentationen läses instruktionsfilen inte in.

Claude Code

MCP-konfiguration — det här kommandot skriver .mcp.json i projektets rot, så alla som öppnar projektet får servern:

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

Instruktionsfil — CLAUDE.md i projektets rot. Ladda ned CLAUDE.md

Kontrollera att det fungerar — kör /mcp i en session: isabyte-expert ska stå som ansluten. Prova sedan testprompten.

Vanliga problem — första gången Claude Code startar i projektet ber den dig godkänna servrarna i .mcp.json; om du avböjde förblir servern avstängd. Claude Code läser AGENTS.md bara när projektet saknar CLAUDE.md, så lägg innehållet i CLAUDE.md.

OpenAI Codex

MCP-konfiguration — codex mcp add isabyte-expert --url http://localhost:7180/mcp, som lägger till detta i ~/.codex/config.toml:

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

Instruktionsfil — AGENTS.md i projektets rot. Ladda ned AGENTS.md

Kontrollera att det fungerar — codex mcp list, eller /mcp i Codex terminalgränssnitt. Prova sedan testprompten.

Om du startade servern med MCP_AUTH_TOKEN lägger du token i en miljövariabel och lägger till bearer_token_env_var = "ISABYTE_TOKEN" (variabelns namn) i posten; Codex skickar den som headern Authorization: Bearer.

Vanliga problem — en .codex/config.toml på projektnivå läses bara i ett projekt som du har markerat som betrott. Codex dokumentation tar inte upp MCP-resurser, så agenten läser Isabyte-dokumentationen med verktygen list_isabyte_skills och read_isabyte_skill. Om ett långt verktygsresultat klipps av höjer du output_token_limit för read_isabyte_skill i config.toml, eller ber agenten läsa skillen ett avsnitt i taget.

GitHub Copilot

MCP-konfiguration — i VS Code, .vscode/mcp.json:

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

Instruktionsfil — .github/copilot-instructions.md. Ladda ned copilot-instructions.md

Kontrollera att det fungerar — kör MCP: List Servers från Command Palette: isabyte-expert ska vara igång, och MCP: Browse Resources listar dess isabyte-skill://-resurser. Prova testprompten i agentläge.

Vanliga problem — den här filen använder nyckeln servers, inte mcpServers. Copilots molnagent på GitHub.com körs i molnet, så den når inte en server på din localhost. Den använder bara MCP-verktyg, inte resurser, så med en server som den kan nå läser den dokumentationen med list_isabyte_skills och read_isabyte_skill.

Cursor

MCP-konfiguration — .cursor/mcp.json i projektet:

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

Instruktionsfil — .cursor/rules/isabyte-mcp.mdc. Ladda ned isabyte-mcp.mdc

Kontrollera att det fungerar — MCP-avsnittet i Cursors inställningar ska visa isabyte-expert som aktiverad; anslutningsfel finns i panelen Output under ”MCP Logs”. Prova sedan testprompten.

Vanliga problem — en regel i .cursor/rules/ måste sluta på .mdc; en vanlig .md-fil där ignoreras. Cursor läser också en AGENTS.md i projektets rot, så om projektet redan har en sådan kan du lägga till innehållet där i stället.

Windsurf

MCP-konfiguration — öppna avsnittet MCPs från menyn ”…” i Cascade och redigera den råa konfigurationen (mcp_config.json):

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

Instruktionsfil — .windsurf/rules/isabyte-mcp.md. Ladda ned isabyte-mcp.md

Kontrollera att det fungerar — avsnittet MCPs ska lista isabyte-expert med dess verktyg och resurser. Prova sedan testprompten i Cascade.

Vanliga problem — Windsurf heter numera Devin Desktop. Det läser fortfarande .windsurf/rules/, men dess standardagent Devin Local läser MCP-servrar från .devin/mcp_config.json i stället för från Cascade-konfigurationen; lägg till servern där med devin mcp add -s project isabyte-expert http://localhost:7180/mcp. En regelfil får innehålla högst 12 000 tecken.

Gemini CLI

MCP-konfiguration — det här kommandot skriver .gemini/settings.json i projektet:

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

Posten som kommandot skriver använder httpUrl:

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

Instruktionsfil — GEMINI.md i projektets rot. Ladda ned GEMINI.md

Kontrollera att det fungerar — kör /mcp: isabyte-expert ska vara ansluten och dess verktyg och resurser listade. Prova sedan testprompten.

Vanliga problem — i settings.json betyder httpUrl Streamable HTTP, som den här servern använder; url betyder den äldre SSE-transporten och ansluter inte. Gemini CLI läser AGENTS.md bara om context.fileName i dess inställningar listar den, så använd GEMINI.md. Gemini CLI kortar som standard verktygsresultat som är längre än 40 000 tecken (tools.truncateToolOutputThreshold); den största Isabyte-skillen är längre, så agenten bör läsa den ett avsnitt i taget (read_isabyte_skill tar ett section).

Cline

MCP-konfiguration — i panelen MCP Servers väljer du Configure → ”Configure MCP Servers” och lägger till:

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

Instruktionsfil — .clinerules/isabyte-mcp.md. Ladda ned isabyte-mcp.md

Kontrollera att det fungerar — panelen MCP Servers ska visa isabyte-expert som ansluten, med verktygen list_isabyte_skills och read_isabyte_skill. Prova sedan testprompten.

Vanliga problem — utan "type": "streamableHttp" faller Cline tillbaka på den äldre SSE-transporten och kan inte ansluta. Clines dokumentation nämner MCP-resurser bara i förbigående, så agenten läser Isabyte-dokumentationen med verktygen.

Continue

MCP-konfiguration — en fil .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

Instruktionsfil — .continue/rules/isabyte-mcp.md. Ladda ned isabyte-mcp.md

Kontrollera att det fungerar — skriv @ i agentläge: resurserna från isabyte-expert ska visas bland kontextleverantörerna. Prova sedan testprompten.

Vanliga problem — Continue använder MCP-servrar bara i agentläge. YAML-filen behöver raderna name, version och schema, annars läses den inte in. Headern Authorization placeras under requestOptions: → headers: i serverposten.

opencode

MCP-konfiguration — opencode.json i projektets rot:

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

Instruktionsfil — AGENTS.md i projektets rot, samma fil som OpenAI Codex läser. Ladda ned AGENTS.md

Kontrollera att det fungerar — opencode mcp list visar om isabyte-expert är ansluten. Prova sedan testprompten.

Vanliga problem — opencode läser CLAUDE.md bara när projektet saknar AGENTS.md. Dess dokumentation beskriver bara MCP-verktyg, så agenten läser Isabyte-dokumentationen med verktygen list_isabyte_skills och read_isabyte_skill.

Claude Desktop

Claude Desktop har ingen instruktionsfil för projekt. I ett Claude-projekt klistrar du i stället in innehållet från någon av nedladdningarna ovan i projektinstruktionerna. Dess anpassade anslutningar (Customize → Connectors → Add custom connector) ansluter från Anthropics moln, inte från din dator, så de når inte en server på localhost: servern måste vara nåbar över HTTPS från internet.

Om det fortfarande inte fungerar

  • curl http://localhost:7180/health misslyckas: servern körs inte.
  • Adressen måste sluta på /mcp.
  • Klienten rapporterar 401: servern startades med MCP_AUTH_TOKEN, och klienten skickar ingen Authorization: Bearer-header, eller fel token.
  • Agenten skriver Isabyte-kod utan att läsa Isabyte-dokumentationen (en resurs eller read_isabyte_skill): instruktionsfilen ligger inte på sökvägen som anges för din klient, eller så har du inte startat en ny session sedan du lade till den.
  • När du har ändrat en klients MCP-konfiguration startar du om klienten eller startar en ny session.
Ett ohanterat fel har inträffat. Ladda om 🗙

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.