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

// GUIDES

Isabyte MCP Server

Isabyte MCP Server

En selvstendig Model Context Protocol-server som gjør enhver MCP-kompatibel AI-klient til en ekspert på Isabyte Power Tools.

Isabyte MCP Server bygger hele skill-samlingen for Isabyte Power Tools inn i et lett Linux-image (~50 MB) og gjør den tilgjengelig over Streamable-HTTP-transporten i Model Context Protocol. Koble til Claude Desktop, Cline, Cursor, Continue eller en annen MCP-klient, så blir AI-assistenten din en Isabyte-spesialist med dokumentert kunnskap om hver komponent, parameter og hvert mønster i katalogen.

Én server, én katalog. Skill-filene beskriver selve designsystemet — komponentkatalogen, parameterne og designtokenene som er felles for alle Isabyte Power Tools-pakkene — så den samme serveren gir assistenten din riktig grunnlag uansett hvilken pakke du bygger med.

Slik kjører du den

  1. Last ned zip-filen og pakk den ut.
  2. Last inn imaget i din lokale Docker-motor: bash load.sh
  3. Start serveren: docker run --rm -p 7180:7180 isabyte-mcp-server:<version>
  4. Sjekk at den er frisk: curl http://localhost:7180/health returnerer {"status":"ok","skills":10}.
  5. Koble en hvilken som helst MCP-klient til http://localhost:7180/mcp.

Konfigurasjon av MCP-klienten

Hver klient har sitt eget konfigurasjonsformat, og en feil nøkkel gjør at klienten ignorerer oppføringen eller faller tilbake til en eldre transport. Under Slik får du MCP-serveren til å virke nedenfor finner du den nøyaktige oppføringen for hver klient. Den vanligste formen er denne, som Cursor bruker:

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

Andre klienter skiller seg fra dette: VS Code bruker nøkkelen servers med "type": "http", Windsurf serverUrl, Gemini CLI httpUrl, Cline "type": "streamableHttp" og opencode en mcp-nøkkel med "type": "remote". Claude Code og OpenAI Codex legger til serveren med en kommando.

