Skip to content

IBX-11536: MCP Servers#3106

Draft
adriendupuis wants to merge 70 commits into5.0from
mcp
Draft

IBX-11536: MCP Servers#3106
adriendupuis wants to merge 70 commits into5.0from
mcp

Conversation

@adriendupuis
Copy link
Copy Markdown
Contributor

@adriendupuis adriendupuis commented Mar 26, 2026 •
edited
Loading

Question Answer
JIRA Ticket IBX-11068 > IBX-11536
Versions 5.0
Edition All

Document built-in MCP Servers and how to create custom ones.

Related PRs:

Checklist

  • Text renders correctly
  • Text has been checked with vale
  • Description metadata is up to date
  • Redirects cover removed/moved pages
  • Code samples are working
  • PHP code samples have been fixed with PHP CS fixer
  • Added link to this PR in relevant JIRA ticket or code PR

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Mar 26, 2026 •
edited
Loading

Preview of modified files

Preview of modified Markdown:

Preview of addition to PHP API Reference:

adriendupuis
adriendupuis commented Mar 26, 2026
View reviewed changes
Comment thread composer.json Outdated
adriendupuis
adriendupuis commented Mar 26, 2026
View reviewed changes
Comment thread mkdocs.yml Outdated
@adriendupuis
Replace backticks with '$()' syntax for command substitution.
9ba2f81 
Apply SonarCloud Code Analysis warning's suggestion
adriendupuis
adriendupuis commented Mar 26, 2026
View reviewed changes
Comment thread docs/ai/mcp/mcp_guide.md Outdated
@adriendupuis adriendupuis changed the title IBX-11068: MCP Servers IBX-11536: MCP Servers Mar 27, 2026
adriendupuis
adriendupuis commented Apr 21, 2026
View reviewed changes
Comment thread docs/ai/mcp/mcp_config.md Outdated
adriendupuis
adriendupuis commented Apr 21, 2026
View reviewed changes
Comment thread code_samples/mcp/config/packages/mcp.yaml Outdated
adriendupuis
adriendupuis commented Apr 21, 2026
View reviewed changes
Comment thread docs/ai/mcp/mcp_config.md Outdated
adriendupuis
adriendupuis commented Apr 21, 2026
View reviewed changes
Comment thread code_samples/mcp/src/Mcp/ExampleTools.php Outdated
@adriendupuis adriendupuis mentioned this pull request Apr 24, 2026
Closed
@sonarqubecloud
Copy link
Copy Markdown

sonarqubecloud Bot commented Apr 27, 2026

Quality Gate Failed Quality Gate failed

Failed conditions
18 Security Hotspots
37.2% Duplication on New Code (required ≤ 3%)
C Reliability Rating on New Code (required ≥ A)

See analysis details on SonarQube Cloud

Catch issues before they fail your Quality Gate with our IDE extension SonarQube for IDE

@adriendupuis adriendupuis mentioned this pull request Apr 29, 2026
Draft
7 tasks
@adriendupuis adriendupuis mentioned this pull request Apr 29, 2026
Draft
7 tasks
@sonarqubecloud
Copy link
Copy Markdown

sonarqubecloud Bot commented Apr 30, 2026

Quality Gate Failed Quality Gate failed

Failed conditions
18 Security Hotspots
43.6% Duplication on New Code (required ≤ 3%)
C Reliability Rating on New Code (required ≥ A)

See analysis details on SonarQube Cloud

Catch issues before they fail your Quality Gate with our IDE extension SonarQube for IDE

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 30, 2026

code_samples/ change report

Before (on target branch)After (in current PR)

code_samples/mcp/config/packages/mcp.yaml


code_samples/mcp/config/packages/mcp.yaml

docs/ai/mcp/mcp_config.md@219:``` yaml
docs/ai/mcp/mcp_config.md@220:[[= include_code('code_samples/mcp/config/packages/mcp.yaml') =]]
docs/ai/mcp/mcp_config.md@221:```

001⫶ibexa:
002⫶    repositories:
003⫶        default:
004⫶            mcp:
005⫶                example:
006⫶                    path: /mcp/example
007⫶                    enabled: true
008⫶                    description: 'Example MCP Server'
009⫶                    instructions: 'Use this server to greet someone.'
010⫶                    discovery_cache: cache.tagaware.filesystem
011⫶                    session:
012⫶                        type: psr16
013⫶                        directory: cache.tagaware.filesystem
014⫶    system:
015⫶        default:
016⫶            mcp:
017⫶                servers:
018⫶                    - example


code_samples/mcp/http.mcp.json


code_samples/mcp/http.mcp.json

docs/ai/mcp/mcp_config.md@435:``` json
docs/ai/mcp/mcp_config.md@436:[[= include_code('code_samples/mcp/http.mcp.json') =]]
docs/ai/mcp/mcp_config.md@437:```

