أداة MCP

عرض المشاريع

sosoapi_list_projects

عرض مشاريع مساحة عمل (طبقة اختيارية للمصدر والإعدادات الافتراضية للحساب) والمشروع النشط.

الملفات التعريفية ووسائل النقل

الملفات التعريفية: full · وسائل النقل: stdio, http

اختر core أو full للأدوات التي يراها عميلك؛ لا يغيّر ذلك أذوناته. يحتاج رفع الملفات المحلية stdio ولا يتاح بـ HTTP. اضبط SOSOAPI_OUTPUT_SCHEMAS=1 لمخططات المخرجات بالاكتشاف. النتائج منظّمة بهذا الإعداد أوبدونه.

الأذونات والآثار الجانبية

تساعد الشروح العملاء على وصف الأداة. يظل كل استدعاء يفحص مصادقة المستخدم ودوره ووصوله إلى المورد وتفويض الإمكانات.

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

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

حقول الإدخال

تعني «مطلوب» داخل الكائن الأب والفرع المختار. الحقل الابن المطلوب لا يجعل الأب الاختياري مطلوباً. نُسخت القواعد وأسماء الحقول أدناه من العقد.

حقول الإدخال
الحقل / الفرع	النوع / مطلوب	القيود
`$`	`object`مطلوب في العنصر الأب	`additionalProperties: false`
`workspace_id`	`string`مطلوب في العنصر الأب	`format: "uuid"`
`limit`	`integer`اختياري / عنصر	حجم الصفحة، من 1 إلى 100. إرسال limit أو cursor يحوّل المسار إلى تصفّح cursor ويضيف next_cursor إلى الإجابة. `minimum: 1` `maximum: 100`
`cursor`	`string`اختياري / عنصر	مؤشر cursor معتم: قيمة next_cursor من الصفحة السابقة دون تغيير. احذفه للصفحة الأولى. أرسل المرشحات نفسها مع كل صفحة. `minLength: 1` `maxLength: 512`
`include_version`	`boolean`اختياري / عنصر	اختياري. تضيف true إصدار المورد إلى الإجابة. —

مخطط 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
}

مخرجات منظّمة

يصف المخطط structuredContent في نتيجة أداة ناجحة. تشمل استجابة MCP أيضاً content وقد تضبط isError عند الفشل. للنشر، اقرأ النتيجة النهائية بدلاً من اعتبار القبول أوالنص تأكيداً. تشرح عملية API المرتبطة الأذونات وقواعد المحاولة.

مخرجات منظّمة
الحقل / الفرع	النوع / مطلوب	القيود
`$`	`object`مطلوب في العنصر الأب	`additionalProperties: false`
`projects`	`array`مطلوب في العنصر الأب	—
`projects[]`	`object`اختياري / عنصر	`additionalProperties: false`
`projects[].id`	`string`مطلوب في العنصر الأب	`format: "uuid"`
`projects[].workspace_id`	`string`مطلوب في العنصر الأب	`format: "uuid"`
`projects[].name`	`string`مطلوب في العنصر الأب	`minLength: 1` `maxLength: 200`
`projects[].operational_state`	`string`مطلوب في العنصر الأب	`enum: ["active","archived"]`
`projects[].lifecycle_version`	`integer`مطلوب في العنصر الأب	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`projects[].defaults_version`	`integer`مطلوب في العنصر الأب	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`projects[].archived_at`	`string \| null`مطلوب في العنصر الأب	—
`projects[].archived_at`anyOf 1	`string`مطلوب في العنصر الأب	—
`projects[].archived_at`anyOf 2	`null`مطلوب في العنصر الأب	—
`projects[].archived_by`	`string \| null`مطلوب في العنصر الأب	—
`projects[].archived_by`anyOf 1	`string`مطلوب في العنصر الأب	`format: "uuid"`
`projects[].archived_by`anyOf 2	`null`مطلوب في العنصر الأب	—
`projects[].archived_by_api_key_id`	`string \| null`مطلوب في العنصر الأب	—
`projects[].archived_by_api_key_id`anyOf 1	`string`مطلوب في العنصر الأب	`format: "uuid"`
`projects[].archived_by_api_key_id`anyOf 2	`null`مطلوب في العنصر الأب	—
`projects[].created_at`	`string`مطلوب في العنصر الأب	—
`projects[].updated_at`	`string`مطلوب في العنصر الأب	—
`projects[].version`	`integer`اختياري / عنصر	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`active_project_id`	`string \| null`مطلوب في العنصر الأب	—
`active_project_id`anyOf 1	`string`مطلوب في العنصر الأب	`format: "uuid"`
`active_project_id`anyOf 2	`null`مطلوب في العنصر الأب	—
`next_cursor`	`string \| null`اختياري / عنصر	يظهر فقط إذا أرسل الطلب limit أو cursor. ويكون null في الصفحة الأخيرة. —
`next_cursor`anyOf 1	`string`اختياري / عنصر	—
`next_cursor`anyOf 2	`null`اختياري / عنصر	—

مخطط 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
}

مثال لاستدعاء أداة

تستخدم الأمثلة قيماً خيالية مفحوصة بالمخططات. استبدل المعرّفات بالمفوّض لك، والوسائط بأصول جاهزة، والتواريخ بوقت نشر مؤكد. افحص أهلية الحساب قبل الكتابة. لا تُرسل الصفحة طلبات API.

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

structuredContent

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

/studio-api/projects/list

تثبيت MCP أو ربطه