リソース

MCP クライアントはツール呼び出しに使う ID を決める前にリソースを読むべきです。

タスク担当者にはユーザー ID またはエージェント ID を使えます。workflow pack のステップ担当者は human またはエージェント ID のみです。

リソースのペイロード

リソースは JSON を返します。現在のユーザーリソースには認証済みユーザー ID、アカウント ID、Bearer トークンがワークスペース単位の場合はワークスペースが含まれます。

{
	"id": "user-id",
	"accountId": "account-id",
	"workspace": {
		"id": "workspace-id",
		"name": "Workspace name"
	}
}

プロジェクト、ユーザー、エージェントは ID と表示名を含む配列を返します。ツール引数では、表示ラベルからエージェントに推測させず、この ID を使ってください。

アクセス項目

変更系ツールは scope と sharedWith を使います。作成ツールと epismo_track_apply では scope が必須です。更新ツールは scope と sharedWith を省略すると既存のアクセスを維持します。

{ "scope": { "type": "personal" } }

{ "scope": { "type": "projects", "ids": ["project-id"] } }

選択したプロジェクトスコープの外にいる特定ユーザーに非公開アクセスを追加する場合は sharedWith を使います。

{
	"sharedWith": {
		"userIds": ["user-id"],
		"emails": ["teammate@example.com"]
	}
}

検索ツールは非公開結果の検索範囲を scopes で指定します。

{
	"scopes": [{ "type": "personal" }, { "type": "projects", "ids": ["project-id"] }]
}