リファレンス

#	ツール	カテゴリ	読み取り専用
1	`create_project`	プロジェクト管理	`false`
2	`get_project`	プロジェクト管理	`true`
3	`list_projects`	プロジェクト管理	`true`
4	`list_screens`	画面管理	`true`
5	`get_screen`	画面管理	`true`
6	`generate_screen_from_text`	AI 生成	`false`
7	`edit_screens`	AI 生成	`false`
8	`generate_variants`	AI 生成	`false`
9	`create_design_system`	デザインシステム	`false`
10	`update_design_system`	デザインシステム	`false`
11	`list_design_systems`	デザインシステム	`true`
12	`apply_design_system`	デザインシステム	`false`
13	`upload_design_md`	デザインシステム	`false`
14	`create_design_system_from_design_md`	デザインシステム	`false`

ツール

`create_project`

新しい Stitch プロジェクトを作成します。プロジェクトは、UI デザインとフロントエンドコードをまとめるコンテナです。

アノテーション

destructive

入力

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "Optional. The title of the project."
    }
  },
  "required": []
}

出力

作成された Project リソースを、生成された name、title、メタデータとともに返します。

プロンプト例

PROMPT

Create a new Stitch project called ‘Marketing Site’ Start a new design project Set up a new project for my app

`get_project`

プロジェクト名を指定して、特定の Stitch プロジェクトの詳細を取得します。

アノテーション

readOnly

入力

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Required. Resource name. Format: `projects/{project}`. Example: `projects/4044680601076201931`"
    }
  },
  "required": ["name"]
}

出力

Project リソースオブジェクトを返します。

プロンプト例

PROMPT

Get the details of project 4044680601076201931 Show me the project info What’s in my project?

`list_projects`

ユーザーがアクセスできるすべての Stitch プロジェクトを一覧表示します。デフォルトでは、ユーザーが所有するプロジェクトが一覧表示されます。

アノテーション

readOnly

入力

{
  "type": "object",
  "properties": {
    "filter": {
      "type": "string",
      "description": "Optional. AIP-160 filter on `view` field. Supported: `view=owned` (default), `view=shared`."
    }
  },
  "required": []
}

出力

Project リソースオブジェクトの配列。

プロンプト例

PROMPT

List all my Stitch projects Show me my projects List shared projects

`list_screens`

指定された Stitch プロジェクト内のすべての画面を一覧表示します。

アノテーション

readOnly

入力

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "description": "Required. Project ID (e.g., '4044680601076201931'), without `projects/` prefix."
    }
  },
  "required": ["projectId"]
}

出力

Screen オブジェクトの配列。

プロンプト例

PROMPT

List all screens in project 12345 Show me the designs in this project What screens are in my project?

`get_screen`

プロジェクト内の特定の画面の詳細を取得します。

アノテーション

readOnly

入力

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Required. Resource name. Format: `projects/{project}/screens/{screen}`"
    },
    "projectId": {
      "type": "string",
      "description": "Required (deprecated). Project ID without prefix."
    },
    "screenId": {
      "type": "string",
      "description": "Required (deprecated). Screen ID without prefix."
    }
  },
  "required": ["name", "projectId", "screenId"]
}

projectId と screenId は name（リソース名形式）に置き換えられ、非推奨になりましたが、現在は 3 つすべてが必須です。

出力

Screen オブジェクトを、htmlCode、screenshot、figmaExport のファイル参照とダウンロード URL とともに返します。

プロンプト例

PROMPT

Get the details of screen abc123 in project 12345 Show me the screen info Check the status of this screen

`generate_screen_from_text`

テキストプロンプトから新しい画面を生成します。この処理には通常数分かかります。接続エラーが発生しても再試行は避けてください。接続エラーは必ずしも失敗を意味するわけではないので、数分後に get_screen を使用してみてください。output_components に提案が含まれている場合は、ユーザーに提示します。承認された場合は、その提案を新しい prompt として再度呼び出します。

アノテーション

destructive