001⫶{
002⫶  "mcpServers": {
003⫶    "ibexa-example": {
004⫶      "type": "http",
005⫶      "url": "http://localhost/mcp/example",
006⫶      "headers": {
007⫶        "Authorization": "Bearer <JWT token>"
008⫶      },
009⫶      "tools": ["*"]
010⫶    }
011⫶  }
012⫶}


code_samples/mcp/mcp-ibexa-example-wrapper.sh


code_samples/mcp/mcp-ibexa-example-wrapper.sh

docs/ai/mcp/mcp_config.md@462:``` bash
docs/ai/mcp/mcp_config.md@463:[[= include_code('code_samples/mcp/mcp-ibexa-example-wrapper.sh') =]]
docs/ai/mcp/mcp_config.md@464:```

001⫶#!/bin/bash
002⫶set -e
003⫶
004⫶baseUrl='http://localhost' # Adapt to your test case
005⫶
006⫶jwtToken=$(curl -s -X 'POST' \
007⫶  "$baseUrl/api/ibexa/v2/user/token/jwt" \
008⫶  -H 'Content-Type: application/vnd.ibexa.api.JWTInput+json' \
009⫶  -H 'Accept: application/vnd.ibexa.api.JWT+json' \
010⫶  -d '{
011⫶        "JWTInput": {
012⫶          "_media-type": "application/vnd.ibexa.api.JWTInput+json",
013⫶          "username": "ibexa-example",
014⫶          "password": "Ibexa-3xample"
015⫶        }
016⫶      }' | jq -r .JWT.token)
017⫶
018⫶exec npx -y supergateway \
019⫶  --streamableHttp "$baseUrl/mcp/example" \
020⫶  --oauth2Bearer "$jwtToken" \
021⫶  --logLevel none


code_samples/mcp/mcp.matrix.yaml


code_samples/mcp/mcp.matrix.yaml

docs/ai/mcp/mcp_config.md@42:``` yaml
docs/ai/mcp/mcp_config.md@43:[[= include_code('code_samples/mcp/mcp.matrix.yaml', 1, 8) =]]
docs/ai/mcp/mcp_config.md@44:[[= include_code('code_samples/mcp/mcp.matrix.yaml', 12, 15) =]]
docs/ai/mcp/mcp_config.md@45:[[= include_code('code_samples/mcp/mcp.matrix.yaml', 29, 33) =]]
docs/ai/mcp/mcp_config.md@46:```

001⫶ibexa:
002⫶    repositories:
003⫶        <repository_identifier>:
004⫶            mcp:
005⫶                <server_identifier>:
006⫶                    path: <server_route_path>
007⫶                    enabled: true
008⫶                    # Server options…
009⫶                    discovery_cache: <cache_pool_service>
010⫶                    session:
011⫶                        type: <psr16|file|memory>
012⫶                        # Session options…
013⫶    system:
014⫶        <siteaccess_scope>:
015⫶            mcp:
016⫶                servers:
017⫶                    - <server_identifier>

docs/ai/mcp/mcp_config.md@93:``` yaml
docs/ai/mcp/mcp_config.md@94:[[= include_code('code_samples/mcp/mcp.matrix.yaml', 9, 11) =]]
docs/ai/mcp/mcp_config.md@95:```

001⫶                    tools:
002⫶                        - Ibexa\Mcp\Tool\TranslationTools
003⫶                        - Ibexa\Mcp\Tool\SeoTools

docs/ai/mcp/mcp_config.md@104:``` yaml
docs/ai/mcp/mcp_config.md@105:[[= include_code('code_samples/mcp/mcp.matrix.yaml', 17, 17) =]]
docs/ai/mcp/mcp_config.md@106:```

001⫶                    discovery_cache: cache.redis.mcp

docs/ai/mcp/mcp_config.md@128:``` yaml
docs/ai/mcp/mcp_config.md@129:[[= include_code('code_samples/mcp/mcp.matrix.yaml', 18, 21) =]]
docs/ai/mcp/mcp_config.md@130:[[= include_code('code_samples/mcp/mcp.matrix.yaml', 34, 43) =]]
docs/ai/mcp/mcp_config.md@131:```

001⫶                    session:
002⫶                        type: psr16
003⫶                        service: cache.redis.mcp
004⫶                        prefix: 'mcp_<server_identifier>_'
005⫶services:
006⫶    cache.redis.mcp:
007⫶        public: true
008⫶        class: Symfony\Component\Cache\Adapter\RedisTagAwareAdapter
009⫶        parent: cache.adapter.redis
010⫶        tags:
011⫶            -   name: cache.pool
012⫶                clearer: cache.app_clearer
013⫶                provider: 'redis://mcp.redis:6379'
014⫶                namespace: 'mcp'

docs/ai/mcp/mcp_config.md@140:``` yaml
docs/ai/mcp/mcp_config.md@141:[[= include_code('code_samples/mcp/mcp.matrix.yaml', 23, 25) =]]
docs/ai/mcp/mcp_config.md@142:```

