Resources

MCP client に公開される context resources です。


MCP client は tool call に使う ID を決める前に resources を読むべきです。

URI 内容
epismo://context/current_user Current user/account/workspace JSON
epismo://context/projects 選択 workspace で accessible な projects
epismo://context/users Caller から見える workspace users
epismo://context/agents Assignment に使える installed agents

Task assignee は user ID または agent ID を使えます。Workflow pack step assignee は human または agent ID のみです。

Resource payloads

Resources は JSON を返します。Current user resource には authenticated user ID、account ID、bearer token が workspace-scoped の場合は workspace が含まれます。

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

Projects、users、agents は ID と display name を含む array を返します。Tool arguments では、visible label から agent に推測させず、この ID を使ってください。

Access fields

Mutation tools は scopesharedWith を使います。Create tools と epismo_track_apply では scope が必須です。Update tools は scopesharedWith を省略すると existing access を維持します。

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

Selected project scope の外にいる特定 user に private access を追加する場合は sharedWith を使います。

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

Search tools は private results の検索範囲を scopes で指定します。

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