MCP

Je kunt MCP-servers gebruiken door ze op te geven in mcpServers van de SessionConfig. Gebruik je Laravel Boost met de Copilot CLI, gebruik dan ook laravel-boost-copilot-cli. Het is bekend dat 'type' => 'stdio' (of 'local') en 'tools' => ['*'] verplicht zijn. Zonder deze wordt de server niet als MCP-server herkend. args is optioneel.

Artisan::command('copilot:mcp', function () {
    $config = new SessionConfig(
        mcpServers: [
            'laravel-boost' => [
                'type' => 'stdio',
                'command' => 'php',
                'args' => ['artisan', 'boost:mcp'],
                'tools' => ['*'],
            ],
        ],
    );

    Copilot::start(function (CopilotSession $session) {
        info('Starting Copilot with Laravel Boost MCP: '.$session->id());

        $prompt = 'Welke MCP\'s zijn er geladen? Als laravel-boost beschikbaar is, haal dan de app-informatie op met application-info.';

        warning($prompt);

        $response = spin(
            callback: fn () => $session->sendAndWait($prompt),
            message: 'Thinking...',
        );

        note($response->content());
    }, config: $config);
});

MCP Apps (experimenteel)

Gebruik in een sessie waarin enableMcpApps is ingeschakeld $session->rpc()->mcp()->apps() om met tools en resources van MCP Apps te werken. listTools() retourneert de tools die een app kan aanroepen, callTool() voert een tool uit en readResource() haalt een ui://-resource op, zoals HTML. listTools() en callTool() vereisen originServerName, dat de aanroepende server identificeert. Gebruik getHostContext() en setHostContext() om hostcontext zoals het thema en de locale te lezen en te schrijven. diagnose() retourneert de status van de MCP Apps-ondersteuning van de server.

use Revolution\Copilot\Types\Rpc\MCPAppsDiagnoseRequest;
use Revolution\Copilot\Types\Rpc\MCPAppsListToolsRequest;
use Revolution\Copilot\Types\Rpc\McpAppsCallToolRequest;
use Revolution\Copilot\Types\Rpc\McpAppsReadResourceRequest;
use Revolution\Copilot\Types\Rpc\McpAppsSetHostContextDetails;
use Revolution\Copilot\Types\Rpc\McpAppsSetHostContextRequest;

$apps = $session->rpc()->mcp()->apps();

$tools = $apps->listTools(new MCPAppsListToolsRequest(
    serverName: 'my-server',
    originServerName: 'my-server',
));

$result = $apps->callTool(new McpAppsCallToolRequest(
    serverName: 'my-server',
    toolName: 'lookup',
    originServerName: 'my-server',
    arguments: ['query' => 'hello'],
));

$resource = $apps->readResource(new McpAppsReadResourceRequest(
    serverName: 'my-server',
    uri: 'ui://my-app/index.html',
));

$context = $apps->getHostContext();
$apps->setHostContext(new McpAppsSetHostContextRequest(
    context: new McpAppsSetHostContextDetails(theme: 'dark', locale: 'nl-NL'),
));

$diagnostics = $apps->diagnose(new MCPAppsDiagnoseRequest(serverName: 'my-server'));

callTool() retourneert een vrij vormgegeven MCP-resultaat. De SDK biedt RPC’s om gegevens op te halen en in te stellen, maar rendert de opgehaalde HTML niet en beheert geen iframes. Implementeer het renderen in je applicatie, bijvoorbeeld met Livewire of Inertia.

MCP OAuth-tokens vanuit de host aanleveren

Vereist een MCP-server OAuth-authenticatie, gebruik dan onMcpAuthRequest om de authenticatie in je applicatie af te handelen. De callback ontvangt een McpAuthRequest en een context-array met sessionId. Retourneer een McpAuthToken om het token door te geven aan de CLI-runtime. Retourneer null of een McpAuthResult met kind: 'cancelled' om de authenticatie te annuleren.

use Revolution\Copilot\Types\McpAuthRequest;
use Revolution\Copilot\Types\McpAuthResult;
use Revolution\Copilot\Types\McpAuthToken;
use Revolution\Copilot\Types\SessionConfig;