001⫶                    session:
002⫶                        type: file
003⫶                        directory: '%kernel.cache_dir%/mcp/sessions'

docs/ai/mcp/mcp_config.md@149:``` yaml
docs/ai/mcp/mcp_config.md@150:[[= include_code('code_samples/mcp/mcp.matrix.yaml', 27, 28) =]]
docs/ai/mcp/mcp_config.md@151:```

001⫶                    session:
002⫶                        type: memory


code_samples/mcp/mcp.sh


code_samples/mcp/mcp.sh

docs/ai/mcp/mcp_config.md@273:``` bash
docs/ai/mcp/mcp_config.md@274:[[= include_code('code_samples/mcp/mcp.sh', 5, 7) =]]
docs/ai/mcp/mcp_config.md@275:```

001⫶baseUrl='http://localhost' # Adapt to your test case
002⫶username='ibexa-example'
003⫶password='Ibexa-3xample'

docs/ai/mcp/mcp_config.md@279:``` bash
docs/ai/mcp/mcp_config.md@280:[[= include_code('code_samples/mcp/mcp.sh', 9, 23) =]]
docs/ai/mcp/mcp_config.md@281:```

001⫶curl -s -X 'POST' \
002⫶  "$baseUrl/api/ibexa/v2/user/token/jwt" \
003⫶  -H 'Content-Type: application/vnd.ibexa.api.JWTInput+json' \
004⫶  -H 'Accept: application/vnd.ibexa.api.JWT+json' \
005⫶  -d "{
006⫶        \"JWTInput\": {
007⫶          \"_media-type\": \"application/vnd.ibexa.api.JWTInput+json\",
008⫶          \"username\": \"$username\",
009⫶          \"password\": \"$password\"
010⫶        }
011⫶      }" > response.tmp.txt
012⫶
013⫶cat response.tmp.txt | jq
014⫶jwtToken=$(cat response.tmp.txt | jq -r .JWT.token)
015⫶rm response.tmp.txt

docs/ai/mcp/mcp_config.md@283:``` json
docs/ai/mcp/mcp_config.md@284:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 1, 7) =]]
docs/ai/mcp/mcp_config.md@285:```

001⫶{
002⫶  "JWT": {
003⫶    "_media-type": "application/vnd.ibexa.api.JWT+json",
004⫶    "_token": "1234567890ABCDEFGHIJKLMNOPQRSTUVWXYZ.abcdefghijklmnopqrstuvwxyz1234567890ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890abcdefghijklmnopqrstuvwxyz1234567890ABCD.EFGHIJKL-MNOPQRSTUVWXYZ12345678901234567890",
005⫶    "token": "1234567890ABCDEFGHIJKLMNOPQRSTUVWXYZ.abcdefghijklmnopqrstuvwxyz1234567890ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890abcdefghijklmnopqrstuvwxyz1234567890ABCD.EFGHIJKL-MNOPQRSTUVWXYZ12345678901234567890"
006⫶  }
007⫶}

docs/ai/mcp/mcp_config.md@289:``` bash
docs/ai/mcp/mcp_config.md@290:[[= include_code('code_samples/mcp/mcp.sh', 21, 44) =]]
docs/ai/mcp/mcp_config.md@291:```

001⫶cat response.tmp.txt | jq
002⫶jwtToken=$(cat response.tmp.txt | jq -r .JWT.token)
003⫶rm response.tmp.txt
004⫶
005⫶curl -s -i -X 'POST' "$baseUrl/mcp/example" \
006⫶  -H "Authorization: Bearer $jwtToken" \
007⫶  -d '{
008⫶        "jsonrpc": "2.0",
009⫶        "id": 1,
010⫶        "method": "initialize",
011⫶        "params": {
012⫶          "protocolVersion": "2025-03-26",
013⫶          "capabilities": {},
014⫶          "clientInfo": {
015⫶            "name": "test-curl-client",
016⫶            "version": "1.0.0"
017⫶          }
018⫶        }
019⫶      }' > response.tmp.txt
020⫶
021⫶sed '$d' response.tmp.txt
022⫶tail -n 1 response.tmp.txt | jq
023⫶mcpSessionId=$(cat response.tmp.txt | grep 'Mcp-Session-Id:' | sed 's/Mcp-Session-Id: \([0-9a-f-]*\).*/\1/')
024⫶rm response.tmp.txt

docs/ai/mcp/mcp_config.md@293:``` http
docs/ai/mcp/mcp_config.md@294:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 8, 16) =]]
docs/ai/mcp/mcp_config.md@295:```

001⫶HTTP/1.1 200 OK
002⫶Access-Control-Allow-Headers: Content-Type, Mcp-Session-Id, Mcp-Protocol-Version, Last-Event-ID, Authorization, Accept
003⫶Access-Control-Allow-Methods: GET, POST, DELETE, OPTIONS
004⫶Access-Control-Allow-Origin: *
005⫶Access-Control-Expose-Headers: Mcp-Session-Id
006⫶Cache-Control: no-cache, private
007⫶Content-Type: application/json
008⫶Date: Tue, 28 Apr 2026 09:53:27 GMT
009⫶Mcp-Session-Id: 12345678-9abc-def0-1234-56789abcdef0

