MCP-tool

Projecten weergeven

sosoapi_list_projects

Toon de projecten van een werkruimte (een optionele laag voor herkomst en standaardaccounts) en welk project actief is.

Profielen en transporten

Profielen: full · Transporten: stdio, http

Kies core of full om te bepalen welke tools je client ziet; dit verandert geen machtigingen. Lokale bestandsupload vereist stdio en is niet beschikbaar via HTTP. Stel SOSOAPI_OUTPUT_SCHEMAS=1 in om uitvoerschema's bij detectie op te nemen. Tools geven met en zonder die instelling gestructureerde resultaten terug.

Machtigingen en neveneffecten

Annotaties helpen clients een tool te beschrijven. Elke aanroep controleert nog steeds gebruikersauthenticatie, rol, resourcetoegang en verleende bevoegdheden.

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

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

Invoervelden

Verplicht betekent verplicht binnen het bovenliggende object en de gekozen variant. Een verplicht onderliggend veld maakt een optioneel bovenliggend object niet verplicht. Onderstaande regels en veldnamen zijn uit het contract gekopieerd.

Invoervelden
Veld / variant	Type / verplicht	Beperkingen
`$`	`object`Verplicht in bovenliggend object	`additionalProperties: false`
`workspace_id`	`string`Verplicht in bovenliggend object	`format: "uuid"`
`limit`	`integer`Optioneel / item	Paginagrootte, 1 tot 100. limit of cursor meesturen schakelt deze route naar cursorpaginering en voegt next_cursor aan het antwoord toe. `minimum: 1` `maximum: 100`
`cursor`	`string`Optioneel / item	Ondoorzichtige cursor: de ongewijzigde next_cursor van de vorige pagina. Laat deze weg voor de eerste pagina. Stuur bij elke pagina dezelfde filters mee. `minLength: 1` `maxLength: 512`
`include_version`	`boolean`Optioneel / item	Optioneel. true voegt de resourceversie aan het antwoord toe. —

Volledig 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
}

Gestructureerde uitvoer

Dit schema beschrijft structuredContent in een geslaagd toolresultaat. Het MCP-antwoord bevat ook content en kan isError instellen wanneer een aanroep mislukt. Lees bij publiceren het definitieve berichtresultaat; beschouw een geaccepteerd verzoek of tekstantwoord niet als bevestiging. De gekoppelde API-bewerking beschrijft machtigingen en regels voor opnieuw proberen.

Gestructureerde uitvoer
Veld / variant	Type / verplicht	Beperkingen
`$`	`object`Verplicht in bovenliggend object	`additionalProperties: false`
`projects`	`array`Verplicht in bovenliggend object	—
`projects[]`	`object`Optioneel / item	`additionalProperties: false`
`projects[].id`	`string`Verplicht in bovenliggend object	`format: "uuid"`
`projects[].workspace_id`	`string`Verplicht in bovenliggend object	`format: "uuid"`
`projects[].name`	`string`Verplicht in bovenliggend object	`minLength: 1` `maxLength: 200`
`projects[].operational_state`	`string`Verplicht in bovenliggend object	`enum: ["active","archived"]`
`projects[].lifecycle_version`	`integer`Verplicht in bovenliggend object	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`projects[].defaults_version`	`integer`Verplicht in bovenliggend object	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`projects[].archived_at`	`string \| null`Verplicht in bovenliggend object	—
`projects[].archived_at`anyOf 1	`string`Verplicht in bovenliggend object	—
`projects[].archived_at`anyOf 2	`null`Verplicht in bovenliggend object	—
`projects[].archived_by`	`string \| null`Verplicht in bovenliggend object	—
`projects[].archived_by`anyOf 1	`string`Verplicht in bovenliggend object	`format: "uuid"`
`projects[].archived_by`anyOf 2	`null`Verplicht in bovenliggend object	—
`projects[].archived_by_api_key_id`	`string \| null`Verplicht in bovenliggend object	—
`projects[].archived_by_api_key_id`anyOf 1	`string`Verplicht in bovenliggend object	`format: "uuid"`
`projects[].archived_by_api_key_id`anyOf 2	`null`Verplicht in bovenliggend object	—
`projects[].created_at`	`string`Verplicht in bovenliggend object	—
`projects[].updated_at`	`string`Verplicht in bovenliggend object	—
`projects[].version`	`integer`Optioneel / item	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`active_project_id`	`string \| null`Verplicht in bovenliggend object	—
`active_project_id`anyOf 1	`string`Verplicht in bovenliggend object	`format: "uuid"`
`active_project_id`anyOf 2	`null`Verplicht in bovenliggend object	—
`next_cursor`	`string \| null`Optioneel / item	Alleen aanwezig wanneer het verzoek limit of cursor bevatte. Null op de laatste pagina. —
`next_cursor`anyOf 1	`string`Optioneel / item	—
`next_cursor`anyOf 2	`null`Optioneel / item	—

Volledig 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
}

Voorbeeld van een toolaanroep

Deze voorbeelden gebruiken fictieve waarden die tegen de schema's zijn gecontroleerd. Vervang IDs door toegestane IDs, media door gereedstaande bestanden en datums door je bevestigde publicatietijd. Controleer accountgeschiktheid vóór een schrijfhandeling. Deze pagina verstuurt geen API-verzoeken.

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

structuredContent

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

/studio-api/projects/list

Installeer of verbind MCP