An open-source, self-hostable PaaS alternative to Vercel, Heroku & Netlify that lets you easily deploy static sites, databases, full-stack applications and 360+ one-click services on your own servers.
PHP coolifydatabasesdeploymentdockerdocker-composeinertiajslaravelmariadbmysqlnextjsnodejsphppostgresredisself-hostedself-hostingserverstatic-sitesveltesvelte5
<?php
namespace App\Mcp\Concerns;
use Laravel\Mcp\Request;
use Laravel\Mcp\Response;
trait ResolvesTeam
{
/**
* Abilities that team members must not exercise (parity with ApiAbility).
*
* @var array<int, string>
*/
private const MEMBER_DISALLOWED_ABILITIES = [
'root',
'write',
'write:sensitive',
'deploy',
'read:sensitive',
];
protected function ensureAbility(Request $request, string $ability = 'read', ?string $tool = null): ?Response
{
$user = $request->user();
if (! $user) {
$this->auditMcpTool($request, $tool, 'denied', ['reason' => 'unauthenticated']);
return Response::error('Unauthenticated.');
}
$token = $user->currentAccessToken();
if (! $token) {
$this->auditMcpTool($request, $tool, 'denied', ['reason' => 'invalid_token']);
return Response::error('Invalid token.');
}
$teamId = $token->team_id;
if ($teamId !== null) {
// Fresh pivot lookup (avoid stale $user->teams cache after role changes).
$role = $user->teams()->where('teams.id', $teamId)->first()?->pivot?->role;
$isAdminOrOwner = in_array($role, ['admin', 'owner'], true);
if (! $isAdminOrOwner) {
$tokenAbilities = $token->abilities ?? [];
$disallowed = array_intersect($tokenAbilities, self::MEMBER_DISALLOWED_ABILITIES);
if ($disallowed !== [] || in_array($ability, self::MEMBER_DISALLOWED_ABILITIES, true)) {
$this->auditMcpTool($request, $tool, 'denied', [
'reason' => 'member_role',
'required_ability' => $ability,
]);
return Response::error('Missing required team role.');
}
}
}
if ($token->can('root') || $token->can($ability)) {
return null;
}
$this->auditMcpTool($request, $tool, 'denied', [
'reason' => 'missing_ability',
'required_ability' => $ability,
]);
return Response::error("Missing required permissions: {$ability}");
}
/**
* Destructive tools must call this so agents cannot cause damage or downtime without an explicit confirm=true.
*/
protected function ensureConfirmed(Request $request, string $action): ?Response
{
if (filter_var($request->get('confirm'), FILTER_VALIDATE_BOOLEAN)) {
return null;
}
return $this->mcpError($request, "{$action} requires confirm=true.");
}
/**
* Same rule as the REST API (ApiSensitiveData): a root or read:sensitive token of a team admin or owner.
*/
protected function canReadSensitiveData(Request $request): bool
{
$user = $request->user();
$token = $user?->currentAccessToken();
if (! $token || ! ($token->can('root') || $token->can('read:sensitive'))) {
return false;
}
return $token->team_id !== null && $user->isAdminOfTeam((int) $token->team_id);
}
protected function resolveTeamId(Request $request): ?int
{
$user = $request->user();
$token = $user?->currentAccessToken();
$teamId = $token?->team_id;
if (! $user || is_null($teamId) || ! $user->teams()->where('teams.id', $teamId)->exists()) {
return null;
}
return (int) $teamId;
}
protected function mcpSuccess(Request $request, Response $response, array $context = []): Response
{
$this->auditMcpTool($request, $this->name ?? null, 'success', $context);
return $response;
}
protected function mcpError(Request $request, string $message, array $context = []): Response
{
$this->auditMcpTool($request, $this->name ?? null, 'error', $context + ['reason' => $message]);
return Response::error($message);
}
protected function auditMcpTool(Request $request, ?string $tool, string $outcome, array $context = []): void
{
auditLog('mcp.tool.called', [
'tool' => $tool ?: 'unknown',
'team_id' => $this->resolveTeamId($request),
'outcome' => $outcome,
...$context,
]);
}
}