docs/ai/mcp/mcp_config.md@297:``` json
docs/ai/mcp/mcp_config.md@298:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 26, 51) =]]
docs/ai/mcp/mcp_config.md@299:```

001⫶{
002⫶  "jsonrpc": "2.0",
003⫶  "id": 1,
004⫶  "result": {
005⫶    "protocolVersion": "2025-06-18",
006⫶    "capabilities": {
007⫶      "logging": {},
008⫶      "completions": {},
009⫶      "prompts": {
010⫶        "listChanged": true
011⫶      },
012⫶      "resources": {
013⫶        "listChanged": true
014⫶      },
015⫶      "tools": {
016⫶        "listChanged": true
017⫶      }
018⫶    },
019⫶    "serverInfo": {
020⫶      "name": "example",
021⫶      "version": "1.0.0",
022⫶      "description": "Example MCP Server"
023⫶    },
024⫶    "instructions": "Use this server to greet someone."
025⫶  }
026⫶}

docs/ai/mcp/mcp_config.md@303:``` bash
docs/ai/mcp/mcp_config.md@304:[[= include_code('code_samples/mcp/mcp.sh', 46, 52) =]]
docs/ai/mcp/mcp_config.md@305:```

001⫶curl -s -i -X 'POST' "$baseUrl/mcp/example" \
002⫶  -H "Authorization: Bearer $jwtToken" \
003⫶  -H "Mcp-Session-Id: $mcpSessionId" \
004⫶  -d '{
005⫶        "jsonrpc": "2.0",
006⫶        "method": "notifications/initialized"
007⫶      }'

docs/ai/mcp/mcp_config.md@307:``` http
docs/ai/mcp/mcp_config.md@308:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 52, 56) =]]
docs/ai/mcp/mcp_config.md@309:```

001⫶HTTP/1.1 202 Accepted
002⫶Access-Control-Allow-Headers: Content-Type, Mcp-Session-Id, Mcp-Protocol-Version, Last-Event-ID, Authorization, Accept
003⫶Access-Control-Allow-Methods: GET, POST, DELETE, OPTIONS
004⫶Access-Control-Allow-Origin: *
005⫶Access-Control-Expose-Headers: Mcp-Session-Id

docs/ai/mcp/mcp_config.md@313:``` bash
docs/ai/mcp/mcp_config.md@314:[[= include_code('code_samples/mcp/mcp.sh', 54, 61) =]]
docs/ai/mcp/mcp_config.md@315:```

001⫶curl -s -X 'POST' "$baseUrl/mcp/example" \
002⫶  -H "Authorization: Bearer $jwtToken" \
003⫶  -H "Mcp-Session-Id: $mcpSessionId" \
004⫶  -d '{
005⫶        "jsonrpc": "2.0",
006⫶        "id": 2,
007⫶        "method": "tools/list"
008⫶      }' | jq

docs/ai/mcp/mcp_config.md@317:``` json
docs/ai/mcp/mcp_config.md@318:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 69, 128) =]]
docs/ai/mcp/mcp_config.md@319:```

001⫶{
002⫶  "jsonrpc": "2.0",
003⫶  "id": 2,
004⫶  "result": {
005⫶    "tools": [
006⫶      {
007⫶        "name": "greet",
008⫶        "inputSchema": {
009⫶          "type": "object",
010⫶          "properties": {
011⫶            "name": {
012⫶              "type": "string",
013⫶              "description": "The name of the person to greet"
014⫶            }
015⫶          },
016⫶          "required": [
017⫶            "name"
018⫶          ]
019⫶        },
020⫶        "description": "Greet a user by name",
021⫶        "annotations": {
022⫶          "readOnlyHint": true,
023⫶          "destructiveHint": false,
024⫶          "idempotentHint": true,
025⫶          "openWorldHint": false
026⫶        },
027⫶        "icons": [
028⫶          {
029⫶            "src": "https://openmoji.org/data/color/svg/1F44B.svg"
030⫶          }
031⫶        ],
032⫶        "outputSchema": {
033⫶          "type": "object",
034⫶          "properties": {
035⫶            "general": {
036⫶              "type": "string",
037⫶              "description": "the safe way to greet someone"
038⫶            },
039⫶            "close": {
040⫶              "type": "string",
041⫶              "description": "when you're close to the person, like friends or relatives"
042⫶            },
043⫶            "morning": {
044⫶              "type": "string",
045⫶              "description": "when it's in the morning"
046⫶            },
047⫶            "afternoon": {
048⫶              "type": "string",
049⫶              "description": "when it's the afternoon"
050⫶            },
051⫶            "evening": {
052⫶              "type": "string",
053⫶              "description": "when it's late in the day"
054⫶            }
055⫶          }
056⫶        }
057⫶      }
058⫶    ]
059⫶  }
060⫶}