入力

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "description": "Required. Project ID without prefix."
    },
    "prompt": {
      "type": "string",
      "description": "Required. Text prompt describing the screen to generate."
    },
    "deviceType": {
      "type": "string",
      "enum": ["DEVICE_TYPE_UNSPECIFIED", "MOBILE", "DESKTOP", "TABLET", "AGNOSTIC"]
    },
    "modelId": {
      "type": "string",
      "enum": ["MODEL_ID_UNSPECIFIED", "GEMINI_3_PRO", "GEMINI_3_FLASH", "GEMINI_3_1_PRO"]
    }
  },
  "required": ["projectId", "prompt"]
}

GEMINI_3_PRO は非推奨です。代わりに GEMINI_3_1_PRO または GEMINI_3_FLASH を使用してください。

出力

生成された Screen オブジェクトと SessionOutputComponent のエントリ（テキスト、提案、デザイン参照）を返します。

プロンプト例

PROMPT

Generate a mobile login screen for project 12345 Design a dashboard page with charts and statistics Create a landing page with a hero section, features grid, and footer Build a settings page for a dark-themed app

`edit_screens`

テキストプロンプトを使って既存の画面を編集します。generate_screen_from_text と同様に、この処理には通常数分かかります。接続エラーが発生しても再試行は避けてください。接続エラーは必ずしも失敗を意味するわけではないので、数分後に get_screen を使用してみてください。

アノテーション

destructive

入力

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "description": "Required. Project ID without prefix."
    },
    "selectedScreenIds": {
      "type": "array",
      "items": { "type": "string" },
      "description": "Required. Screen IDs to edit, without `screens/` prefix."
    },
    "prompt": {
      "type": "string",
      "description": "Required. Edit instruction."
    },
    "deviceType": {
      "type": "string",
      "enum": ["DEVICE_TYPE_UNSPECIFIED", "MOBILE", "DESKTOP", "TABLET", "AGNOSTIC"]
    },
    "modelId": {
      "type": "string",
      "enum": ["MODEL_ID_UNSPECIFIED", "GEMINI_3_PRO", "GEMINI_3_FLASH", "GEMINI_3_1_PRO"]
    }
  },
  "required": ["projectId", "selectedScreenIds", "prompt"]
}

GEMINI_3_PRO は非推奨です。代わりに GEMINI_3_1_PRO または GEMINI_3_FLASH を使用してください。

出力

更新された Screen オブジェクトを返します。

プロンプト例

PROMPT

Change the button color to blue on screen abc123 Make the hero text larger and add a subtitle Add a navigation bar to these screens Switch the layout to a two-column grid

`generate_variants`

既存の画面のデザインバリアントを生成します。

アノテーション

destructive

入力

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "description": "Required. Project ID without prefix."
    },
    "selectedScreenIds": {
      "type": "array",
      "items": { "type": "string" },
      "description": "Required. Screen IDs to generate variants for."
    },
    "prompt": {
      "type": "string",
      "description": "Required. Text guiding variant generation."
    },
    "variantOptions": {
      "$ref": "#/$defs/VariantOptions",
      "description": "Required. Variant configuration."
    },
    "deviceType": {
      "type": "string",
      "enum": ["DEVICE_TYPE_UNSPECIFIED", "MOBILE", "DESKTOP", "TABLET", "AGNOSTIC"]
    },
    "modelId": {
      "type": "string",
      "enum": ["MODEL_ID_UNSPECIFIED", "GEMINI_3_PRO", "GEMINI_3_FLASH", "GEMINI_3_1_PRO"]
    }
  },
  "required": ["projectId", "selectedScreenIds", "prompt", "variantOptions"]
}

GEMINI_3_PRO は非推奨です。代わりに GEMINI_3_1_PRO または GEMINI_3_FLASH を使用してください。

`VariantOptions`

{
  "type": "object",
  "properties": {
    "variantCount": {
      "type": "integer",
      "description": "Number of variants (1–5). Default: 3."
    },
    "creativeRange": {
      "type": "string",
      "enum": ["CREATIVE_RANGE_UNSPECIFIED", "REFINE", "EXPLORE", "REIMAGINE"]
    },
    "aspects": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": ["VARIANT_ASPECT_UNSPECIFIED", "LAYOUT", "COLOR_SCHEME", "IMAGES", "TEXT_FONT", "TEXT_CONTENT"]
      }
    }
  }
}

出力

生成されたバリアントの Screen オブジェクトを返します。

