Alat MCP

Daftar proyek

sosoapi_list_projects

Tampilkan proyek ruang kerja (lapisan opsional untuk asal-usul dan akun default) serta proyek yang aktif.

Profil dan transport

Profil: full · Transport: stdio, http

Pilih core atau full untuk mengatur alat yang terlihat oleh klien; ini tidak mengubah izinnya. Unggahan file lokal memerlukan stdio dan tidak tersedia melalui HTTP. Atur SOSOAPI_OUTPUT_SCHEMAS=1 untuk menyertakan skema output saat penemuan. Alat mengembalikan hasil terstruktur dengan atau tanpa pengaturan itu.

Izin dan efek samping

Anotasi membantu klien menjelaskan alat. Setiap panggilan tetap memeriksa autentikasi pengguna, peran, akses sumber daya, dan izin kemampuan.

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

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

Kolom input

Wajib berarti wajib dalam objek induk dan cabang yang dipilih. Anak wajib tidak membuat induk opsional menjadi wajib. Aturan dan nama kolom di bawah disalin dari kontrak.

Kolom input
Kolom / cabang	Jenis / wajib	Batasan
`$`	`object`Wajib dalam induk	`additionalProperties: false`
`workspace_id`	`string`Wajib dalam induk	`format: "uuid"`
`limit`	`integer`Opsional / item	Ukuran halaman, 1 hingga 100. Mengirim limit atau cursor mengalihkan rute ke paginasi kursor dan menambahkan next_cursor ke jawaban. `minimum: 1` `maximum: 100`
`cursor`	`string`Opsional / item	Kursor opak: next_cursor dari halaman sebelumnya, tanpa perubahan. Hilangkan untuk halaman pertama. Filter yang sama harus dikirim pada setiap halaman. `minLength: 1` `maxLength: 512`
`include_version`	`boolean`Opsional / item	Opsional. true menambahkan versi sumber daya ke jawaban. —

JSON Schema lengkap

{
  "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
}

Output terstruktur

Skema ini menjelaskan structuredContent dalam hasil alat yang berhasil. Respons MCP juga menyertakan content dan dapat menetapkan isError saat panggilan gagal. Untuk publikasi, baca hasil akhir postingan alih-alih menganggap permintaan diterima atau respons teks sebagai konfirmasi. Operasi API yang ditautkan menjelaskan izin dan aturan percobaan ulang.

Wajib berarti wajib dalam objek induk dan cabang yang dipilih. Anak wajib tidak membuat induk opsional menjadi wajib. Aturan dan nama kolom di bawah disalin dari kontrak.

Output terstruktur
Kolom / cabang	Jenis / wajib	Batasan
`$`	`object`Wajib dalam induk	`additionalProperties: false`
`projects`	`array`Wajib dalam induk	—
`projects[]`	`object`Opsional / item	`additionalProperties: false`
`projects[].id`	`string`Wajib dalam induk	`format: "uuid"`
`projects[].workspace_id`	`string`Wajib dalam induk	`format: "uuid"`
`projects[].name`	`string`Wajib dalam induk	`minLength: 1` `maxLength: 200`
`projects[].operational_state`	`string`Wajib dalam induk	`enum: ["active","archived"]`
`projects[].lifecycle_version`	`integer`Wajib dalam induk	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`projects[].defaults_version`	`integer`Wajib dalam induk	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`projects[].archived_at`	`string \| null`Wajib dalam induk	—
`projects[].archived_at`anyOf 1	`string`Wajib dalam induk	—
`projects[].archived_at`anyOf 2	`null`Wajib dalam induk	—
`projects[].archived_by`	`string \| null`Wajib dalam induk	—
`projects[].archived_by`anyOf 1	`string`Wajib dalam induk	`format: "uuid"`
`projects[].archived_by`anyOf 2	`null`Wajib dalam induk	—
`projects[].archived_by_api_key_id`	`string \| null`Wajib dalam induk	—
`projects[].archived_by_api_key_id`anyOf 1	`string`Wajib dalam induk	`format: "uuid"`
`projects[].archived_by_api_key_id`anyOf 2	`null`Wajib dalam induk	—
`projects[].created_at`	`string`Wajib dalam induk	—
`projects[].updated_at`	`string`Wajib dalam induk	—
`projects[].version`	`integer`Opsional / item	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`active_project_id`	`string \| null`Wajib dalam induk	—
`active_project_id`anyOf 1	`string`Wajib dalam induk	`format: "uuid"`
`active_project_id`anyOf 2	`null`Wajib dalam induk	—
`next_cursor`	`string \| null`Opsional / item	Hanya ada jika permintaan mengirim limit atau cursor. Null pada halaman terakhir. —
`next_cursor`anyOf 1	`string`Opsional / item	—
`next_cursor`anyOf 2	`null`Opsional / item	—

JSON Schema lengkap

{
  "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
}

Contoh panggilan alat

Contoh ini menggunakan nilai fiktif yang diperiksa terhadap skema. Ganti ID dengan yang diizinkan bagi Anda, media dengan aset siap, dan tanggal dengan waktu publikasi yang dikonfirmasi. Periksa kelayakan akun sebelum mengirim penulisan. Halaman ini tidak mengirim permintaan API.

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

structuredContent

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

/studio-api/projects/list

Instal atau hubungkan MCP