Når den er koblet til, kan assistenten lese alle Isabyte-skills som MCP-ressurser (isabyte-skill://) eller gjennom MCP-verktøyene list_isabyte_skills og read_isabyte_skill, som returnerer den samme teksten for klienter som støtter verktøy, men ikke ressurser. Prompten isabyte_expert_guidance legger inn alle skills som grunnlag for svarene.

Sikkerhet

Som standard lytter serveren på 0.0.0.0 uten autentisering — greit for én lokal arbeidsstasjon. Hvis containeren kan nås utenfor localhost:

  • Lytt bare på localhost: -p 127.0.0.1:7180:7180
  • Eller krev et bearer-token: -e MCP_AUTH_TOKEN="$(openssl rand -hex 24)" og legg "headers": { "Authorization": "Bearer YOUR_TOKEN" } til i klientkonfigurasjonen.

Slik får du MCP-serveren til å virke

En AI-kodeagent trenger to ting før den kan bruke serveren godt: en tilkobling (serveren i MCP-konfigurasjonen til klienten din) og en instruksjonsfil i prosjektet som forteller agenten når den skal bruke den. Uten instruksjonsfilen ser agenten serveren, men vet ikke at den skal lese Isabyte-dokumentasjonen før den skriver Isabyte-kode, så den gjetter i stedet.

Instruksjonsfilen. Innholdet er det samme for alle klienter; bare filnavnet og mappen varierer, så last ned filen for klienten din nedenfor. Den er skrevet på engelsk med vilje: det er agenten som leser den, ikke teamet ditt. En nedlasting i nettleseren kan ikke opprette mapper, så flytt filen til stien som er oppgitt for klienten din. Hvis prosjektet allerede har en fil med det navnet, legger du til innholdet nederst i den i stedet for å erstatte den. Filene for Cursor, Windsurf og Continue starter med en kort header som får klienten til å laste inn filen i hver økt; la den stå helt øverst i filen.

Før du starter. Serveren må kjøre (se Slik kjører du den). Alle eksemplene nedenfor registrerer den under navnet isabyte-expert på http://localhost:7180/mcp. Hvis du startet serveren med MCP_AUTH_TOKEN, legger du også inn Authorization: Bearer-headeren fra Sikkerhet i header-feltet i klientkonfigurasjonen.

Ressurser eller verktøy — det virker uansett. Serveren tilbyr Isabyte-dokumentasjonen på to måter, med den samme teksten: som MCP-ressurser (isabyte-skill://…) og gjennom to MCP-verktøy, list_isabyte_skills og read_isabyte_skill. Noen klienter leser ressurser, og alle klientene nedenfor kan kalle verktøy, så agenten har alltid en måte å lese dokumentasjonen på. Instruksjonsfilen ber den bruke verktøyet når klienten ikke kan lese ressurser.

En testprompt for alle klienter. Når klienten er koblet til, åpner du en ny økt i prosjektet og skriver: «Legg til en Isabyte-datovelger i registreringsskjemaet.» Agenten skal lese isabyte-skill://isabyte-controls.md, eller kalle read_isabyte_skill for isabyte-controls, før den skriver noe kode. Hvis den skriver Isabyte-kode uten først å lese Isabyte-dokumentasjonen, blir ikke instruksjonsfilen lastet inn.

Claude Code

MCP-konfigurasjon — denne kommandoen skriver .mcp.json i prosjektroten, så alle som åpner prosjektet, får serveren:

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

Instruksjonsfil — CLAUDE.md i prosjektroten. Last ned CLAUDE.md

Sjekk at det virker — kjør /mcp i en økt: isabyte-expert skal stå oppført som tilkoblet. Prøv deretter testprompten.

Vanlige problemer — første gang Claude Code starter i prosjektet, ber den deg godkjenne serverne i .mcp.json; hvis du sa nei, forblir serveren avslått. Claude Code leser AGENTS.md bare når prosjektet ikke har noen CLAUDE.md, så legg innholdet i CLAUDE.md.

OpenAI Codex

MCP-konfigurasjon — codex mcp add isabyte-expert --url http://localhost:7180/mcp, som legger dette til i ~/.codex/config.toml:

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

Instruksjonsfil — AGENTS.md i prosjektroten. Last ned AGENTS.md

Sjekk at det virker — codex mcp list, eller /mcp i terminalgrensesnittet til Codex. Prøv deretter testprompten.

Hvis du startet serveren med MCP_AUTH_TOKEN, legger du tokenet i en miljøvariabel og legger til bearer_token_env_var = "ISABYTE_TOKEN" (navnet på variabelen) i oppføringen; Codex sender det som Authorization: Bearer-headeren.

Vanlige problemer — en .codex/config.toml på prosjektnivå leses bare i et prosjekt du har merket som klarert. Dokumentasjonen til Codex nevner ikke MCP-ressurser, så agenten leser Isabyte-dokumentasjonen med verktøyene list_isabyte_skills og read_isabyte_skill. Hvis et langt verktøyresultat blir kuttet, øker du output_token_limit for read_isabyte_skill i config.toml, eller ber agenten lese skillen én seksjon om gangen.

GitHub Copilot

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

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

Instruksjonsfil — .github/copilot-instructions.md. Last ned copilot-instructions.md

Sjekk at det virker — kjør MCP: List Servers fra Command Palette: isabyte-expert skal kjøre, og MCP: Browse Resources viser isabyte-skill://-ressursene til serveren. Prøv testprompten i agentmodus.

Vanlige problemer — denne filen bruker nøkkelen servers, ikke mcpServers. Skyagenten til Copilot på GitHub.com kjører i skyen, så den når ikke en server på din localhost. Den bruker bare MCP-verktøy, ikke ressurser, så med en server den kan nå, leser den dokumentasjonen med list_isabyte_skills og read_isabyte_skill.

Cursor

MCP-konfigurasjon — .cursor/mcp.json i prosjektet:

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

Instruksjonsfil — .cursor/rules/isabyte-mcp.mdc. Last ned isabyte-mcp.mdc

Sjekk at det virker — MCP-delen av innstillingene i Cursor skal vise isabyte-expert som aktivert; tilkoblingsfeil finner du i Output-panelet under «MCP Logs». Prøv deretter testprompten.

Vanlige problemer — en regel i .cursor/rules/ må ende på .mdc; en vanlig .md-fil der blir ignorert. Cursor leser også en AGENTS.md i prosjektroten, så hvis prosjektet allerede har en, kan du legge innholdet til der i stedet.

Windsurf

MCP-konfigurasjon — åpne MCPs-delen fra «…»-menyen i Cascade og rediger selve konfigurasjonsfilen (mcp_config.json):

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

Instruksjonsfil — .windsurf/rules/isabyte-mcp.md. Last ned isabyte-mcp.md

Sjekk at det virker — MCPs-delen skal vise isabyte-expert med verktøyene og ressursene sine. Prøv deretter testprompten i Cascade.

Vanlige problemer — Windsurf heter nå Devin Desktop. Den leser fortsatt .windsurf/rules/, men standardagenten Devin Local henter MCP-servere fra .devin/mcp_config.json i stedet for fra Cascade-konfigurasjonen; legg til serveren der med devin mcp add -s project isabyte-expert http://localhost:7180/mcp. En regelfil kan inneholde høyst 12 000 tegn.

Gemini CLI

MCP-konfigurasjon — denne kommandoen skriver .gemini/settings.json i prosjektet:

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

Oppføringen den skriver, bruker httpUrl:

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

Instruksjonsfil — GEMINI.md i prosjektroten. Last ned GEMINI.md

Sjekk at det virker — kjør /mcp: isabyte-expert skal være tilkoblet, med verktøyene og ressursene sine oppført. Prøv deretter testprompten.

Vanlige problemer — i settings.json betyr httpUrl Streamable HTTP, som er det denne serveren bruker; url betyr den eldre SSE-transporten og får ikke koblet til. Gemini CLI leser AGENTS.md bare hvis context.fileName i innstillingene lister den opp, så bruk GEMINI.md. Gemini CLI korter som standard ned verktøyresultater som er lengre enn 40 000 tegn (tools.truncateToolOutputThreshold); den største Isabyte-skillen er lengre enn det, så agenten bør lese den én seksjon om gangen (read_isabyte_skill tar en section).

Cline

MCP-konfigurasjon — i MCP Servers-panelet velger du Configure → «Configure MCP Servers» og legger til:

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

Instruksjonsfil — .clinerules/isabyte-mcp.md. Last ned isabyte-mcp.md

Sjekk at det virker — MCP Servers-panelet skal vise isabyte-expert som tilkoblet, med verktøyene list_isabyte_skills og read_isabyte_skill. Prøv deretter testprompten.

Vanlige problemer — uten "type": "streamableHttp" faller Cline tilbake til den eldre SSE-transporten og får ikke koblet til. Dokumentasjonen til Cline nevner MCP-ressurser bare i forbifarten, så agenten leser Isabyte-dokumentasjonen med verktøyene.

Continue

MCP-konfigurasjon — 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

Instruksjonsfil — .continue/rules/isabyte-mcp.md. Last ned isabyte-mcp.md

Sjekk at det virker — skriv @ i agentmodus: ressursene fra isabyte-expert skal dukke opp blant context providers. Prøv deretter testprompten.

Vanlige problemer — Continue bruker MCP-servere bare i agentmodus. YAML-filen må ha linjene name, version og schema, ellers blir den ikke lastet inn. Authorization-headeren legges under requestOptions: → headers: i serveroppføringen.

opencode

MCP-konfigurasjon — opencode.json i prosjektroten:

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

Instruksjonsfil — AGENTS.md i prosjektroten, den samme filen som OpenAI Codex leser. Last ned AGENTS.md

Sjekk at det virker — opencode mcp list viser om isabyte-expert er tilkoblet. Prøv deretter testprompten.

Vanlige problemer — opencode leser CLAUDE.md bare når prosjektet ikke har noen AGENTS.md. Dokumentasjonen beskriver bare MCP-verktøy, så agenten leser Isabyte-dokumentasjonen med verktøyene list_isabyte_skills og read_isabyte_skill.

Claude Desktop

Claude Desktop har ingen instruksjonsfil for prosjektet. I et Claude-prosjekt limer du i stedet inn innholdet fra en av nedlastingene over i prosjektinstruksjonene. Egne connectorer (Customize → Connectors → Add custom connector) kobler til fra Anthropics sky, ikke fra datamaskinen din, så de når ikke en server på localhost: serveren må kunne nås over HTTPS fra internett.

Hvis det fortsatt ikke virker

  • curl http://localhost:7180/health feiler: serveren kjører ikke.
  • Adressen må slutte på /mcp.
  • Klienten melder 401: serveren ble startet med MCP_AUTH_TOKEN, og klienten sender ingen Authorization: Bearer-header, eller feil token.
  • Agenten skriver Isabyte-kode uten å lese Isabyte-dokumentasjonen (en ressurs eller read_isabyte_skill): instruksjonsfilen ligger ikke på stien som er oppgitt for klienten din, eller du har ikke startet en ny økt etter at du la den til.
  • Når du har endret MCP-konfigurasjonen til en klient, må du starte klienten på nytt eller starte en ny økt.
Det oppsto en uhåndtert feil. Last inn på nytt 🗙

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.