プロンプト例

PROMPT

Generate 3 variants of screen abc123 focusing on layout and color Reimagine my landing page with radical variations Create subtle refinements of these screens Show me 5 different color schemes for this design

`create_design_system`

プロジェクト用の新しいデザインシステムを作成します。すべての画面に適用される基盤となるデザイントークン（色、タイポグラフィ、形状、外観）を定義します。

アノテーション

destructive

入力

{
  "type": "object",
  "properties": {
    "designSystem": {
      "$ref": "#/$defs/DesignSystem",
      "description": "Required. The design system to create."
    },
    "projectId": {
      "type": "string",
      "description": "Optional. Project ID. If empty, creates a global (unassociated) asset."
    }
  },
  "required": ["designSystem"]
}

`DesignSystem`

{
  "type": "object",
  "properties": {
    "displayName": {
      "type": "string",
      "description": "Required. Display name."
    },
    "theme": {
      "$ref": "#/$defs/DesignTheme",
      "description": "Required. Theme configuration."
    }
  },
  "required": ["displayName", "theme"]
}

`DesignTheme`

{
  "type": "object",
  "properties": {
    "colorMode": { "type": "string", "enum": ["COLOR_MODE_UNSPECIFIED", "LIGHT", "DARK"] },
    "headlineFont": { "type": "string", "enum": ["FONT_UNSPECIFIED", "INTER", "DM_SANS", "GEIST", "..."] },
    "bodyFont": { "type": "string", "enum": ["FONT_UNSPECIFIED", "INTER", "DM_SANS", "GEIST", "..."] },
    "labelFont": { "type": "string", "enum": ["FONT_UNSPECIFIED", "INTER", "DM_SANS", "GEIST", "..."] },
    "roundness": { "type": "string", "enum": ["ROUNDNESS_UNSPECIFIED", "ROUND_FOUR", "ROUND_EIGHT", "ROUND_TWELVE", "ROUND_FULL"] },
    "customColor": { "type": "string", "description": "Required. Hex color seed for the dynamic color system." },
    "colorVariant": { "type": "string", "enum": ["COLOR_VARIANT_UNSPECIFIED", "MONOCHROME", "NEUTRAL", "TONAL_SPOT", "VIBRANT", "EXPRESSIVE", "FIDELITY", "CONTENT", "RAINBOW", "FRUIT_SALAD"] },
    "overridePrimaryColor": { "type": "string", "description": "Optional. Override primary color (hex)." },
    "overrideSecondaryColor": { "type": "string", "description": "Optional. Override secondary color (hex)." },
    "overrideTertiaryColor": { "type": "string", "description": "Optional. Override tertiary color (hex)." },
    "overrideNeutralColor": { "type": "string", "description": "Optional. Override neutral color (hex)." },
    "designMd": { "type": "string", "description": "Optional. Markdown design instructions." }
  },
  "required": ["colorMode", "headlineFont", "bodyFont", "roundness", "customColor"]
}

出力

作成されたデザインシステムの Asset を返します。

プロンプト例

PROMPT

Create a dark mode design system with Inter font and round corners Set up a design system with blue as the primary color Create a brand identity with Geist font and minimal roundness

`update_design_system`

既存のデザインシステムを更新します。アセットは name フィールドで識別されます。

アノテーション

destructive

入力

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Required. Resource name. Format: `assets/{asset}`. Example: `assets/15996705518239280238`"
    },
    "projectId": {
      "type": "string",
      "description": "Required. Project ID without prefix."
    },
    "designSystem": {
      "$ref": "#/$defs/DesignSystem",
      "description": "Required. The updated design system content."
    }
  },
  "required": ["name", "projectId", "designSystem"]
}

create_design_system と同じ DesignSystem および DesignTheme スキーマを使用します。

出力

更新されたデザインシステムの Asset を返します。

プロンプト例

PROMPT

Update the design system to use dark mode Change the font to Geist in our design system Update the roundness to fully rounded

`list_design_systems`

プロジェクトのすべてのデザインシステムを一覧表示します（projectId がない場合は、グローバルなデザインシステムを一覧表示します）。

アノテーション

readOnly

