MCP ツール

Stitch CLI の統一 Model Context Protocol ツールのリファレンス。

Stitch CLI には、CLI の文法を反映した 7 つの統一的な動詞ツールを公開する組み込みの MCP サーバー(stitch mcp start / stitch mcp install)が含まれています。

ツール対応する CLI読み取り専用
stitch_createstitch createfalse
stitch_deletestitch deletefalse
stitch_editstitch editfalse
stitch_findstitch findtrue
stitch_generatestitch generatefalse
stitch_getstitch gettrue
stitch_urlstitch urltrue

ツール


stitch_create

1 つのリソースを作成します。stitch create <resource> に対応します。アトミックな作成(‘コンテキストの追加’、‘priority の作成’、‘ツールプロバイダーの接続’、‘スキルの作成’、‘画面の生成’)に使用します。{ resource, item, created } を返します。dryRun を指定すると、リクエストの正確なプレビューを返します。

アノテーション

destructive

パラメータ

フィールド型必須説明
resourcestringtrue作成するリソースの種類(project、screen、design-system、workspace、context、skill、priority、webhook、connection)。指定可能な値:project、screen、design-system、workspace、context、skill、priority、webhook、connection。
bodyobjecttrueリソースのペイロード。必須フィールド:project={}、screen={prompt}、design-system={designSystem}、workspace={displayName}、context={data, description}、skill={content, id}、priority={objective}、webhook={eventTypes, url}、connection={providerId}。完全な仕様については ‘stitch create <resource> —schema’ を実行してください。
workspacestringfalseワークスペース ID のオーバーライド。デフォルトのワークスペースが設定されていない場合、ワークスペーススコープのリソースで必須です。
projectstringfalseStitch プロジェクト ID(プロジェクトスコープのリソースで必須)。
dryRunbooleanfalseペイロードを検証し、送信せずにリクエストをプレビューします。

入力スキーマ

{
  "type": "object",
  "properties": {
    "resource": {
      "type": "string",
      "enum": [
        "project",
        "screen",
        "design-system",
        "workspace",
        "context",
        "skill",
        "priority",
        "webhook",
        "connection"
      ],
      "description": "Resource type to create (project, screen, design-system, workspace, context, skill, priority, webhook, connection)."
    },
    "body": {
      "type": "object",
      "description": "Resource payload. Required fields: project={}, screen={prompt}, design-system={designSystem}, workspace={displayName}, context={data, description}, skill={content, id}, priority={objective}, webhook={eventTypes, url}, connection={providerId}. Run 'stitch create <resource> --schema' for the full contract."
    },
    "workspace": {
      "type": "string",
      "description": "Workspace ID override. Required for workspace-scoped resources when no default workspace is configured."
    },
    "project": {
      "type": "string",
      "description": "Stitch project ID (required for project-scoped resources)."
    },
    "dryRun": {
      "type": "boolean",
      "description": "Validate payload and preview the request without sending it."
    }
  },
  "required": [
    "resource",
    "body"
  ]
}

対応する CLI コマンド

stitch create --schema

stitch_delete

ID を指定して 1 つのリソース(workspace、context、priority、webhook)を削除します。stitch delete <resource> <id> に対応します。{ resource, id, deleted } を返します。

アノテーション

destructive

パラメータ

フィールド型必須説明
resourcestringtrue削除するリソースの種類(workspace、context、priority、webhook)。指定可能な値:workspaces、workspace、contexts、context、priorities、priority、webhooks、webhook。
idstringtrue削除するリソースの ID。
workspacestringfalseワークスペース ID のオーバーライド。デフォルトのワークスペースが設定されていない場合、ワークスペーススコープのリソースで必須です。
projectstringfalseStitch Canvas プロジェクト ID(プロジェクトスコープのリソースで必須)。
dryRunbooleanfalse削除される内容をプレビューし、HTTP リクエストは送信しません。
dry-runbooleanfalse削除される内容をプレビューし、HTTP リクエストは送信しません。
confirmbooleanfalseカスケード削除されるリソース(workspace)を削除する場合は、true に設定する必要があります。

入力スキーマ

{
  "type": "object",
  "properties": {
    "resource": {
      "type": "string",
      "enum": [
        "workspaces",
        "workspace",
        "contexts",
        "context",
        "priorities",
        "priority",
        "webhooks",
        "webhook"
      ],
      "description": "Resource type to delete (workspace, context, priority, webhook)."
    },
    "id": {
      "type": "string",
      "description": "ID of the resource to delete."
    },
    "workspace": {
      "type": "string",
      "description": "Workspace ID override. Required for workspace-scoped resources when no default workspace is configured."
    },
    "project": {
      "type": "string",
      "description": "Stitch Canvas project ID (required for project-scoped resources)."
    },
    "dryRun": {
      "type": "boolean",
      "description": "Preview what would be deleted and issue no HTTP request."
    },
    "dry-run": {
      "type": "boolean",
      "description": "Preview what would be deleted and issue no HTTP request."
    },
    "confirm": {
      "type": "boolean",
      "description": "Must be set to true when deleting a cascading resource (workspace)."
    }
  },
  "required": [
    "resource",
    "id"
  ]
}

