> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

> Mit SessionRpc des Laravel Copilot SDK verwalten Sie MCP-Server, MCP Apps und das Neuladen mit Konfiguration.

## MCP

Geltungsbereich: SessionRpc (sessionbezogene Operationen, die an eine Session gebunden sind)

Eine Übersicht über RPC und die Liste aller RPC-Seiten finden Sie unter [RPC](https://kawax.biz/de/packages/laravel-copilot-sdk/rpc.md).

## MCP Apps (experimental)

Über `$session->rpc()->mcp()->apps()` können Sie RPCs für MCP Apps aufrufen. Bei `listTools()` und `callTool()` ist der Name des aufrufenden MCP-Servers `originServerName` erforderlich. Das Ergebnis von `callTool()` wird als MCP-Ergebnis in freier Form zurückgegeben.

```php theme={null}
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: 'ja-JP'),
));
$diagnostics = $apps->diagnose(new MCPAppsDiagnoseRequest(serverName: 'my-server'));
```

`readResource()` gibt Ressourcendaten wie HTML zurück. Das SDK übernimmt weder das Rendern im Browser noch iframe-Operationen; das Rendern der abgerufenen Inhalte liegt in der Verantwortung der aufrufenden Anwendung.

```php theme={null}
// mcp (experimental: Verwaltung von MCP-Servern)
$servers = $session->rpc()->mcp()->list();
// Konfigurierte URL eines HTTP/SSE-Servers: $servers->servers[0]->url
$session->rpc()->mcp()->enable(new McpEnableRequest(serverName: 'server-name'));
$session->rpc()->mcp()->disable(new McpDisableRequest(serverName: 'server-name'));
$session->rpc()->mcp()->reload();
// Laufendes MCP-Laden in den Hintergrund verschieben (wartenden Turn freigeben)
$session->rpc()->mcp()->moveLoadingToBackground();

// MCP-Server innerhalb der Session starten/neu starten (persistente Konfiguration bleibt unverändert)
use Revolution\Copilot\Types\Rpc\McpRestartServerRequest;
use Revolution\Copilot\Types\Rpc\McpStartServerRequest;

$session->rpc()->mcp()->startServer(new McpStartServerRequest(
    serverName: 'server-name',
    config: ['type' => 'http', 'url' => 'https://mcp.example.com'],
));
$session->rpc()->mcp()->restartServer(new McpRestartServerRequest(
    serverName: 'server-name',
    expectedInstallationId: 'installation-id',
));

// Automatisch verwalteten GitHub-MCP-Server entfernen und Auflösungsmodus für Umgebungsvariablenwerte festlegen
$removed = $session->rpc()->mcp()->removeGitHub();
$mode = $session->rpc()->mcp()->setEnvValueMode(['mode' => 'indirect']);
// $removed->removed, $mode->mode

// MCP-Sampling ausführen und abbrechen
use Revolution\Copilot\Types\Rpc\McpCancelSamplingExecutionParams;
use Revolution\Copilot\Types\Rpc\McpExecuteSamplingParams;

$sampling = $session->rpc()->mcp()->executeSampling(new McpExecuteSamplingParams(
    requestId: 'sampling-1',
    serverName: 'server-name',
    mcpRequestId: 'mcp-request-1',
    request: ['messages' => [], 'maxTokens' => 256],
));
$cancelled = $session->rpc()->mcp()->cancelSamplingExecution(
    new McpCancelSamplingExecutionParams(requestId: 'sampling-1'),
);

// Prüfen, ob ein MCP-Server läuft
use Revolution\Copilot\Types\Rpc\McpIsServerRunningRequest;

$result = $session->rpc()->mcp()->isServerRunning(new McpIsServerRunningRequest(serverName: 'my-server'));
// $result->running - Ob der Server läuft

// Tool-Liste eines MCP-Servers abrufen
use Revolution\Copilot\Types\Rpc\McpListToolsRequest;

$result = $session->rpc()->mcp()->listTools(new McpListToolsRequest(serverName: 'my-server'));
// $result->tools - Array von McpTools (name, description)

// MCP-Prompts auflisten und abrufen (experimental)
use Revolution\Copilot\Types\Rpc\McpPromptsGetRequest;
use Revolution\Copilot\Types\Rpc\McpPromptsListRequest;

$prompts = $session->rpc()->mcp()->listPrompts(new McpPromptsListRequest(serverName: 'my-server'));
$rendered = $session->rpc()->mcp()->getPrompt(new McpPromptsGetRequest(
    serverName: 'my-server',
    promptName: 'summarize',
    arguments: ['document' => 'README.md'],
));
// $prompts->prompts - MCP-Prompt-Definitionen
// $rendered->messages - Gerenderter Prompt (wird nicht an das Modell gesendet)

// MCP-Server stoppen
use Revolution\Copilot\Types\Rpc\McpStopServerRequest;

$session->rpc()->mcp()->stopServer(new McpStopServerRequest(serverName: 'my-server'));

// Liste der MCP-Ressourcen abrufen (experimental)
use Revolution\Copilot\Types\Rpc\McpResourcesListRequest;

$result = $session->rpc()->mcp()->resources()->list(new McpResourcesListRequest(serverName: 'my-server'));
// $result->resources - Array von McpResource (uri, name, title, mimeType usw.)
// $result->nextCursor - Cursor für die nächste Seite (falls vorhanden)

// MCP-Ressource abrufen (experimental)
use Revolution\Copilot\Types\Rpc\McpResourcesReadRequest;

$result = $session->rpc()->mcp()->resources()->read(new McpResourcesReadRequest(serverName: 'my-server', uri: 'ui://example'));
// $result->contents - Array von McpResourceContent

// Liste der MCP-Ressourcenvorlagen abrufen (experimental)
use Revolution\Copilot\Types\Rpc\McpResourcesListTemplatesRequest;

$result = $session->rpc()->mcp()->resources()->listTemplates(new McpResourcesListTemplatesRequest(serverName: 'my-server'));
// MCP-OAuth-Anmeldung (für MCP-Server, die eine Authentifizierung erfordern)
use Revolution\Copilot\Types\Rpc\McpOauthCompleteRequest;
use Revolution\Copilot\Types\Rpc\McpOauthLoginRequest;
use Revolution\Copilot\Types\Rpc\McpOauthProbeRequest;
use Revolution\Copilot\Types\Rpc\SessionMcpOauthCancelLoginRequest;
use Revolution\Copilot\Types\Rpc\SessionMcpOauthPrepareLoginRequest;

$result = $session->rpc()->mcp()->login(new McpOauthLoginRequest(serverName: 'my-server'));
// $result->authorizationUrl - URL des OAuth-Flows (falls eine Authentifizierung erforderlich ist)
// Beim hostverwalteten OAuth-Redirect-Flow redirectUri angeben und nach dem Callback complete() aufrufen
$result = $session->rpc()->mcp()->login(new McpOauthLoginRequest(
    serverName: 'my-server',
    redirectUri: 'http://localhost:3000/oauth/callback',
));
$session->rpc()->mcp()->complete(new McpOauthCompleteRequest(
    authorizationId: $result->authorizationId,
    callbackUrl: $callbackUrl,
));

// OAuth-Status prüfen und eine an die eigene Installation gebundene Anmeldung vorbereiten bzw. abbrechen
$probe = $session->rpc()->mcp()->oauth()->probe(new McpOauthProbeRequest(serverName: 'my-server'));
$prepared = $session->rpc()->mcp()->oauth()->prepareLogin(new SessionMcpOauthPrepareLoginRequest(
    serverName: 'my-server',
    expectedInstallationId: 'installation-id',
));
$cancelled = $session->rpc()->mcp()->oauth()->cancelLogin(new SessionMcpOauthCancelLoginRequest(
    expectedInstallationId: 'installation-id',
    loginId: $prepared->loginId,
));
```

## mcp reloadWithConfig (deaktivierte Server beim Neuladen)

Wenn Sie `reloadWithConfig()` eine Konfiguration übergeben, ist `configuredDisabledServers` die Liste der Server, die durch von Ihrer Anwendung aufgelöste Einstellungen deaktiviert sind. Geben Sie sie getrennt von den sessionbezogenen `disabledServers` und den `cliEnabledServers` der CLI an. Die Deaktivierung über Einstellungen hat eine niedrigere Priorität als die Aktivierung über die CLI und die explizite Deaktivierung in der Session, führen Sie `configuredDisabledServers` daher nicht mit `disabledServers` zusammen.

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


## Related topics

- [MCP](https://kawax.biz/de/packages/laravel-copilot-sdk/mcp.md)
- [Laravel MCP](https://kawax.biz/de/mcp.md)
- [MCP und Konnektoren](https://kawax.biz/de/packages/laravel-copilot-sdk/rpc/server-mcp.md)
- [Einen MCP-Server mit Laravel bauen](https://kawax.biz/de/advanced/mcp-server.md)
- [Laravel-KI-Agenten unterstützen MCP-Server](https://kawax.biz/de/blog/ai-sdk-mcp-client.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.