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.

feat(mcp): add per-team server toggle

Andras Bacsaibef94a9ce285
diff --git a/app/Http/Kernel.php b/app/Http/Kernel.php
index 02a49aaa81..9e8dee83e6 100644
--- a/app/Http/Kernel.php
+++ b/app/Http/Kernel.php
@@ -12,6 +12,7 @@ use App\Http\Middleware\CheckForcePasswordReset;
use App\Http\Middleware\DecideWhatToDoWithUser;
use App\Http\Middleware\EncryptCookies;
use App\Http\Middleware\EnsureMcpEnabled;
+use App\Http\Middleware\EnsureTeamMcpEnabled;
use App\Http\Middleware\EnsureTokenBelongsToCurrentTeamMember;
use App\Http\Middleware\PreventRequestsDuringMaintenance;
use App\Http\Middleware\RedirectIfAuthenticated;
@@ -110,5 +111,6 @@ class Kernel extends HttpKernel
'can.update.resource' => CanUpdateResource::class,
'can.access.terminal' => CanAccessTerminal::class,
'mcp.enabled' => EnsureMcpEnabled::class,
+ 'mcp.team.enabled' => EnsureTeamMcpEnabled::class,
];
}
diff --git a/app/Http/Middleware/EnsureTeamMcpEnabled.php b/app/Http/Middleware/EnsureTeamMcpEnabled.php
new file mode 100644
index 0000000000..5c76d2a1b1
--- /dev/null
+++ b/app/Http/Middleware/EnsureTeamMcpEnabled.php
@@ -0,0 +1,26 @@
+<?php
+
+namespace App\Http\Middleware;
+
+use Closure;
+use Illuminate\Http\Request;
+use Symfony\Component\HttpFoundation\Response;
+
+class EnsureTeamMcpEnabled
+{
+ public function handle(Request $request, Closure $next): Response
+ {
+ $user = $request->user();
+ $teamId = $user?->currentAccessToken()?->team_id;
+
+ $team = $user?->teams()
+ ->where('teams.id', $teamId)
+ ->first();
+
+ if (! $team?->is_mcp_server_enabled) {
+ return response()->json(['message' => 'MCP server is disabled for this team.'], 403);
+ }
+
+ return $next($request);
+ }
+}
diff --git a/app/Livewire/Team/Index.php b/app/Livewire/Team/Index.php
index 140d9f5cca..406d385daa 100644
--- a/app/Livewire/Team/Index.php
+++ b/app/Livewire/Team/Index.php
@@ -24,11 +24,14 @@ class Index extends Component
public ?string $description = null;
+ public bool $is_mcp_server_enabled = true;
+
protected function rules(): array
{
return [
'name' => ValidationPatterns::nameRules(),
'description' => ValidationPatterns::descriptionRules(),
+ 'is_mcp_server_enabled' => 'boolean',
];
}
@@ -58,10 +61,12 @@ class Index extends Component
// Sync TO model (before save)
$this->team->name = $this->name;
$this->team->description = $this->description;
+ $this->team->is_mcp_server_enabled = $this->is_mcp_server_enabled;
} else {
// Sync FROM model (on load/refresh)
$this->name = $this->team->name;
$this->description = $this->team->description;
+ $this->is_mcp_server_enabled = $this->team->is_mcp_server_enabled;
}
}
diff --git a/app/Models/Team.php b/app/Models/Team.php
index 23e2badb3e..a979b44fbd 100644
--- a/app/Models/Team.php
+++ b/app/Models/Team.php
@@ -47,10 +47,12 @@ class Team extends Model implements SendsDiscord, SendsEmail, SendsPushover, Sen
'personal_team',
'show_boarding',
'custom_server_limit',
+ 'is_mcp_server_enabled',
];
protected $casts = [
'personal_team' => 'boolean',
+ 'is_mcp_server_enabled' => 'boolean',
];
protected static function booted()
diff --git a/database/migrations/2026_06_25_000000_add_is_mcp_server_enabled_to_teams_table.php b/database/migrations/2026_06_25_000000_add_is_mcp_server_enabled_to_teams_table.php
new file mode 100644
index 0000000000..3162a86135
--- /dev/null
+++ b/database/migrations/2026_06_25_000000_add_is_mcp_server_enabled_to_teams_table.php
@@ -0,0 +1,22 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+ public function up(): void
+ {
+ Schema::table('teams', function (Blueprint $table) {
+ $table->boolean('is_mcp_server_enabled')->default(true);
+ });
+ }
+
+ public function down(): void
+ {
+ Schema::table('teams', function (Blueprint $table) {
+ $table->dropColumn('is_mcp_server_enabled');
+ });
+ }
+};
diff --git a/resources/views/livewire/settings/advanced.blade.php b/resources/views/livewire/settings/advanced.blade.php
index 544ed7d4cf..fb7da30a74 100644
--- a/resources/views/livewire/settings/advanced.blade.php
+++ b/resources/views/livewire/settings/advanced.blade.php
@@ -72,7 +72,7 @@
@endif
<h4 class="pt-4">MCP Server</h4>
<div class="md:w-96">
- <x-forms.checkbox instantSave id="is_mcp_server_enabled" label="Enable MCP Server"
+ <x-forms.checkbox instantSave id="is_mcp_server_enabled" label="Enable MCP Server Instance-wide"
helper="Exposes a Streamable HTTP Model Context Protocol endpoint at /mcp for AI clients (Claude Desktop, Cursor, etc.). Authenticates via Sanctum API tokens (Security > API Tokens). Requires API Access to be enabled." />
</div>
@if ($is_mcp_server_enabled)
diff --git a/resources/views/livewire/team/index.blade.php b/resources/views/livewire/team/index.blade.php
index 8f54a57e35..0fbbb114f6 100644
--- a/resources/views/livewire/team/index.blade.php
+++ b/resources/views/livewire/team/index.blade.php
@@ -13,6 +13,8 @@
<div class="flex items-end gap-2 pb-6">
<x-forms.input id="name" label="Name" required canGate="update" :canResource="$team" />
<x-forms.input id="description" label="Description" canGate="update" :canResource="$team" />
+ <x-forms.checkbox id="is_mcp_server_enabled" label="Enable MCP Server" canGate="update" :canResource="$team"
+ helper="Allows this team's API tokens to use the instance MCP endpoint when MCP is enabled instance-wide." />
@can('update', $team)
<x-forms.button type="submit">
Save
diff --git a/routes/ai.php b/routes/ai.php
index 3a39677ff4..d79ff0ebae 100644
--- a/routes/ai.php
+++ b/routes/ai.php
@@ -4,4 +4,4 @@ use App\Mcp\Servers\CoolifyServer;
use Laravel\Mcp\Facades\Mcp;
Mcp::web('/mcp', CoolifyServer::class)
- ->middleware(['mcp.enabled', 'auth:sanctum', 'api.token.team']);
+ ->middleware(['mcp.enabled', 'auth:sanctum', 'api.token.team', 'mcp.team.enabled']);
diff --git a/tests/Feature/Authorization/TeamAuthorizationTest.php b/tests/Feature/Authorization/TeamAuthorizationTest.php
index e99e55a2c1..6cfc26d995 100644
--- a/tests/Feature/Authorization/TeamAuthorizationTest.php
+++ b/tests/Feature/Authorization/TeamAuthorizationTest.php
@@ -126,6 +126,18 @@ test('member cannot submit team settings via policy', function () {
expect(auth()->user()->can('update', $this->team))->toBeFalse();
});
+test('owner can update team MCP setting', function () {
+ $this->actingAs($this->owner);
+ session(['currentTeam' => $this->team]);
+
+ Livewire::test(TeamIndex::class)
+ ->set('is_mcp_server_enabled', false)
+ ->call('submit')
+ ->assertDispatched('success');
+
+ expect($this->team->fresh()->is_mcp_server_enabled)->toBeFalse();
+});
+
// --- Team Index Livewire: delete ---
test('member cannot delete team via index', function () {
diff --git a/tests/Feature/Mcp/McpEndpointTest.php b/tests/Feature/Mcp/McpEndpointTest.php
index b8511afef3..f70584ecb1 100644
--- a/tests/Feature/Mcp/McpEndpointTest.php
+++ b/tests/Feature/Mcp/McpEndpointTest.php
@@ -90,6 +90,16 @@ test('MCP endpoint returns 404 when the instance setting is disabled', function
$response->assertStatus(404);
});
+test('MCP endpoint returns 403 when the token team has MCP disabled', function () {
+ $this->team->update(['is_mcp_server_enabled' => false]);
+ $token = $this->user->createToken('mcp-read', ['read'])->plainTextToken;
+
+ $response = mcpListTools($token);
+
+ $response->assertForbidden();
+ $response->assertJson(['message' => 'MCP server is disabled for this team.']);
+});
+
test('MCP endpoint rejects unauthenticated requests', function () {
$response = mcpPost(['jsonrpc' => '2.0', 'id' => 1, 'method' => 'tools/list']);
$response->assertStatus(401);