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
| Parameter | Typ | Obligatorisk | Beskrivning |
|---|---|---|---|
qualifiedName | string | Ja | Serverns kvalificerade namn, t.ex. namespace/server. Använd %2F för att URL-koda snedstrecket. |
Begäranskropp (multipart/form-data)
| Fält | Typ | Obligatorisk | Beskrivning |
|---|---|---|---|
payload | string | Ja | JSON-kodad release-payload (se DeployPayload) |
module | binary | Nej | JavaScript-modulfil (för hosted-releaser) |
sourcemap | binary | Nej | Source map-fil (för hosted-releaser) |
bundle | binary | Nej | MCPB-bundlefil (för stdio-releaser) |
Svar
202 Releasen mottagen
Releasen har tagits emot och bearbetas. Statusen är WORKING tills processen är klar.
| Fält | Typ | Beskrivning |
|---|---|---|
deploymentId | string | Unikt UUID för releasen |
status | string | Inledande status, t.ex. "WORKING" |
mcpUrl | string | MCP-endpoint för servern efter publicering |
warnings | string[] | Icke-kritiska varningar under inskickning |
400 Ogiltig payload
| Fält | Typ | Beskrivning |
|---|---|---|
error | string | Felmeddelande |
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ält | Typ | Obligatorisk | Beskrivning |
|---|---|---|---|
type | "hosted" | Ja | Fast värde |
stateful | boolean | Ja | Om servern behåller tillstånd mellan anrop |
hasAuthAdapter | boolean | Ja | Om servern hanterar egen autentisering mot upstream-tjänster |
configSchema | object | Nej | JSON Schema för konfigurationsparametrar |
serverCard | object | Nej | Metadata som visas i katalogen |
secretNames | string[] | Nej | Hemligheter som servern behöver vid körning |
source | object | Nej | Referens till källkodsrepo |
external
Servern körs på din egen infrastruktur och exponeras via en URL.
| Fält | Typ | Obligatorisk | Beskrivning |
|---|---|---|---|
type | "external" | Ja | Fast värde |
stdio
Servern körs lokalt via stdio och distribueras som en MCPB-bundle.
| Fält | Typ | Obligatorisk | Beskrivning |
|---|---|---|---|
type | "stdio" | Ja | Fast värde |