$config = new SessionConfig(
    mcpServers: [
        'private-mcp' => [
            'type' => 'http',
            'url' => 'https://mcp.example.com',
        ],
    ],
    onMcpAuthRequest: function (McpAuthRequest $request, array $context): McpAuthToken|McpAuthResult|null {
        // Haal een token op uit de eigen credentialservice van je applicatie
        $accessToken = $credentialProvider->tokenFor($request->serverName);

        return $accessToken === null
            ? new McpAuthResult(kind: 'cancelled')
            : new McpAuthToken(accessToken: $accessToken, tokenType: 'Bearer');
    },
);

McpAuthRequest bevat requestId, serverName, serverUrl en reason (initial, refresh, reauth of upscope). Wanneer je de handler instelt, abonneert de SDK zich automatisch op mcp.oauth_required-events. Zo kun je authenticeren in contexten waarin geen browser kan worden geopend, zoals webrequests, queues en batches. Geef bij het hervatten van een sessie dezelfde handler mee in ResumeSessionConfig.

Ondersteuning voor MCP OAuth controleren (Server RPC)

Nadat een externe MCP-server om OAuth-authenticatie heeft gevraagd, kun je met Server RPC controleren of deze Dynamic Client Registration (DCR) ondersteunt. authorizationServerUrl wordt geretourneerd wanneer de autorisatieserver via metadata kan worden gevonden. Is supportsDcr false, dan is dynamische registratie niet beschikbaar.

use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Types\Rpc\McpOauthCheckDcrSupportRequest;
use Revolution\Copilot\Types\Rpc\McpOauthIsMicrosoftAuthorizationServerRequest;

$oauth = Copilot::client()->rpc()->mcp()->oauth();

$dcr = $oauth->checkDcrSupport(new McpOauthCheckDcrSupportRequest(
    serverUrl: 'https://mcp.example.com',
    resourceMetadataText: $challengeMetadata,
    sessionId: $session->id(),
));

$isMicrosoft = $dcr->authorizationServerUrl === null
    ? false
    : $oauth->isMicrosoftAuthorizationServer(new McpOauthIsMicrosoftAuthorizationServerRequest(
        authorizationServerUrl: $dcr->authorizationServerUrl,
    ))->isMicrosoftAuthorizationServer;

resourceMetadataText is de metadata van de beschermde resource uit de WWW-Authenticate-challenge. Laat je deze weg, dan wordt de autorisatieserver gevonden via de server-URL. Geef je sessionId mee, dan gelden het bestemmingsbeleid en de sandboxproxy van die lokale sessie. Microsoft Entra ID ondersteunt geen DCR. Is de autorisatieserver van Microsoft, dan kun je een vooraf geregistreerde client gebruiken in plaats van de gebruiker om clientgegevens te vragen. Dit zijn Server RPC’s (Copilot::client()->rpc()). Ze vormen een aparte namespace naast de sessie-RPC $session->rpc()->mcp()->oauth(), die login- en OAuth-verzoeken afhandelt.

Status van MCP-servers

De status van een MCP-server binnen een session kan de volgende waarden hebben:

Status	Beschrijving
`connected`	Verbonden
`failed`	Verbinding mislukt
`needs-auth`	Authenticatie vereist
`pending`	Wacht op verbinding
`disabled`	Uitgeschakeld
`not_configured`	Niet geconfigureerd

Elke server die $session->rpc()->mcp()->listConfigured() retourneert, kan zijn waargenomen runtimestatus bevatten als live. Zet deze om naar een getypeerd object met McpConfiguredServerState::fromArray($server['live']). De optionele bool toolsLoaded op McpConfiguredServerState geeft aan of de huidige verbinding de lijst met tools heeft geladen. Heeft de runtime dit niet gerapporteerd, dan is toolsLoaded null; behandel een ontbrekende waarde dus niet als false.

use Revolution\Copilot\Types\Rpc\McpConfiguredServerState;

