Skip to content

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.

4.2 KB
Raw Blame
<?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,
        ]);
    }
}