対応する CLI コマンド

stitch delete --schema

stitch_edit

1 つのリソースに部分的な更新を適用します。stitch edit <resource> <id> に対応します。変更可能なフィールドの変更(‘priority の説明の更新’、‘コンテキストの編集’、‘ワークスペースファイルの更新’、‘スキルへのパッチ適用’、‘Webhook の一時停止’、‘画面の編集’)に使用します。{ resource, item, updateMask } を返します。Canvas が編集を非同期で適用する場合(デザインシステム)、{ resource, id, status: ‘pending’, session, requested, message } を返すため、呼び出し側は後でリソースを再取得する必要があります。dryRun を指定すると、リクエストの正確なプレビューを返します。

アノテーション

destructive

パラメータ

フィールド型必須説明
resourcestringtrue編集するリソースの種類(screen、design-system、workspace、context、file、skill、priority、webhook)。指定可能な値:screen、design-system、workspace、context、file、skill、priority、webhook。
idstringtrue編集するリソースの ID。画面の場合は projects/<p>/screens/<s> または Stitch キャンバス URL も使用でき、そこで指定されたプロジェクトが使われます。
patchobjecttrue更新するフィールド。編集可能なフィールドについては ‘stitch edit <resource> —schema’ を実行してください。
updateMaskstringfalse更新するフィールドパスのカンマ区切りリスト。省略した場合は patch のキーから導出されます。
workspacestringfalseワークスペース ID のオーバーライド。デフォルトのワークスペースが設定されていない場合、ワークスペーススコープのリソースで必須です。
projectstringfalseStitch プロジェクト ID(プロジェクトスコープのリソースで必須)。
dryRunbooleanfalseリソースを変更せずにリクエストをプレビューします。

入力スキーマ

{
  "type": "object",
  "properties": {
    "resource": {
      "type": "string",
      "enum": [
        "screen",
        "design-system",
        "workspace",
        "context",
        "file",
        "skill",
        "priority",
        "webhook"
      ],
      "description": "Resource type to edit (screen, design-system, workspace, context, file, skill, priority, webhook)."
    },
    "id": {
      "type": "string",
      "description": "ID of the resource to edit. For screens, also accepts projects/<p>/screens/<s> or a Stitch canvas URL; the project it names is used."
    },
    "patch": {
      "type": "object",
      "description": "Fields to update. Run 'stitch edit <resource> --schema' for the editable fields."
    },
    "updateMask": {
      "type": "string",
      "description": "Comma-separated field paths to update. Derived from patch keys when omitted."
    },
    "workspace": {
      "type": "string",
      "description": "Workspace ID override. Required for workspace-scoped resources when no default workspace is configured."
    },
    "project": {
      "type": "string",
      "description": "Stitch project ID (required for project-scoped resources)."
    },
    "dryRun": {
      "type": "boolean",
      "description": "Preview the request without modifying the resource."
    }
  },
  "required": [
    "resource",
    "id",
    "patch"
  ]
}

対応する CLI コマンド

stitch edit --schema

stitch_find

指定した種類のリソース(projects、screens、design-systems、workspaces、contexts、files、skills、priorities、webhooks、insights、solutions、connections、organizations)を一覧表示します。stitch find <resource> に対応します。{ resource, items, returnedCount, isTruncated, nextPageToken } を返します。詳細を確認するには、特定の ID に対して stitch_get を続けて呼び出してください。

アノテーション

readOnly

パラメータ

フィールド型必須説明
resourcestringtrue一覧表示するリソースの種類(projects、screens、design-systems、workspaces、contexts、files、skills、priorities、webhooks、insights、solutions、connections、organizations)。指定可能な値:projects、project、screens、screen、design-systems、design-system、workspaces、workspace、contexts、context、files、file、skills、skill、priorities、priority、webhooks、webhook、insights、insight、solutions、solution、connections、connection、toolProvider、toolProviders、tool-provider、tool-providers、organizations、organization。
criteriaobjectfalseリソース固有のフィルター条件(例:{ id: ‘i-1’ })。
workspacestringfalseワークスペース ID のオーバーライド。デフォルトのワークスペースが設定されていない場合、ワークスペーススコープのリソースで必須です。
projectstringfalseStitch Canvas プロジェクト ID(プロジェクトスコープのリソースで必須)。
limitintegerfalse返す項目の最大数(デフォルト 50)。
pageSizeintegerfalseAPI に要求する 1 ページあたりの項目数(デフォルトは limit)。
pageTokenstringfalse以前の結果の nextPageToken から再開します。Canvas リソースではサポートされていません。
filterstringfalseAIP-160 フィルター式。
includearrayfalse各項目に取り込む関連コレクション。

