Recursos

Recursos de contexto expuestos a clientes MCP.

Los clientes MCP deben leer los recursos antes de elegir los ID para las llamadas a herramientas.

URI	Contenidos
`epismo://context/current_user`	Usuario/cuenta/espacio de trabajo actual JSON
`epismo://context/projects`	Proyectos accesibles en el espacio de trabajo seleccionado
`epismo://context/users`	Usuarios del espacio de trabajo visibles para la persona que llama
`epismo://context/agents`	Agentes instalados disponibles para asignación

Los encargados de tareas pueden utilizar ID de usuario o ID de agente. Los asignados a los pasos del paquete de flujo de trabajo utilizan human o ID de agente únicamente.

Cargas útiles de recursos

Los recursos devuelven JSON. El recurso de usuario actual incluye el ID de usuario autenticado, el ID de cuenta y el espacio de trabajo cuando el token de portador tiene un ámbito de espacio de trabajo.

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

Los proyectos, usuarios y agentes devuelven matrices con ID y nombres para mostrar. Utilice esos ID en los argumentos de la herramienta en lugar de pedirle a un agente que infiera los ID a partir de etiquetas visibles.

Campos de acceso

Las herramientas de mutación utilizan scope y sharedWith. Crear herramientas y epismo_track_apply requieren scope; Las herramientas de actualización pueden omitir scope y sharedWith para preservar el acceso existente.

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

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

Utilice sharedWith cuando el acceso privado deba incluir usuarios específicos fuera del alcance del proyecto seleccionado.

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

Las herramientas de búsqueda utilizan scopes para elegir dónde se buscan los resultados privados.

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