MCP-Tool

Projekte auflisten

sosoapi_list_projects

Liste Projekte eines Workspace (optionale Ebene für Herkunft und Kontostandards) und das aktive Projekt auf.

Profile und Transporte

Profile: full · Transporte: stdio, http

Wähle core oder full für die sichtbaren Tools deines Clients; dies ändert keine Berechtigungen. Lokaler Dateiupload benötigt stdio und ist über HTTP nicht verfügbar. Setze SOSOAPI_OUTPUT_SCHEMAS=1 für Ausgabeschemas in der Erkennung. Tools liefern unabhängig davon strukturierte Ergebnisse.

Berechtigungen und Nebeneffekte

Annotationen helfen Clients, Tools zu beschreiben. Jeder Aufruf prüft weiterhin Authentifizierung, Rolle, Ressourcenzugriff und erteilte Funktionen des Nutzers.

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

/studio-api/projects/list: agent:operate · synchronous_http_response

Eingabefelder

Erforderlich bedeutet innerhalb des übergeordneten Objekts und gewählten Zweigs erforderlich. Ein erforderliches Kind macht kein optionales Elternobjekt erforderlich. Regeln und Feldnamen unten stammen aus dem Vertrag.

Eingabefelder
Feld / Variante	Typ / erforderlich	Einschränkungen
`$`	`object`Im Elternobjekt erforderlich	`additionalProperties: false`
`workspace_id`	`string`Im Elternobjekt erforderlich	`format: "uuid"`
`limit`	`integer`Optional / Element	Seitengröße, 1 bis 100. limit oder cursor schalten diese Route auf Cursor-Paginierung und ergänzen next_cursor in der Antwort. `minimum: 1` `maximum: 100`
`cursor`	`string`Optional / Element	Opaker Cursor: der unveränderte next_cursor der vorherigen Seite. Auf der ersten Seite weglassen. Bei jeder Seite müssen dieselben Filter mitgesendet werden. `minLength: 1` `maxLength: 512`
`include_version`	`boolean`Optional / Element	Optional. true ergänzt die Ressourcenversion in der Antwort. —

Vollständiges JSON Schema

{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Page size, 1 to 100. Sending limit or cursor switches this route to cursor paging and adds next_cursor to the answer."
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "description": "Opaque cursor: the next_cursor of the previous page, unchanged. Omit it for the first page. The same filters must be sent with every page."
    },
    "include_version": {
      "description": "Optional. true adds the resource version to the answer.",
      "type": "boolean"
    }
  },
  "required": [
    "workspace_id"
  ],
  "additionalProperties": false
}

Strukturierte Ausgabe

Dieses Schema beschreibt structuredContent in einem erfolgreichen Tool-Ergebnis. Die MCP-Antwort enthält auch content und kann bei fehlgeschlagenem Aufruf isError setzen. Lies bei Veröffentlichungen das endgültige Beitragsergebnis, statt eine angenommene Anfrage oder Textantwort als Bestätigung zu werten. Die verknüpfte API-Operation erklärt Berechtigungen und Wiederholungsregeln.

Strukturierte Ausgabe
Feld / Variante	Typ / erforderlich	Einschränkungen
`$`	`object`Im Elternobjekt erforderlich	`additionalProperties: false`
`projects`	`array`Im Elternobjekt erforderlich	—
`projects[]`	`object`Optional / Element	`additionalProperties: false`
`projects[].id`	`string`Im Elternobjekt erforderlich	`format: "uuid"`
`projects[].workspace_id`	`string`Im Elternobjekt erforderlich	`format: "uuid"`
`projects[].name`	`string`Im Elternobjekt erforderlich	`minLength: 1` `maxLength: 200`
`projects[].operational_state`	`string`Im Elternobjekt erforderlich	`enum: ["active","archived"]`
`projects[].lifecycle_version`	`integer`Im Elternobjekt erforderlich	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`projects[].defaults_version`	`integer`Im Elternobjekt erforderlich	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`projects[].archived_at`	`string \| null`Im Elternobjekt erforderlich	—
`projects[].archived_at`anyOf 1	`string`Im Elternobjekt erforderlich	—
`projects[].archived_at`anyOf 2	`null`Im Elternobjekt erforderlich	—
`projects[].archived_by`	`string \| null`Im Elternobjekt erforderlich	—
`projects[].archived_by`anyOf 1	`string`Im Elternobjekt erforderlich	`format: "uuid"`
`projects[].archived_by`anyOf 2	`null`Im Elternobjekt erforderlich	—
`projects[].archived_by_api_key_id`	`string \| null`Im Elternobjekt erforderlich	—
`projects[].archived_by_api_key_id`anyOf 1	`string`Im Elternobjekt erforderlich	`format: "uuid"`
`projects[].archived_by_api_key_id`anyOf 2	`null`Im Elternobjekt erforderlich	—
`projects[].created_at`	`string`Im Elternobjekt erforderlich	—
`projects[].updated_at`	`string`Im Elternobjekt erforderlich	—
`projects[].version`	`integer`Optional / Element	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`active_project_id`	`string \| null`Im Elternobjekt erforderlich	—
`active_project_id`anyOf 1	`string`Im Elternobjekt erforderlich	`format: "uuid"`
`active_project_id`anyOf 2	`null`Im Elternobjekt erforderlich	—
`next_cursor`	`string \| null`Optional / Element	Nur vorhanden, wenn limit oder cursor angefordert wurde. Null auf der letzten Seite. —
`next_cursor`anyOf 1	`string`Optional / Element	—
`next_cursor`anyOf 2	`null`Optional / Element	—

Vollständiges JSON Schema

{
  "type": "object",
  "properties": {
    "projects": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "workspace_id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "operational_state": {
            "type": "string",
            "enum": [
              "active",
              "archived"
            ]
          },
          "lifecycle_version": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          },
          "defaults_version": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          },
          "archived_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "archived_by": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ]
          },
          "archived_by_api_key_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ]
          },
          "created_at": {
            "type": "string"
          },
          "updated_at": {
            "type": "string"
          },
          "version": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          }
        },
        "required": [
          "id",
          "workspace_id",
          "name",
          "operational_state",
          "lifecycle_version",
          "defaults_version",
          "archived_at",
          "archived_by",
          "archived_by_api_key_id",
          "created_at",
          "updated_at"
        ],
        "additionalProperties": false
      }
    },
    "active_project_id": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid"
        },
        {
          "type": "null"
        }
      ]
    },
    "next_cursor": {
      "description": "Present only when the request sent limit or cursor. Null on the last page.",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "projects",
    "active_project_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Beispiel eines Tool-Aufrufs

Diese Beispiele nutzen anhand der Schemas geprüfte fiktive Werte. Ersetze IDs durch autorisierte IDs, Medien durch bereite Assets und Daten durch bestätigte Veröffentlichungszeiten. Prüfe Kontoeignung vor Schreibvorgängen. Diese Seite sendet keine API-Anfragen.

{
  "name": "sosoapi_list_projects",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111"
  }
}

structuredContent

{
  "projects": [],
  "active_project_id": null
}

/studio-api/projects/list

MCP installieren oder verbinden