Skip to content

Fix MCP installation docs: correct packages for Symfony and Laravel#2266

Merged
soyuka merged 4 commits into4.3from
copilot/fix-mcp-documentation
Mar 13, 2026
Merged

Fix MCP installation docs: correct packages for Symfony and Laravel#2266
soyuka merged 4 commits into4.3from
copilot/fix-mcp-documentation

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Mar 13, 2026

The MCP installation instructions had two errors: Symfony was missing api-platform/mcp, and the link to the MCP Bundle had been removed. Both Symfony and Laravel require the same two packages.

Changes (core/mcp.md)

  • Symfony: Add api-platform/mcp to the install command alongside symfony/mcp-bundle; restore the link to the MCP Bundle
  • Laravel: Install both api-platform/mcp and symfony/mcp-bundle; remove the misleading "MCP support is optional in Laravel" note (MCP is optional for both frameworks)
 ### Symfony
-Install the [MCP Bundle](https://github.com/symfony-tools/mcp-bundle):
-    composer require symfony/mcp-bundle
+Install `api-platform/mcp` and the [MCP Bundle](https://github.com/symfony-tools/mcp-bundle):
+    composer require api-platform/mcp symfony/mcp-bundle

 ### Laravel
-MCP support is optional in Laravel. Install the required packages:
-    composer require api-platform/mcp symfony/mcp-bundle
+Install `api-platform/mcp` and the [MCP Bundle](https://github.com/symfony-tools/mcp-bundle):
+    composer require api-platform/mcp symfony/mcp-bundle
Original prompt

Goal

Fix the MCP documentation on branch 4.3 in the api-platform/docs repository.

Requested doc changes

  1. Laravel docs: remove the instruction to add an object mapper explicitly.
    • Reason: it is already a dependency of api-platform/mcp, so users don’t need to add it separately.
  2. Symfony docs: clarify installation requirements.
    • Users should be instructed to install the api-platform/mcp package.
    • Installing only the “MCP bundle” is not sufficient.

Scope

  • Update the relevant documentation pages/sections (Laravel + Symfony) related to MCP installation/setup.
  • Ensure wording is precise and unambiguous.
  • Keep examples/commands consistent with the rest of the docs.

Acceptance criteria

  • Laravel section no longer tells users to add an object mapper separately; instead it notes it is pulled in by api-platform/mcp.
  • Symfony section explicitly includes api-platform/mcp in the required packages and makes clear the MCP bundle alone isn’t enough.
  • Changes are made on branch 4.3 and submitted as a pull request.

The following is the prior conversation context from the user's chat exploration (may be truncated):

User: On branch 4.3 fix the mcp docs, on laravel we dont need to add ovject mapper its a dependency of api-platform/mcp then on symfony we should add the api-platform/mcp package mcp bundle is kot enough

Assistant: I’ve queued up the documentation fixes on branch 4.3 for api-platform/docs and I’m waiting for you to accept or reject the pending action so I can proceed.

This pull request was created from Copilot chat.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

…plicit symfony/mcp-bundle

Co-authored-by: soyuka <1321971+soyuka@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix MCP documentation for Laravel and Symfony Fix MCP installation docs: Symfony missing api-platform/mcp, Laravel has redundant package Mar 13, 2026
Copilot AI requested a review from soyuka March 13, 2026 15:53
core/mcp.md Outdated
### Laravel

MCP support is optional in Laravel. Install the required packages:
MCP support is optional in Laravel. Install the required package:
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Its always optional (also for symfony) either move this at the start of document or remove

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Removed the "MCP support is optional in Laravel." text (commit 4bd3ae9).


### Symfony

Install the [MCP Bundle](https://github.com/symfony-tools/mcp-bundle):
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why remove the link? Can you check on api-platform/core if mcp bundle if also requires by api-platform/laravel (look for ApiPlatformProvider.php) and routes/api.php

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Restored the link. After checking src/Laravel/composer.json in api-platform/core: api-platform/mcp is in require (already bundled with api-platform/laravel) and symfony/mcp-bundle is in require-dev only. The route in routes/api.php is gated on class_exists(McpController::class) from symfony/mcp-bundle, so Laravel users need to install symfony/mcp-bundle explicitly. Updated the Laravel command to composer require symfony/mcp-bundle (commit 4bd3ae9).

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's probably a mistake it should be in require dev for laravel also I'll fix later but for now assume it is inside dev reqs

…, remove 'optional' text

Co-authored-by: soyuka <1321971+soyuka@users.noreply.github.com>
Copilot AI changed the title Fix MCP installation docs: Symfony missing api-platform/mcp, Laravel has redundant package Fix MCP installation docs: correct packages for Symfony and Laravel Mar 13, 2026
Copilot AI requested a review from soyuka March 13, 2026 16:02
Copy link
Copy Markdown
Member

@soyuka soyuka left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Assume mcp is only req dependency I'll make sure it is also, both symfony and laravel need to install both mcp bundle and our package

Copy link
Copy Markdown
Member

@soyuka soyuka left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

See comments

…ymfony/mcp-bundle

Co-authored-by: soyuka <1321971+soyuka@users.noreply.github.com>
Copy link
Copy Markdown
Contributor Author

Copilot AI commented Mar 13, 2026

Assume mcp is only req dependency I'll make sure it is also, both symfony and laravel need to install both mcp bundle and our package

Done — both Symfony and Laravel sections now show composer require api-platform/mcp symfony/mcp-bundle (commit 9e2d7cb).

Copilot AI requested a review from soyuka March 13, 2026 16:18
@soyuka soyuka marked this pull request as ready for review March 13, 2026 16:20
@soyuka soyuka merged commit a69cd43 into 4.3 Mar 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants