Hoppa till innehållet
Stackship-dokumentation English

Stackship-plattformenAnvändareMaskinöversatt

Anslut en AI-klient

Anslut Claude Code, Claude Desktop, Codex, opencode eller en annan MCP-klient till plattformen, så att en AI-assistent kan arbeta med dina resurser som du.

En AI-assistent som talar Model Context Protocol (MCP) kan läsa och hantera plattformen åt dig. Den ansluter till plattformens MCP-server på https://api.example.com/mcp.

Innan du börjar

MCP-gränssnittet är avslaget tills en plattformsadministratör slår på det — se Slå på AI-klienter. Tills dess kan ingen klient ansluta.

Konfigurationen för Codex, och vägen via konfigurationsfilen för Claude Desktop, kör en liten brygga via npx, så de behöver Node.js på din dator.

Öppna installationssidan

Välj Hjälp (frågetecknet i sidhuvudet) och sedan AI-klienter, eller sök i sidhuvudet efter "AI", "MCP" eller "Claude". Sidan är ifylld med den här installationens egen adress, och alla som kan logga in kan öppna den.

Om sidan visar en varning i stället för konfiguration har portalen inte fått veta API:ets adress. En operatör måste ställa in den; det finns inget du kan ändra.

Konfigurera din klient

Sidan har en flik per klient. Kopiera från sidan i stället för från ett exempel — sidan innehåller den här installationens adress.

Flik Vad du får
Claude Code Ett kommando att köra i terminalen
Claude Desktop Två vägar, se nedan
Codex Konfiguration för ~/.codex/config.toml
opencode Konfiguration för ~/.config/opencode/opencode.json
Konfigurationsfil En allmän MCP-konfiguration för andra klienter
Serveradress Bara adressen

För Claude Code är kommandot:

bash
claude mcp add --transport http stackship https://api.example.com/mcp

Claude Desktop tar en av två vägar, beroende på din version:

  • Om din version har egna kopplingar — öppna inställningarna, leta upp kopplingar och lägg till en egen koppling med adressen. Claude Desktop sköter inloggningen själv.
  • Annars, brygg anslutningen — lägg till bryggkonfigurationen från sidan i claude_desktop_config.json: på macOS i ~/Library/Application Support/Claude/, på Windows i %APPDATA%\Claude\. Avsluta och öppna Claude Desktop igen efteråt; filen läses bara vid start.

Logga in

Det finns ingen token att skapa, kopiera eller spara. Första gången din klient anropar plattformen öppnar den ett webbläsarfönster, och du loggar in med ditt vanliga konto, precis som i portalen.

Innan dess måste klienten vara känd för plattformens inloggning, och det beror på konfigurationen:

  • Codex och Claude Desktops konfigurationsfil går via bryggan, som loggar in med en klient som plattformen tillhandahåller, så inget behöver registreras.
  • Claude Code, opencode, fliken Konfigurationsfil och Claude Desktops egna koppling registrerar en egen klient första gången de ansluter. Plattformen avvisar den registreringen om inte en plattformsadministratör har tillåtit den värd som klienten skickar dig tillbaka till efter inloggningen: localhost och 127.0.0.1 för en klient på din dator, claude.ai för Claude Desktops koppling. Listan är tom från början — se Låt klienter registrera sig.

Vad assistenten kan göra

Assistenten agerar som du: den anropar plattformen med din egen inloggning, så den kan göra det du kan och inget mer, och en ändring som den gör registreras på ditt konto som om du hade gjort den i portalen. Behörigheter ges per boundary, så om en assistent säger att den inte kan göra något är en saknad behörighet den troliga orsaken.

Servern erbjuder de här verktygen:

Verktyg Vad det gör
whoami Vem du är inloggad som
list_boundaries De boundaries som du kan se
search_operations Hittar anrop i plattformens API som passar en uppgift
describe_operation Visar hur ett sådant anrop görs
invoke_operation Gör ett API-anrop som du — läser och ändrar
search_docs Söker i plattformens dokumentation
read_doc Läser en dokumentationssida

De två dokumentationsverktygen kräver plattformens dokumentationstjänst; på en plattform utan den svarar de att dokumentation inte är tillgänglig.

Om den inte vill ansluta

  • Gränssnittet är avslaget. Servern svarar på varje anrop med 404 och mcp_disabled. Be en plattformsadministratör slå på det.
  • Konfigurationen är fel. Kopiera den igen från installationssidan.
  • Inloggningen nekas, ofta innan ett webbläsarfönster öppnas. En klient som registrerar sig själv — Claude Code, opencode, konfigurationen från fliken Konfigurationsfil, Claude Desktops koppling — nekas om inte värden som den skickar dig tillbaka till finns på plattformens lista över värdar som får registrera en klient; felet kan nämna Policy 'Trusted Hosts' rejected request. Be en plattformsadministratör lägga till localhost och 127.0.0.1, eller claude.ai för kopplingen. Vägarna via Codex och Claude Desktops konfigurationsfil registrerar inte och påverkas inte.
  • Bryggan startar inte. Installera Node.js, som tillhandahåller npx.