入力スキーマ

{
  "type": "object",
  "properties": {
    "resource": {
      "type": "string",
      "enum": [
        "projects",
        "project",
        "screens",
        "screen",
        "design-systems",
        "design-system",
        "workspaces",
        "workspace",
        "contexts",
        "context",
        "files",
        "file",
        "skills",
        "skill",
        "priorities",
        "priority",
        "webhooks",
        "webhook",
        "insights",
        "insight",
        "solutions",
        "solution",
        "connections",
        "connection",
        "toolProvider",
        "toolProviders",
        "tool-provider",
        "tool-providers",
        "organizations",
        "organization"
      ],
      "description": "Resource type to list (projects, screens, design-systems, workspaces, contexts, files, skills, priorities, webhooks, insights, solutions, connections, organizations)."
    },
    "criteria": {
      "type": "object",
      "description": "Resource-specific filter criteria (e.g. { id: 'i-1' })."
    },
    "workspace": {
      "type": "string",
      "description": "Workspace ID override. Required for workspace-scoped resources when no default workspace is configured."
    },
    "project": {
      "type": "string",
      "description": "Stitch Canvas project ID (required for project-scoped resources)."
    },
    "limit": {
      "type": "integer",
      "description": "Maximum number of items to return (default 50)."
    },
    "pageSize": {
      "type": "integer",
      "description": "Items per page requested from the API (defaults to limit)."
    },
    "pageToken": {
      "type": "string",
      "description": "Resume from a previous result's nextPageToken. Not supported for Canvas resources."
    },
    "filter": {
      "type": "string",
      "description": "AIP-160 filter expression."
    },
    "include": {
      "type": "array",
      "description": "Related collections to pull into each item."
    }
  },
  "required": [
    "resource"
  ]
}

対応する CLI コマンド

stitch find --schema

stitch_generate

バックエンドの生成ジョブ(insights、solutions)を開始します。stitch generate <resource> に対応します。{ resource, workspace, started, complete } を返します(生成は非同期で実行されるため complete は false です。stitch_find でポーリングしてください)。

アノテーション

destructive

パラメータ

フィールド型必須説明
resourcestringtrue生成するリソースの種類(insights、solutions)。指定可能な値:insights、insight、solutions、solution。
prioritiesarrayfalse生成の対象範囲を指定する priority ID(resource=‘insights’ の場合のみ適用。省略するとワークスペース全体を対象に生成します)。
insightsarrayfalseソリューションを生成する対象のインサイト ID(resource=‘solutions’ の場合は必須。resource=‘solutions’ の場合のみ適用)。
delayExecutionbooleanfalseエージェントの実行をすぐに開始せず、再スケジュールします(resource=‘insights’ の場合のみ適用)。
replaceExistingbooleanfalse既存の未割り当てソリューションに追加するのではなく、置き換えます(resource=‘solutions’ の場合のみ適用)。
workspacestringfalseワークスペース ID のオーバーライド。デフォルトのワークスペースが設定されていない場合は必須です。
dryRunbooleanfalse生成ジョブを開始せずに引数を検証し、対象範囲をプレビューします。
dry-runbooleanfalse生成ジョブを開始せずに引数を検証し、対象範囲をプレビューします。

入力スキーマ

{
  "type": "object",
  "properties": {
    "resource": {
      "type": "string",
      "enum": [
        "insights",
        "insight",
        "solutions",
        "solution"
      ],
      "description": "Resource type to generate (insights, solutions)."
    },
    "priorities": {
      "type": "array",
      "description": "Priority IDs to scope generation to (applies to resource='insights' only; omit to generate across the entire workspace)."
    },
    "insights": {
      "type": "array",
      "description": "Insight IDs to generate solutions for (required when resource='solutions'; applies to resource='solutions' only)."
    },
    "delayExecution": {
      "type": "boolean",
      "description": "Reschedule the agent run rather than starting immediately (applies to resource='insights' only)."
    },
    "replaceExisting": {
      "type": "boolean",
      "description": "Replace existing unassigned solutions instead of adding to them (applies to resource='solutions' only)."
    },
    "workspace": {
      "type": "string",
      "description": "Workspace ID override. Required when no default workspace is configured."
    },
    "dryRun": {
      "type": "boolean",
      "description": "Validate arguments and preview scope without starting a generation job."
    },
    "dry-run": {
      "type": "boolean",
      "description": "Validate arguments and preview scope without starting a generation job."
    }
  },
  "required": [
    "resource"
  ]
}

対応する CLI コマンド

stitch generate --schema

stitch_get

ID を指定して 1 つのリソース(project、screen、design-system、status、workspace、context、file、skill、priority、webhook、insight、solution、connection、organization)を取得します。stitch get <resource> <id> に対応します。{ resource, item, availableActions? } を返します。availableActions で示されたツールを続けて呼び出してください。

アノテーション

readOnly

パラメータ

フィールド型必須説明
resourcestringtrue取得するリソースの種類(project、screen、design-system、status、workspace、context、file、skill、priority、webhook、insight、solution、connection、organization)。指定可能な値:projects、project、screens、screen、design-systems、design-system、status、workspaces、workspace、contexts、context、files、file、skills、skill、priorities、priority、webhooks、webhook、insights、insight、solutions、solution、connections、connection、toolProvider、toolProviders、tool-provider、tool-providers、organizations、organization。
idstringfalse取得するリソースの ID。‘status’ を除くすべてのリソースで必須です。‘status’ の場合は id を省略する必要があります。
workspacestringfalseワークスペース ID のオーバーライド。デフォルトのワークスペースが設定されていない場合、ワークスペーススコープのリソースで必須です。
projectstringfalseStitch Canvas プロジェクト ID(プロジェクトスコープのリソースで必須)。

入力スキーマ

{
  "type": "object",
  "properties": {
    "resource": {
      "type": "string",
      "enum": [
        "projects",
        "project",
        "screens",
        "screen",
        "design-systems",
        "design-system",
        "status",
        "workspaces",
        "workspace",
        "contexts",
        "context",
        "files",
        "file",
        "skills",
        "skill",
        "priorities",
        "priority",
        "webhooks",
        "webhook",
        "insights",
        "insight",
        "solutions",
        "solution",
        "connections",
        "connection",
        "toolProvider",
        "toolProviders",
        "tool-provider",
        "tool-providers",
        "organizations",
        "organization"
      ],
      "description": "Resource type to fetch (project, screen, design-system, status, workspace, context, file, skill, priority, webhook, insight, solution, connection, organization)."
    },
    "id": {
      "type": "string",
      "description": "ID of the resource to fetch. Required for every resource except 'status', where id must be omitted."
    },
    "workspace": {
      "type": "string",
      "description": "Workspace ID override. Required for workspace-scoped resources when no default workspace is configured."
    },
    "project": {
      "type": "string",
      "description": "Stitch Canvas project ID (required for project-scoped resources)."
    }
  },
  "required": [
    "resource"
  ]
}

対応する CLI コマンド

stitch get --schema

stitch_url

ネットワーク I/O を一切行わずに、プロジェクトまたは画面の正規の Stitch Canvas Web URL を返します。stitch url <resource> <id> に対応します。stitch.google.com の URL を推測する代わりに、ユーザーがリンク(‘open in Stitch’、‘get canvas URL’、‘link to screen’)を求めたときに使用します。{ resource, id, url, verified: false } を返します。

アノテーション

readOnly

パラメータ

フィールド型必須説明
resourcestringtrueURL を構築する Stitch Canvas リソースの種類(project または screen)。指定可能な値:project、screen。
idstringtrueプロジェクトまたは画面の ID(ベア ID、または ‘projects/<p>/screens/<s>’ のような完全なリソース名を使用できます)。
projectstringfalse画面を所有するプロジェクト ID(resource=‘screen’ で、‘id’ が完全な ‘projects/<p>/screens/<s>’ 形式のリソース名でない場合に必須)。

入力スキーマ

{
  "type": "object",
  "properties": {
    "resource": {
      "type": "string",
      "enum": [
        "project",
        "screen"
      ],
      "description": "Stitch Canvas resource type to construct a URL for (project or screen)."
    },
    "id": {
      "type": "string",
      "description": "ID of the project or screen (accepts a bare ID or a full resource name like 'projects/<p>/screens/<s>')."
    },
    "project": {
      "type": "string",
      "description": "Project ID that owns the screen (required when resource='screen' and 'id' is not a full 'projects/<p>/screens/<s>' resource name)."
    }
  },
  "required": [
    "resource",
    "id"
  ]
}

対応する CLI コマンド

stitch url --schema

原文: https://stitch.withgoogle.com/docs/cli/reference/mcp-tools/

本ページは Google Stitch 公式ドキュメントの翻訳です。原文の著作権は Google LLC に帰属します。本サイトは独立した非公式の翻訳です。