Apply suggestions from code review

Co-authored-by: Bartek Wajda <bartlomiej.wajda@ibexa.co>
Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com>

Author: adriendupuis

docs/ai/mcp/mcp_config.md

@@ -16,9 +16,9 @@ Install the LTS Update package with Composer:
 composer require ibexa/mcp
 ```
 
-MCP Servers feature doesn't come with a default configuration.
+MCP Servers feature comes with [built-in tools](#built-in-tools) but doesn't come with a default configuration.
 You have to create your own MCP servers through [their configuration](#mcp-server-configuration)
-and [enable JWT athentication for them](#jwt-mcp-firewall).
+and [enable JWT authentication for them](#jwt-mcp-firewall).
 
 ## Authentication configuration
 

docs/ai/mcp/mcp_guide.md

@@ -19,7 +19,8 @@ The MCP servers feature is an [LTS Update package](editions.md#lts-updates) avai
 With the MCP servers feature, you can:
 
 - create MCP servers [by using YAML configuration](mcp_config.md#mcp-server-configuration)
-- assign different [tools](mcp_config.md#built-in-tools), prompts, and resources to different MCP servers, varying them for each site
+- assign different tools, prompts, and resources to different MCP servers, varying them for each site
+- assign [built-in tools](mcp_config.md#built-in-tools) included in the package
 - [create custom server capabilities](mcp_usage.md#create-capability-class) with PHP API
 
 MCP servers are configured per [repository](repository_configuration.md) and assigned to [SiteAccesses](siteaccess.md), allowing for flexible configurations adapted to different contexts.

docs/ai/mcp/mcp_usage.md

@@ -71,7 +71,7 @@ This example introduce an `example` MCP server with a single `greet` tool.
 It's enabled on the default repository and all SiteAccesses.
 It's accessible with the path `/mcp/example` (for example, on `http://localhost/mcp/example` and `http://localhost/admin/mcp/example`).
 It uses files for both discovery cache and session storage.
-(Redis/Valkey would probably be better for session storage in production, but file storage is easier for this example and testing.)
+(Redis/Valkey would be better for session storage in production, but file storage is easier for this example and testing.)
 
 In a new `config/packages/mcp.yaml` file, define a new MCP server for the `default` repository and assign it to all SiteAccesses: