> ## 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

> Usa SessionRpc en Laravel Copilot SDK para gestionar servidores MCP, MCP Apps y la recarga con configuración.

## MCP

Ámbito: SessionRpc (operaciones por sesión vinculadas a una Session)

Para una visión general de RPC y la lista de todas las páginas de RPC, consulta [RPC](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc.md).

## MCP Apps (experimental)

Desde `$session->rpc()->mcp()->apps()` puedes llamar a las RPC para MCP Apps. En `listTools()` y `callTool()` es obligatorio el nombre del servidor MCP de origen, `originServerName`. El resultado de `callTool()` se devuelve como un resultado MCP de formato libre.

```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()` devuelve datos de recursos como HTML. El SDK no renderiza en el navegador ni manipula iframes, por lo que renderizar el contenido obtenido es responsabilidad de la aplicación que hace la llamada.

```php theme={null}
// mcp (experimental: gestión de servidores MCP)
$servers = $session->rpc()->mcp()->list();
// URL configurada de servidores HTTP/SSE: $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();
// Pasar a segundo plano la carga de MCP en curso (libera el turno en espera)
$session->rpc()->mcp()->moveLoadingToBackground();

// Iniciar o reiniciar servidores MCP en la sesión (no cambia la configuración persistente)
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',
));

// Eliminar el servidor MCP de GitHub gestionado automáticamente y modo de resolución de valores de variables de entorno
$removed = $session->rpc()->mcp()->removeGitHub();
$mode = $session->rpc()->mcp()->setEnvValueMode(['mode' => 'indirect']);
// $removed->removed, $mode->mode

// Ejecutar y cancelar MCP sampling
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'),
);

// Comprobar si un servidor MCP está en ejecución
use Revolution\Copilot\Types\Rpc\McpIsServerRunningRequest;

$result = $session->rpc()->mcp()->isServerRunning(new McpIsServerRunningRequest(serverName: 'my-server'));
// $result->running - si el servidor está en ejecución

// Obtener la lista de herramientas de un servidor MCP
use Revolution\Copilot\Types\Rpc\McpListToolsRequest;

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

// Listar y obtener prompts de MCP (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 - definiciones de prompts MCP
// $rendered->messages - prompt renderizado (no se envía al modelo)

// Detener un servidor MCP
use Revolution\Copilot\Types\Rpc\McpStopServerRequest;

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

// Obtener la lista de recursos MCP (experimental)
use Revolution\Copilot\Types\Rpc\McpResourcesListRequest;

$result = $session->rpc()->mcp()->resources()->list(new McpResourcesListRequest(serverName: 'my-server'));
// $result->resources - array de McpResource (uri, name, title, mimeType, etc.)
// $result->nextCursor - cursor de la página siguiente (si existe)

// Obtener un recurso MCP (experimental)
use Revolution\Copilot\Types\Rpc\McpResourcesReadRequest;

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

// Obtener la lista de plantillas de recursos MCP (experimental)
use Revolution\Copilot\Types\Rpc\McpResourcesListTemplatesRequest;

$result = $session->rpc()->mcp()->resources()->listTemplates(new McpResourcesListTemplatesRequest(serverName: 'my-server'));
// Inicio de sesión OAuth de MCP (para servidores MCP que requieren autenticación)
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 del flujo OAuth (si se requiere autenticación)
// En el flujo de redirección OAuth gestionado por el host, indica redirectUri y llama a complete() tras el callback
$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,
));

// Comprobar el estado de OAuth y preparar o cancelar el inicio de sesión vinculado a una instalación propia
$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 (servidores desactivados al recargar)

Cuando pasas configuración a `reloadWithConfig()`, `configuredDisabledServers` es la lista de servidores desactivados por la configuración que resolvió tu aplicación. Indícala por separado de `disabledServers` a nivel de sesión y de `cliEnabledServers` del CLI. La desactivación por configuración tiene menor prioridad que la activación del CLI y la desactivación explícita de la sesión, así que no fusiones `configuredDisabledServers` con `disabledServers`.

```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/es/packages/laravel-copilot-sdk/mcp.md)
- [Laravel MCP](https://kawax.biz/es/mcp.md)
- [MCP y conectores](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc/server-mcp.md)
- [Crear un servidor MCP con Laravel](https://kawax.biz/es/advanced/mcp-server.md)
- [Los agentes de IA de Laravel ahora soportan MCP](https://kawax.biz/es/blog/ai-sdk-mcp-client.md)


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