MCP

SessionConfigのmcpServersにMCPサーバーを指定すれば使うことができます。 Copilot CLIでLaravel Boostを使う場合は laravel-boost-copilot-cli も使いましょう。 'type' => 'stdio'（または'local'）と'tools' => ['*']が必須なことが分かっています。これがないとMCPサーバーとして認識されません。 argsは任意です（省略可能）。

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 = 'どのMCPが読み込まれている？ laravel-boostが使える場合はapplication-infoでアプリ情報を取得して。';

        warning($prompt);

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

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

MCP Apps（experimental）

enableMcpAppsを有効にしたセッションでは、$session->rpc()->mcp()->apps()からMCP Appsのツールやリソースを操作できます。listTools()でアプリから呼び出せるツールを取得し、callTool()でツールを実行し、readResource()でui://リソース（HTMLなど）を取得します。listTools()とcallTool()には、呼び出し元サーバーを示すoriginServerNameが必要です。 getHostContext() / setHostContext()では、テーマやロケールなどホストコンテキストを読み書きできます。diagnose()はサーバーのMCP Apps対応状態を返します。

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'));

callTool()は自由形式のMCP結果を返します。SDKはデータ取得・設定用のRPCを提供しますが、取得したHTMLの描画やiframeの管理は行いません。これらはLivewireやInertiaなど呼び出し側アプリケーションで実装してください。

MCP OAuthトークンをホストから渡す

MCPサーバーがOAuth認証を要求する場合は、onMcpAuthRequestでホスト側の認証処理を指定できます。コールバックにはMcpAuthRequestとsessionIdを含むコンテキスト配列が渡され、McpAuthTokenを返すとトークンがCLIランタイムに渡されます。nullまたはkind: 'cancelled'のMcpAuthResultを返すと認証をキャンセルします。

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 {
        // アプリケーション独自の認証サービスからトークンを取得
        $accessToken = $credentialProvider->tokenFor($request->serverName);

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

McpAuthRequestにはrequestId、serverName、serverUrl、reason（initial、refresh、reauth、upscope）が含まれます。ハンドラーを指定すると、mcp.oauth_requiredイベントの受信登録も自動で行われます。ブラウザーを開けないWebリクエスト、キュー、バッチなどでもホスト側で認証できます。セッション再開時もResumeSessionConfigに同じハンドラーを指定してください。

MCP OAuthの事前確認（Server RPC）

リモートMCPサーバーがOAuth認証を要求した後、Server RPCでDynamic Client Registration（DCR）に対応しているかを調べられます。authorizationServerUrlはメタデータから認可サーバーを発見できた場合に返ります。supportsDcrがfalseなら動的登録は利用できません。

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はWWW-Authenticateチャレンジから得た保護リソースメタデータで、省略するとサーバーURLから認可サーバーを探索します。sessionIdを指定すると、そのローカルセッションの送信先ポリシーとsandbox proxyが適用されます。Microsoft Entra IDはDCRに対応しないため、Microsoftの認可サーバーと判定された場合は、ユーザーにクライアント資格情報を求める代わりに事前登録済みクライアントを使う選択肢があります。これらはServer RPC（Copilot::client()->rpc()）です。セッションRPCの$session->rpc()->mcp()->oauth()が提供するログインやOAuth要求の処理とは別の名前空間です。

MCPサーバーのステータス

セッション内のMCPサーバーのステータスは以下の値を取ります：

ステータス	説明
`connected`	接続済み
`failed`	接続失敗
`needs-auth`	認証が必要
`pending`	接続待ち
`disabled`	無効化済み
`not_configured`	未設定

$session->rpc()->mcp()->listConfigured()の各サーバーには、実行時に観測できた状態がliveとして含まれることがあります。McpConfiguredServerState::fromArray($server['live'])で型付きの状態として扱えます。McpConfiguredServerStateのtoolsLoadedは、現在の接続でツール一覧が読み込まれたかを表す任意のboolです。ランタイムが未報告の場合はnullになるため、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);
    }
}

connectedステータスだけではツールが読み込まれたことを意味しません。サーバーのツール一覧が利用可能になったタイミングはsession.mcp_server_tools_loadedイベントで確認できます。このエフェメラルなイベントは接続ごとに1回、data.serverNameとdata.toolCountを伴って発火し、永続化されません。キャッシュされたツールが使われる場合は、connectedより先に届くことがあります。

MCPサーバー設定の管理（Server RPC）

セッションとは別に、サーバーレベルでMCPサーバーの設定を管理できます。

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;

// 設定済みのMCPサーバー一覧を取得
$result = Copilot::client()->rpc()->mcp()->list();
foreach ($result->servers as $name => $config) {
    dump($name, $config->type, $config->command);
}

// MCPサーバーを追加
Copilot::client()->rpc()->mcp()->add(new McpConfigAddRequest(
    name: 'laravel-boost',
    config: new McpServerValue(
        type: 'stdio',
        command: 'php',
        args: ['artisan', 'boost:mcp'],
        tools: ['*'],
    ),
));

// MCPサーバーの設定を更新
Copilot::client()->rpc()->mcp()->update(new McpConfigUpdateRequest(
    name: 'laravel-boost',
    config: new McpServerValue(
        type: 'stdio',
        command: 'php',
        args: ['artisan', 'boost:mcp', '--verbose'],
        tools: ['*'],
    ),
));

// MCPサーバーを削除
Copilot::client()->rpc()->mcp()->remove(new McpConfigRemoveRequest(name: 'laravel-boost'));

MCP再読み込み時の無効化設定

reloadWithConfig()で設定を渡す場合、configuredDisabledServersは呼び出し側が解決した設定由来の無効化リストです。セッション単位のdisabledServersやCLIのcliEnabledServersとは別に指定してください。設定由来の無効化はCLIによる有効化と明示的なセッション無効化より優先度が低いため、configuredDisabledServersをdisabledServersへまとめないでください。

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

最新情報は GitHub リポジトリを参照してください。

GitHub Copilot

SDK

AI SDK

VOICEVOX

スターターキット

フィード・RSS

ミドルウェア

MCP

MCP

MCP Apps（experimental）

MCP OAuthトークンをホストから渡す

MCP OAuthの事前確認（Server RPC）

MCPサーバーのステータス

MCPサーバー設定の管理（Server RPC）

MCP再読み込み時の無効化設定

​MCP

​MCP Apps（experimental）

​MCP OAuthトークンをホストから渡す

​MCP OAuthの事前確認（Server RPC）

​MCPサーバーのステータス

​MCPサーバー設定の管理（Server RPC）

​MCP再読み込み時の無効化設定

MCP

MCP Apps（experimental）

MCP OAuthトークンをホストから渡す

MCP OAuthの事前確認（Server RPC）

MCPサーバーのステータス

MCPサーバー設定の管理（Server RPC）

MCP再読み込み時の無効化設定