入力

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "description": "Optional. Project ID. If empty, lists global design systems."
    }
  },
  "required": []
}

出力

デザインシステムを含む Asset オブジェクトの配列。

プロンプト例

PROMPT

List all design systems in project 12345 Show me the available design systems What design systems do I have?

`apply_design_system`

1 つ以上の画面にデザインシステムを適用し、システムのトークン（色、フォント、形状）に一致するように外観を変更します。

アノテーション

destructive

入力

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "description": "Required. Project ID without prefix."
    },
    "selectedScreenInstances": {
      "type": "array",
      "items": { "$ref": "#/$defs/SelectedScreenInstance" },
      "description": "Required. Screen instances to update (from `get_project`)."
    },
    "assetId": {
      "type": "string",
      "description": "Required. Design system asset ID (from `list_design_systems`), without `assets/` prefix."
    }
  },
  "required": ["projectId", "selectedScreenInstances", "assetId"]
}

`SelectedScreenInstance`

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Required. The screen instance ID (NOT the source screen ID). Available from `get_project`."
    },
    "sourceScreen": {
      "type": "string",
      "description": "Required. Resource name. Format: `projects/{project}/screens/{screen}`"
    }
  },
  "required": ["id", "sourceScreen"]
}

出力

更新された Screen オブジェクトを返します。

プロンプト例

PROMPT

Apply the blue design system to all screens in project 12345 Restyle these screens with the brand identity Use design system abc to update my screens

`upload_design_md`

DESIGN.md ファイルを Stitch プロジェクトにアップロードします。これは 2 段階の DESIGN.md ワークフローの最初の手順です。アップロード後に create_design_system_from_design_md を呼び出して、デザインシステムを作成します。

アノテーション

destructive

入力

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "description": "Required. Project ID (e.g., '4044680601076201931'), without `projects/` prefix."
    },
    "designMdBase64": {
      "type": "string",
      "description": "Required. Base64-encoded DESIGN.md content. The decoded content must be valid UTF-8."
    }
  },
  "required": ["projectId", "designMdBase64"]
}

出力

アップロードされた DESIGN.md を表す画面インスタンスオブジェクトを返します。このレスポンスの id と sourceScreen フィールドは、create_design_system_from_design_md への入力として必須です。

プロンプト例

PROMPT

Upload my DESIGN.md to project 12345 Add a design system document to this project Upload this markdown design file to Stitch

`create_design_system_from_design_md`

アップロードされた DESIGN.md ファイルからデザインシステムを作成し、UI に表示します。upload_design_md の後に呼び出す必要があります。

アノテーション

destructive

入力

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "description": "Required. Project ID without prefix."
    },
    "selectedScreenInstance": {
      "$ref": "#/$defs/SelectedScreenInstance",
      "description": "Required. The screen instance created by `upload_design_md`."
    },
    "deviceType": {
      "type": "string",
      "enum": ["DEVICE_TYPE_UNSPECIFIED", "MOBILE", "DESKTOP", "TABLET", "AGNOSTIC"],
      "description": "Optional. The device type for the design system."
    }
  },
  "required": ["projectId", "selectedScreenInstance"]
}

apply_design_system と同じ SelectedScreenInstance スキーマを使用します。

出力

apply_design_system で使用できる assetId を持つ DesignSystem を返します。

プロンプト例

PROMPT

Create a design system from the uploaded DESIGN.md Convert my design document into a design system Build a design system from my DESIGN.md file

共有型

`Screen`

Stitch プロジェクト内で生成された画面デザイン。

フィールド	型	説明
`name`	`string`	リソース名。形式：`projects/{project}/screens/{screen}`
`id`	`string`	（非推奨）画面 ID。
`title`	`string`	画面のタイトル。
`prompt`	`string`	画面の生成に使用されたプロンプト。
`screenshot`	`File`	画面のスクリーンショット画像。
`htmlCode`	`File`	画面の HTML コード。
`figmaExport`	`File`	画面の Figma エクスポート。
`theme`	`DesignTheme`	生成に使用されたテーマ。
`deviceType`	`DeviceType`	デバイスタイプ。
`screenType`	`ScreenType`	画面タイプ。
`screenMetadata`	`ScreenMetadata`	メタデータ（エージェント、ステータス、表示モード）。
`width`	`string`	画面の幅。
`height`	`string`	画面の高さ。
`groupId`	`string`	関連する画面（バリアントなど）のグループ ID。
`groupName`	`string`	グループの表示名。
`generatedBy`	`string`	ジェネレーターの識別子。
`isCreatedByClient`	`boolean`	API 経由のアップロードで作成された場合は `true`、エージェントによって作成された場合は `false`。

`File`

フィールド	型	説明
`name`	`string`	リソース名。形式：`projects/{project}/files/{file}`
`downloadUrl`	`string`	ダウンロード用 URL。画像の場合は FIFE ベース URL。
`mimeType`	`string`	例：`"image/png"`、`"text/html"`。
`fileContentBase64`	`string`	（書き込み専用）アップロード用の Base64 エンコードされたコンテンツ。
`uploadBlobId`	`string`	アップロードサービスから取得した BlobId。
`userFeedback`	`UserFeedback`	（読み取り専用）最新のフィードバック。

`DesignSystem`

一貫性のあるブランドデザインを生成するために使用される、視覚的・機能的なデザインガイドラインを表します。

フィールド	型	説明
`displayName`	`string`	デザインシステムの表示名。
`theme`	`DesignTheme`	テーマ設定。

`Asset`

デザインシステムリソースのラッパー（update_design_system で使用）。

フィールド	型	説明
`name`	`string`	リソース名。形式：`assets/{asset}`
`designSystem`	`DesignSystem`	デザインシステムの内容。
`version`	`string`	（読み取り専用）バージョンカウンター。`0` = バージョンなし。

`DesignTheme`

フィールド	型	必須	説明
`colorMode`	`ColorMode`	`true`	ライトモードまたはダークモード。
`headlineFont`	`Font`	`true`	見出しのタイポグラフィ。
`bodyFont`	`Font`	`true`	本文のタイポグラフィ。
`labelFont`	`Font`	`false`	ラベルのタイポグラフィ。
`roundness`	`Roundness`	`true`	角の丸み。
`customColor`	`string`	`true`	動的カラーシステムのシードカラー（16 進数、例：`"#ff0000"`）。
`colorVariant`	`ColorVariant`	`false`	動的カラーシステムのバリアント。
`overridePrimaryColor`	`string`	`false`	プライマリカラーのオーバーライド（16 進数）。
`overrideSecondaryColor`	`string`	`false`	セカンダリカラーのオーバーライド（16 進数）。
`overrideTertiaryColor`	`string`	`false`	ターシャリカラーのオーバーライド（16 進数）。
`overrideNeutralColor`	`string`	`false`	ニュートラルカラーのオーバーライド（16 進数）。
`designMd`	`string`	`false`	Markdown 形式のデザイン指示。

`ScreenMetadata`

フィールド	型	説明
`agentType`	`AgentTypeEnum`	`TURBO_AGENT`, `PRO_AGENT`, `IMAGE_AGENT`, `GENIE_AGENT`, `IMAGE_PRO_AGENT`, `HATTER_AGENT`, `GEMINI_3_AGENT`
`status`	`ScreenStatusEnum`	`IN_PROGRESS`, `COMPLETE`, `FAILED`
`statusMessage`	`string`	エージェントからの人間が判読できる形式のステータス。
`displayMode`	`DisplayModeEnum`	`SCREENSHOT`, `HTML`, `CODE`, `MARKDOWN`, `STICKY_NOTE`
`isRemixed`	`boolean`	画面がリミックスから作成されたかどうか。
`componentRegions`	`ComponentRegion[]`	コンポーネント領域のアノテーション。

`SessionOutputComponent`

生成ツールから output_components で返されます。

フィールド	型	説明
`text`	`string`	エージェントのテキスト応答。
`suggestion`	`string`	ユーザーへのフォローアップ提案。
`design`	`Design`	生成されたデザイン参照。

`UserFeedback`

フィールド	型	説明
`rating`	`string`	`POSITIVE` または `NEGATIVE`。
`comment`	`string`	追加コメント。
`designFeedbackReason`	`string`	`DESIGN_DOESNT_MATCH_PROMPT`、`EDIT_DOESNT_MATCH_PROMPT`、`COMPONENT_ISSUE`、`INCORRECT_THEME` など。

