Publicera en server

PUT /servers/{qualifiedName}/releases

Skicka en release via multipart-formulär. Stödjer hosted (JS-modul), external (URL) och stdio (MCPB-bundle) som releasetyper.

Autentisering

Se Autentisering (API-nyckel).

Parametrar

Sökväg

ParameterTypObligatoriskBeskrivning
qualifiedNamestringJaServerns kvalificerade namn, t.ex. namespace/server. Använd %2F för att URL-koda snedstrecket.

Begäranskropp (multipart/form-data)

FältTypObligatoriskBeskrivning
payloadstringJaJSON-kodad release-payload (se DeployPayload)
modulebinaryNejJavaScript-modulfil (för hosted-releaser)
sourcemapbinaryNejSource map-fil (för hosted-releaser)
bundlebinaryNejMCPB-bundlefil (för stdio-releaser)

Svar

202 Releasen mottagen

Releasen har tagits emot och bearbetas. Statusen är WORKING tills processen är klar.

FältTypBeskrivning
deploymentIdstringUnikt UUID för releasen
statusstringInledande status, t.ex. "WORKING"
mcpUrlstringMCP-endpoint för servern efter publicering
warningsstring[]Icke-kritiska varningar under inskickning

400 Ogiltig payload

FältTypBeskrivning
errorstringFelmeddelande

Kodexempel

const form = new FormData();
form.append('payload', JSON.stringify({
  type: 'hosted',
  configSchema: {}
}));
form.append('module', moduleFile);

const res = await fetch(
  'https://api.silai.se/servers/myorg%2Fmy-server/releases',
  {
    method: 'PUT',
    headers: { Authorization: 'Bearer YOUR_API_KEY' },
    body: form
  }
);

const release = await res.json();
console.log(release.deploymentId);
console.log(release.mcpUrl);

Scheman

DeployPayload

Payload är en union (oneOf) som avgörs av type-fältet.

hosted

Servern hostas på Silais plattform.

FältTypObligatoriskBeskrivning
type"hosted"JaFast värde
statefulbooleanJaOm servern behåller tillstånd mellan anrop
hasAuthAdapterbooleanJaOm servern hanterar egen autentisering mot upstream-tjänster
configSchemaobjectNejJSON Schema för konfigurationsparametrar
serverCardobjectNejMetadata som visas i katalogen
secretNamesstring[]NejHemligheter som servern behöver vid körning
sourceobjectNejReferens till källkodsrepo

external

Servern körs på din egen infrastruktur och exponeras via en URL.

FältTypObligatoriskBeskrivning
type"external"JaFast värde

stdio

Servern körs lokalt via stdio och distribueras som en MCPB-bundle.

FältTypObligatoriskBeskrivning
type"stdio"JaFast värde