docs/ai/mcp/mcp_config.md@323:``` bash
docs/ai/mcp/mcp_config.md@324:[[= include_code('code_samples/mcp/mcp.sh', 63, 76) =]]
docs/ai/mcp/mcp_config.md@325:```

001⫶curl -s -X 'POST' "$baseUrl/mcp/example" \
002⫶  -H "Authorization: Bearer $jwtToken" \
003⫶  -H "Mcp-Session-Id: $mcpSessionId" \
004⫶  -d '{
005⫶        "jsonrpc": "2.0",
006⫶        "id": 3,
007⫶        "method": "tools/call",
008⫶        "params": {
009⫶          "name": "greet",
010⫶          "arguments": {
011⫶            "name": "World"
012⫶          }
013⫶        }
014⫶      }' | jq

docs/ai/mcp/mcp_config.md@327:``` json
docs/ai/mcp/mcp_config.md@328:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 129, 148) =]]
docs/ai/mcp/mcp_config.md@329:```

001⫶{
002⫶  "jsonrpc": "2.0",
003⫶  "id": 3,
004⫶  "result": {
005⫶    "content": [
006⫶      {
007⫶        "type": "text",
008⫶        "text": "{\n    \"general\": \"Hello, World!\",\n    \"close\": \"Hey, World!\",\n    \"morning\": \"Good morning, World!\",\n    \"afternoon\": \"Good afternoon, World!\",\n    \"evening\": \"Good evening, World!\"\n}"
009⫶      }
010⫶    ],
011⫶    "isError": false,
012⫶    "structuredContent": {
013⫶      "general": "Hello, World!",
014⫶      "close": "Hey, World!",
015⫶      "morning": "Good morning, World!",
016⫶      "afternoon": "Good afternoon, World!",
017⫶      "evening": "Good evening, World!"
018⫶    }
019⫶  }
020⫶}

docs/ai/mcp/mcp_config.md@333:``` bash
docs/ai/mcp/mcp_config.md@334:[[= include_code('code_samples/mcp/mcp.sh', 78, 85) =]]
docs/ai/mcp/mcp_config.md@335:```

001⫶curl -s -X 'POST' "$baseUrl/mcp/example" \
002⫶  -H "Authorization: Bearer $jwtToken" \
003⫶  -H "Mcp-Session-Id: $mcpSessionId" \
004⫶  -d '{
005⫶        "jsonrpc": "2.0",
006⫶        "id": 4,
007⫶        "method": "prompts/list"
008⫶      }' | jq

docs/ai/mcp/mcp_config.md@337:``` json
docs/ai/mcp/mcp_config.md@338:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 149, 172) =]]
docs/ai/mcp/mcp_config.md@339:```

001⫶{
002⫶  "jsonrpc": "2.0",
003⫶  "id": 4,
004⫶  "result": {
005⫶    "prompts": [
006⫶      {
007⫶        "name": "greet",
008⫶        "description": "Prompt to be greeted by the `greet` tool",
009⫶        "arguments": [
010⫶          {
011⫶            "name": "name",
012⫶            "description": "The name you want to be greeted by",
013⫶            "required": true
014⫶          }
015⫶        ],
016⫶        "icons": [
017⫶          {
018⫶            "src": "https://openmoji.org/data/color/svg/1F91D.svg"
019⫶          }
020⫶        ]
021⫶      }
022⫶    ]
023⫶  }
024⫶}

docs/ai/mcp/mcp_config.md@343:``` bash
docs/ai/mcp/mcp_config.md@344:[[= include_code('code_samples/mcp/mcp.sh', 87, 100) =]]
docs/ai/mcp/mcp_config.md@345:```

001⫶curl -s -X 'POST' "$baseUrl/mcp/example" \
002⫶  -H "Authorization: Bearer $jwtToken" \
003⫶  -H "Mcp-Session-Id: $mcpSessionId" \
004⫶  -d '{
005⫶        "jsonrpc": "2.0",
006⫶        "id": 5,
007⫶        "method": "prompts/get",
008⫶        "params": {
009⫶          "name": "greet",
010⫶          "arguments": {
011⫶            "name": "Firstname Lastname"
012⫶          }
013⫶        }
014⫶      }' | jq

docs/ai/mcp/mcp_config.md@347:``` json
docs/ai/mcp/mcp_config.md@348:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 173, 187) =]]
docs/ai/mcp/mcp_config.md@349:```

001⫶{
002⫶  "jsonrpc": "2.0",
003⫶  "id": 5,
004⫶  "result": {
005⫶    "messages": [
006⫶      {
007⫶        "role": "user",
008⫶        "content": {
009⫶          "type": "text",
010⫶          "text": "Hi. My name is Firstname Lastname. Please, greet me."
011⫶        }
012⫶      }
013⫶    ]
014⫶  }
015⫶}


code_samples/mcp/mcp.sh.output.txt


code_samples/mcp/mcp.sh.output.txt

docs/ai/mcp/mcp_config.md@283:``` json
docs/ai/mcp/mcp_config.md@284:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 1, 7) =]]
docs/ai/mcp/mcp_config.md@285:```

001⫶{
002⫶  "JWT": {
003⫶    "_media-type": "application/vnd.ibexa.api.JWT+json",
004⫶    "_token": "1234567890ABCDEFGHIJKLMNOPQRSTUVWXYZ.abcdefghijklmnopqrstuvwxyz1234567890ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890abcdefghijklmnopqrstuvwxyz1234567890ABCD.EFGHIJKL-MNOPQRSTUVWXYZ12345678901234567890",
005⫶    "token": "1234567890ABCDEFGHIJKLMNOPQRSTUVWXYZ.abcdefghijklmnopqrstuvwxyz1234567890ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890abcdefghijklmnopqrstuvwxyz1234567890ABCD.EFGHIJKL-MNOPQRSTUVWXYZ12345678901234567890"
006⫶  }
007⫶}

docs/ai/mcp/mcp_config.md@293:``` http
docs/ai/mcp/mcp_config.md@294:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 8, 16) =]]
docs/ai/mcp/mcp_config.md@295:```

001⫶HTTP/1.1 200 OK
002⫶Access-Control-Allow-Headers: Content-Type, Mcp-Session-Id, Mcp-Protocol-Version, Last-Event-ID, Authorization, Accept
003⫶Access-Control-Allow-Methods: GET, POST, DELETE, OPTIONS
004⫶Access-Control-Allow-Origin: *
005⫶Access-Control-Expose-Headers: Mcp-Session-Id
006⫶Cache-Control: no-cache, private
007⫶Content-Type: application/json
008⫶Date: Tue, 28 Apr 2026 09:53:27 GMT
009⫶Mcp-Session-Id: 12345678-9abc-def0-1234-56789abcdef0

docs/ai/mcp/mcp_config.md@297:``` json
docs/ai/mcp/mcp_config.md@298:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 26, 51) =]]
docs/ai/mcp/mcp_config.md@299:```

001⫶{
002⫶  "jsonrpc": "2.0",
003⫶  "id": 1,
004⫶  "result": {
005⫶    "protocolVersion": "2025-06-18",
006⫶    "capabilities": {
007⫶      "logging": {},
008⫶      "completions": {},
009⫶      "prompts": {
010⫶        "listChanged": true
011⫶      },
012⫶      "resources": {
013⫶        "listChanged": true
014⫶      },
015⫶      "tools": {
016⫶        "listChanged": true
017⫶      }
018⫶    },
019⫶    "serverInfo": {
020⫶      "name": "example",
021⫶      "version": "1.0.0",
022⫶      "description": "Example MCP Server"
023⫶    },
024⫶    "instructions": "Use this server to greet someone."
025⫶  }
026⫶}

docs/ai/mcp/mcp_config.md@307:``` http
docs/ai/mcp/mcp_config.md@308:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 52, 56) =]]
docs/ai/mcp/mcp_config.md@309:```

001⫶HTTP/1.1 202 Accepted
002⫶Access-Control-Allow-Headers: Content-Type, Mcp-Session-Id, Mcp-Protocol-Version, Last-Event-ID, Authorization, Accept
003⫶Access-Control-Allow-Methods: GET, POST, DELETE, OPTIONS
004⫶Access-Control-Allow-Origin: *
005⫶Access-Control-Expose-Headers: Mcp-Session-Id

docs/ai/mcp/mcp_config.md@317:``` json
docs/ai/mcp/mcp_config.md@318:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 69, 128) =]]
docs/ai/mcp/mcp_config.md@319:```

001⫶{
002⫶  "jsonrpc": "2.0",
003⫶  "id": 2,
004⫶  "result": {
005⫶    "tools": [
006⫶      {
007⫶        "name": "greet",
008⫶        "inputSchema": {
009⫶          "type": "object",
010⫶          "properties": {
011⫶            "name": {
012⫶              "type": "string",
013⫶              "description": "The name of the person to greet"
014⫶            }
015⫶          },
016⫶          "required": [
017⫶            "name"
018⫶          ]
019⫶        },
020⫶        "description": "Greet a user by name",
021⫶        "annotations": {
022⫶          "readOnlyHint": true,
023⫶          "destructiveHint": false,
024⫶          "idempotentHint": true,
025⫶          "openWorldHint": false
026⫶        },
027⫶        "icons": [
028⫶          {
029⫶            "src": "https://openmoji.org/data/color/svg/1F44B.svg"
030⫶          }
031⫶        ],
032⫶        "outputSchema": {
033⫶          "type": "object",
034⫶          "properties": {
035⫶            "general": {
036⫶              "type": "string",
037⫶              "description": "the safe way to greet someone"
038⫶            },
039⫶            "close": {
040⫶              "type": "string",
041⫶              "description": "when you're close to the person, like friends or relatives"
042⫶            },
043⫶            "morning": {
044⫶              "type": "string",
045⫶              "description": "when it's in the morning"
046⫶            },
047⫶            "afternoon": {
048⫶              "type": "string",
049⫶              "description": "when it's the afternoon"
050⫶            },
051⫶            "evening": {
052⫶              "type": "string",
053⫶              "description": "when it's late in the day"
054⫶            }
055⫶          }
056⫶        }
057⫶      }
058⫶    ]
059⫶  }
060⫶}

docs/ai/mcp/mcp_config.md@327:``` json
docs/ai/mcp/mcp_config.md@328:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 129, 148) =]]
docs/ai/mcp/mcp_config.md@329:```

001⫶{
002⫶  "jsonrpc": "2.0",
003⫶  "id": 3,
004⫶  "result": {
005⫶    "content": [
006⫶      {
007⫶        "type": "text",
008⫶        "text": "{\n    \"general\": \"Hello, World!\",\n    \"close\": \"Hey, World!\",\n    \"morning\": \"Good morning, World!\",\n    \"afternoon\": \"Good afternoon, World!\",\n    \"evening\": \"Good evening, World!\"\n}"
009⫶      }
010⫶    ],
011⫶    "isError": false,
012⫶    "structuredContent": {
013⫶      "general": "Hello, World!",
014⫶      "close": "Hey, World!",
015⫶      "morning": "Good morning, World!",
016⫶      "afternoon": "Good afternoon, World!",
017⫶      "evening": "Good evening, World!"
018⫶    }
019⫶  }
020⫶}

docs/ai/mcp/mcp_config.md@337:``` json
docs/ai/mcp/mcp_config.md@338:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 149, 172) =]]
docs/ai/mcp/mcp_config.md@339:```

001⫶{
002⫶  "jsonrpc": "2.0",
003⫶  "id": 4,
004⫶  "result": {
005⫶    "prompts": [
006⫶      {
007⫶        "name": "greet",
008⫶        "description": "Prompt to be greeted by the `greet` tool",
009⫶        "arguments": [
010⫶          {
011⫶            "name": "name",
012⫶            "description": "The name you want to be greeted by",
013⫶            "required": true
014⫶          }
015⫶        ],
016⫶        "icons": [
017⫶          {
018⫶            "src": "https://openmoji.org/data/color/svg/1F91D.svg"
019⫶          }
020⫶        ]
021⫶      }
022⫶    ]
023⫶  }
024⫶}

docs/ai/mcp/mcp_config.md@347:``` json
docs/ai/mcp/mcp_config.md@348:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 173, 187) =]]
docs/ai/mcp/mcp_config.md@349:```

001⫶{
002⫶  "jsonrpc": "2.0",
003⫶  "id": 5,
004⫶  "result": {
005⫶    "messages": [
006⫶      {
007⫶        "role": "user",
008⫶        "content": {
009⫶          "type": "text",
010⫶          "text": "Hi. My name is Firstname Lastname. Please, greet me."
011⫶        }
012⫶      }
013⫶    ]
014⫶  }
015⫶}


code_samples/mcp/src/Command/McpServerListCommand.php


code_samples/mcp/src/Command/McpServerListCommand.php

docs/ai/mcp/mcp_config.md@255:``` php
docs/ai/mcp/mcp_config.md@256:[[= include_code('code_samples/mcp/src/Command/McpServerListCommand.php') =]]
docs/ai/mcp/mcp_config.md@257:```

001⫶<?php declare(strict_types=1);
002⫶
003⫶namespace App\mcp\src\Command;
004⫶
005⫶use Ibexa\Contracts\Mcp\McpServerConfigurationRegistryInterface;
006⫶use Symfony\Component\Console\Attribute\AsCommand;
007⫶use Symfony\Component\Console\Command\Command;
008⫶use Symfony\Component\Console\Style\SymfonyStyle;
009⫶
010⫶#[AsCommand(name: 'app:mcp:server_list', description: 'List MCP servers')]
011⫶class McpServerListCommand
012⫶{
013⫶    public function __construct(private readonly McpServerConfigurationRegistryInterface $configRegistry)
014⫶    {
015⫶    }
016⫶
017⫶    public function __invoke(SymfonyStyle $io): int
018⫶    {
019⫶        foreach($this->configRegistry->getServerConfigurations() as $serverConfiguration) {
020⫶            $io->title($serverConfiguration->identifier);
021⫶            dump($serverConfiguration);
022⫶        }
023⫶
024⫶        return Command::SUCCESS;
025⫶    }
026⫶}


code_samples/mcp/src/Mcp/ExampleCapabilities.php


code_samples/mcp/src/Mcp/ExampleCapabilities.php

docs/ai/mcp/mcp_config.md@236:``` php
docs/ai/mcp/mcp_config.md@237:[[= include_code('code_samples/mcp/src/Mcp/ExampleCapabilities.php') =]]
docs/ai/mcp/mcp_config.md@238:```

001⫶<?php declare(strict_types=1);
002⫶
003⫶namespace App\Mcp;
004⫶
005⫶use Ibexa\Contracts\Mcp\Attribute\McpPrompt;
006⫶use Ibexa\Contracts\Mcp\Attribute\McpTool;
007⫶use Ibexa\Contracts\Mcp\McpCapabilityInterface;
008⫶use Mcp\Schema\Icon;
009⫶use Mcp\Schema\ToolAnnotations;
010⫶
011⫶final readonly class ExampleCapabilities implements McpCapabilityInterface
012⫶{
013⫶    /**
014⫶     * @param string $name The name of the person to greet
015⫶     *
016⫶     * @return array<string, string>
017⫶     */
018⫶    #[McpTool(
019⫶        servers: ['example'],
020⫶        name: 'greet',
021⫶        description: 'Greet a user by name',
022⫶        annotations: new ToolAnnotations(
023⫶            readOnlyHint: true,
024⫶            destructiveHint: false,
025⫶            idempotentHint: true,
026⫶            openWorldHint: false,
027⫶        ),
028⫶        icons: [new Icon(
029⫶            src: 'https://openmoji.org/data/color/svg/1F44B.svg',
030⫶        )],
031⫶        outputSchema: [
032⫶            'type' => 'object',
033⫶            'properties' => [
034⫶                'general' => [
035⫶                    'type' => 'string',
036⫶                    'description' => 'the safe way to greet someone',
037⫶                ],
038⫶                'close' => [
039⫶                    'type' => 'string',
040⫶                    'description' => 'when you\'re close to the person, like friends or relatives',
041⫶                ],
042⫶                'morning' => [
043⫶                    'type' => 'string',
044⫶                    'description' => 'when it\'s in the morning',
045⫶                ],
046⫶                'afternoon' => [
047⫶                    'type' => 'string',
048⫶                    'description' => 'when it\'s the afternoon',
049⫶                ],
050⫶                'evening' => [
051⫶                    'type' => 'string',
052⫶                    'description' => 'when it\'s late in the day',
053⫶                ],
054⫶            ],
055⫶        ],
056⫶    )]
057⫶    public function greetByName(string $name): array
058⫶    {
059⫶        return [
060⫶            'general' => sprintf('Hello, %s!', $name),
061⫶            'close' => sprintf('Hey, %s!', $name),
062⫶            'morning' => sprintf('Good morning, %s!', $name),
063⫶            'afternoon' => sprintf('Good afternoon, %s!', $name),
064⫶            'evening' => sprintf('Good evening, %s!', $name),
065⫶        ];
066⫶    }
067⫶
068⫶    /**
069⫶     * @param string $name The name you want to be greeted by
070⫶     *
071⫶     * @return array<string, mixed>
072⫶     */
073⫶    #[McpPrompt(
074⫶        servers: ['example'],
075⫶        name: 'greet',
076⫶        description: 'Prompt to be greeted by the `greet` tool',
077⫶        icons: [new Icon(
078⫶            src: 'https://openmoji.org/data/color/svg/1F91D.svg',
079⫶        )],
080⫶    )]
081⫶    public function getGreetPrompt(string $name): array
082⫶    {
083⫶        return [
084⫶            'role' => 'user',
085⫶            'content' => [
086⫶                'type' => 'text',
087⫶                'text' => "Hi. My name is $name. Please, greet me.",
088⫶            ],
089⫶        ];
090⫶    }
091⫶}


code_samples/mcp/stdio.mcp.json


code_samples/mcp/stdio.mcp.json

docs/ai/mcp/mcp_config.md@454:``` json
docs/ai/mcp/mcp_config.md@455:[[= include_code('code_samples/mcp/stdio.mcp.json') =]]
docs/ai/mcp/mcp_config.md@456:```

001⫶{
002⫶  "mcpServers": {
003⫶    "ibexa-example": {
004⫶      "type": "stdio",
005⫶      "command": "bash",
006⫶      "args": ["mcp-ibexa-example-wrapper.sh"],
007⫶      "tools": ["*"]
008⫶    }
009⫶  }
010⫶}


Download colorized diff

      		
    

  





        


            

            
            

              
            

        

      


      

            
  
  

    
  
    
    

  

  

  


    














  
  

    

      

  










  








  
      

  
    Sign up for free
    to join this conversation on GitHub.
    Already have an account?
    Sign in to comment


  










      

  

    
    

    

  

    Reviewers
  


    

    No reviews






    
    
    

    

  


      
  

    Assignees
  



        


    No one assigned







      


  


  

    Labels
  



    

    None yet







      

  

    

        

    Projects
  


        




    None yet




  



      


  

    
  

    Milestone
  


      No milestone





    
      
          


  

    

      
        

          
  

    Development
  



            


Successfully merging this pull request may close these issues.





  
  



      
    

  




      

    

  
        

  

    

      2 participants
    

    

        
          @adriendupuis 
        
          @mnocon