`VariantOptions`

フィールド	型	説明
`variantCount`	`integer`	生成するバリアントの数（1〜5）。デフォルト：3。
`creativeRange`	`CreativeRange`	クリエイティブの自由度。
`aspects`	`VariantAspect[]`	注目するアスペクト。

`SelectedScreenInstance`

apply_design_system と create_design_system_from_design_md で使用されます。

フィールド	型	必須	説明
`id`	`string`	`true`	画面インスタンス ID（`get_project` から取得）。ソース画面の ID ではありません。
`sourceScreen`	`string`	`true`	リソース名。形式：`projects/{project}/screens/{screen}`

列挙型

`DeviceType` 列挙型

値	説明
`DEVICE_TYPE_UNSPECIFIED`	未指定。
`MOBILE`	モバイルデバイス。
`DESKTOP`	デスクトップデバイス。
`TABLET`	タブレットデバイス。
`AGNOSTIC`	デバイスに依存しません。

`ModelId` 列挙型

値	説明
`MODEL_ID_UNSPECIFIED`	未指定。
`GEMINI_3_PRO`	（非推奨） Gemini 3 Pro。代わりに `GEMINI_3_1_PRO` または `GEMINI_3_FLASH` を使用してください。
`GEMINI_3_FLASH`	Gemini 3 Flash。
`GEMINI_3_1_PRO`	Gemini 3.1 Pro。

`ScreenType` 列挙型

値	説明
`SCREEN_TYPE_UNSPECIFIED`	デフォルトは `DESIGN`。
`DESIGN`	デザイン画面。
`IMAGE`	純粋な画像。
`PROTOTYPE`	デザインプロトタイプ。
`DOCUMENT`	ドキュメント（PRD など）。
`PROTOTYPE_V2`	デザインプロトタイプ v2。

`ColorMode` 列挙型

値	説明
`COLOR_MODE_UNSPECIFIED`	未指定。
`LIGHT`	ライトモード。
`DARK`	ダークモード。

`ColorVariant` 列挙型

値	説明
`COLOR_VARIANT_UNSPECIFIED`	未指定。
`MONOCHROME`	モノクロームバリアント。
`NEUTRAL`	ニュートラルバリアント。
`TONAL_SPOT`	トーナルスポットバリアント。
`VIBRANT`	ビブラントバリアント。
`EXPRESSIVE`	エクスプレッシブバリアント。
`FIDELITY`	フィデリティバリアント。
`CONTENT`	コンテンツバリアント。
`RAINBOW`	レインボーバリアント。
`FRUIT_SALAD`	フルーツサラダバリアント。

`Font` 列挙型

29 種のフォントファミリーをサポートしています：

INTER · DM_SANS · GEIST · SORA · MANROPE · LEXEND · EPILOGUE · BE_VIETNAM_PRO · PLUS_JAKARTA_SANS · PUBLIC_SANS · SPACE_GROTESK · SPLINE_SANS · WORK_SANS · MONTSERRAT · METROPOLIS · SOURCE_SANS_THREE · NUNITO_SANS · ARIMO · HANKEN_GROTESK · RUBIK · IBM_PLEX_SANS · NEWSREADER · NOTO_SERIF · DOMINE · LIBRE_CASLON_TEXT · EB_GARAMOND · LITERATA · SOURCE_SERIF_FOUR

`Roundness` 列挙型

値	説明
`ROUNDNESS_UNSPECIFIED`	未指定。
`ROUND_TWO`	（非推奨）丸み 2。
`ROUND_FOUR`	丸み 4。
`ROUND_EIGHT`	丸み 8。
`ROUND_TWELVE`	丸み 12。
`ROUND_FULL`	完全な丸み。

`CreativeRange` 列挙型

値	説明
`CREATIVE_RANGE_UNSPECIFIED`	未指定。
`REFINE`	元のデザインに近い、微妙な調整。
`EXPLORE`	バランスの取れた探索。（デフォルト）
`REIMAGINE`	大胆な探索。

`VariantAspect` 列挙型

値	説明
`VARIANT_ASPECT_UNSPECIFIED`	未指定。
`LAYOUT`	要素の配置。
`COLOR_SCHEME`	カラーパレット。
`IMAGES`	画像の使用方法。
`TEXT_FONT`	フォントの選択。
`TEXT_CONTENT`	テキストコンテンツ。

MCP アノテーション

MCP アノテーションは、MCP サーバーが各ツール定義に付加するメタデータヒントで、ツールの動作特性をクライアント（AI エージェントまたはホストアプリケーション）に伝えるものです。MCP 仕様の一部であり、クライアントがツールの実装を理解することなく、ツールの使用方法についてより適切な判断を下せるようにします。

各ツールには動作アノテーションが含まれています：

アノテーション	意味
`readOnlyHint`	`true` = 読み取り専用で、変更を加えません。
`destructiveHint`	`true` = リソースを作成／変更／削除する可能性があります。
`idempotentHint`	`true` = 繰り返し呼び出しても同じ結果になります。
`openWorldHint`	`true` = 外部システムとやり取りします。

実際のツールでの動作

Stitch MCP サーバーの各ツールは、ツール登録の一部としてこれらを宣言しています。例えば：

list_projects は readOnlyHint: true を持ちます。データを取得するだけなので、エージェントは副作用を気にせずに呼び出せます。
create_project は readOnlyHint: false、destructiveHint: true、idempotentHint: false を持ちます。状態を変更するため、クライアントは先にユーザーへ確認する必要があります。
generate_screen_from_text は destructiveHint: true と idempotentHint: false を持ちます。呼び出すたびに新しい画面が作成されるため、タイムアウト時に再試行すると重複が生成される可能性があります。

なぜ重要か

これらはヒントであり、強制されるルールではありません。これにより、MCP クライアントは次のことを行えます：

ユーザーに確認を求めずに、読み取り専用ツールを自動承認する
破壊的な操作に対して確認ダイアログを表示する
ネットワーク障害時に冪等なツールを安全に再試行する
openWorldHint が true の場合に外部とのやり取りを監査する

Stitch サーバーの場合、すべてのツールは openWorldHint: false です。これは、任意のサードパーティサービスではなく、Stitch バックエンドとのみやり取りするためです。

ツール

create_project

入力

出力

プロンプト例

get_project

入力

出力

プロンプト例

list_projects

入力

出力

プロンプト例

list_screens

入力

出力

プロンプト例

get_screen

入力

出力

プロンプト例

generate_screen_from_text

入力

出力

プロンプト例

edit_screens

入力

出力

プロンプト例

generate_variants

入力

VariantOptions

出力

プロンプト例

create_design_system

入力

DesignSystem

DesignTheme

出力

プロンプト例

update_design_system

入力

出力

プロンプト例

list_design_systems

入力

出力

プロンプト例

apply_design_system

入力

SelectedScreenInstance

出力

プロンプト例

upload_design_md

入力

出力

プロンプト例

create_design_system_from_design_md

入力

出力

プロンプト例

共有型

Screen

File

DesignSystem

Asset

DesignTheme

ScreenMetadata

SessionOutputComponent

UserFeedback

VariantOptions

SelectedScreenInstance

列挙型

DeviceType 列挙型

ModelId 列挙型

ScreenType 列挙型

ColorMode 列挙型

ColorVariant 列挙型

Font 列挙型

Roundness 列挙型

`create_project`

`get_project`

`list_projects`

`list_screens`

`get_screen`

`generate_screen_from_text`

`edit_screens`

`generate_variants`

`VariantOptions`

`create_design_system`

`DesignSystem`

`DesignTheme`

`update_design_system`

`list_design_systems`

`apply_design_system`

`SelectedScreenInstance`

`upload_design_md`

`create_design_system_from_design_md`

`Screen`

`File`

`DesignSystem`

`Asset`

`DesignTheme`

`ScreenMetadata`

`SessionOutputComponent`

`UserFeedback`

`VariantOptions`

`SelectedScreenInstance`

`DeviceType` 列挙型

`ModelId` 列挙型

`ScreenType` 列挙型

`ColorMode` 列挙型

`ColorVariant` 列挙型

`Font` 列挙型

`Roundness` 列挙型

`CreativeRange` 列挙型

`VariantAspect` 列挙型