foreach ($session->rpc()->mcp()->listConfigured()['servers'] ?? [] as $server) {
    if (isset($server['live'])) {
        $state = McpConfiguredServerState::fromArray($server['live']);

        dump($state->status->value, $state->toolsLoaded);
    }
}

Een connected-status alleen betekent niet dat de tools zijn geladen. Luister naar het event session.mcp_server_tools_loaded om te weten wanneer de lijst met tools van een server beschikbaar is. Dit kortstondige event wordt één keer per verbinding afgevuurd met data.serverName en data.toolCount, en wordt niet opgeslagen. Wanneer gecachete tools worden gebruikt, kan het vóór connected binnenkomen.

MCP-serverconfiguratie beheren (Server RPC)

Los van sessions kun je de configuratie van MCP-servers op serverniveau beheren.

use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Types\Rpc\McpConfigAddRequest;
use Revolution\Copilot\Types\Rpc\McpConfigUpdateRequest;
use Revolution\Copilot\Types\Rpc\McpConfigRemoveRequest;
use Revolution\Copilot\Types\Rpc\McpServerValue;

// Haal de lijst met geconfigureerde MCP-servers op
$result = Copilot::client()->rpc()->mcp()->list();
foreach ($result->servers as $name => $config) {
    dump($name, $config->type, $config->command);
}

// Voeg een MCP-server toe
Copilot::client()->rpc()->mcp()->add(new McpConfigAddRequest(
    name: 'laravel-boost',
    config: new McpServerValue(
        type: 'stdio',
        command: 'php',
        args: ['artisan', 'boost:mcp'],
        tools: ['*'],
    ),
));

// Werk de configuratie van een MCP-server bij
Copilot::client()->rpc()->mcp()->update(new McpConfigUpdateRequest(
    name: 'laravel-boost',
    config: new McpServerValue(
        type: 'stdio',
        command: 'php',
        args: ['artisan', 'boost:mcp', '--verbose'],
        tools: ['*'],
    ),
));

// Verwijder een MCP-server
Copilot::client()->rpc()->mcp()->remove(new McpConfigRemoveRequest(name: 'laravel-boost'));

Uitgeschakelde servers bij het herladen van MCP

Wanneer je configuratie doorgeeft aan reloadWithConfig(), is configuredDisabledServers de lijst met servers die zijn uitgeschakeld door instellingen die je applicatie heeft opgelost. Geef deze apart op van disabledServers op sessieniveau en cliEnabledServers van de CLI. Uitschakelen via instellingen heeft een lagere prioriteit dan inschakelen via de CLI en expliciet uitschakelen in de sessie, dus voeg configuredDisabledServers niet samen met disabledServers.

$session->rpc()->mcp()->reloadWithConfig([
    'config' => [
        'mcpServers' => $mcpServers,
        'disabledServers' => ['session-disabled'],
        'cliEnabledServers' => ['cli-enabled'],
        'configuredDisabledServers' => ['settings-disabled'],
    ],
]);

Raadpleeg de GitHub-repository voor de meest actuele informatie.

GitHub Copilot

SDK

AI SDK

VOICEVOX

Starter kits

Feeds en RSS

Middleware

MCP

MCP

MCP Apps (experimenteel)

MCP OAuth-tokens vanuit de host aanleveren

Ondersteuning voor MCP OAuth controleren (Server RPC)

Status van MCP-servers

MCP-serverconfiguratie beheren (Server RPC)

Uitgeschakelde servers bij het herladen van MCP

​MCP

​MCP Apps (experimenteel)

​MCP OAuth-tokens vanuit de host aanleveren

​Ondersteuning voor MCP OAuth controleren (Server RPC)

​Status van MCP-servers

​MCP-serverconfiguratie beheren (Server RPC)

​Uitgeschakelde servers bij het herladen van MCP

MCP

MCP Apps (experimenteel)

MCP OAuth-tokens vanuit de host aanleveren

Ondersteuning voor MCP OAuth controleren (Server RPC)

Status van MCP-servers

MCP-serverconfiguratie beheren (Server RPC)

Uitgeschakelde servers bij het herladen van MCP