Skip to content

Enhance DDEV and MCP - #3334

Open
adriendupuis wants to merge 10 commits into
5.0from
enh-mcp
Open

Enhance DDEV and MCP#3334
adriendupuis wants to merge 10 commits into
5.0from
enh-mcp

Conversation

@adriendupuis

@adriendupuis adriendupuis commented Jul 31, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor
Question Answer
JIRA Ticket
Versions
Edition

Cherry-pick MCP and DDEV changes from #3283 to 5.0

  • Scheduled tasks (cron) and background tasks (Messenger) within DDEV
  • MCP
    • in scripts, use variable to store full MCP server URL
    • few config tricks

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

github-actions Bot commented Jul 31, 2026 •
edited
Loading

Copy link
Copy Markdown

Preview of modified files

Preview of modified Markdown:

@github-actions

github-actions Bot commented Jul 31, 2026 •
edited
Loading

Copy link
Copy Markdown

Summary

Status Count
🔍 Total 736648
🔗 Unique 14764
✅ Successful 6191
⏳ Timeouts 0
🔀 Redirected 0
👻 Excluded 730457
❓ Unknown 0
🚫 Errors 0
⛔ Unsupported 0

Full Github Actions output

adriendupuis
adriendupuis commented Jul 31, 2026
View reviewed changes
Comment thread docs/ai/mcp/mcp_guide.md Outdated
@github-actions

github-actions Bot commented Aug 3, 2026

Copy link
Copy Markdown

code_samples/ change report

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

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


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

docs/ai/mcp/mcp_usage.md@343:``` bash
docs/ai/mcp/mcp_usage.md@344:[[= include_code('code_samples/mcp/mcp-ibexa-example-wrapper.sh') =]]
docs/ai/mcp/mcp_usage.md@345:```
docs/ai/mcp/mcp_usage.md@353:``` bash
docs/ai/mcp/mcp_usage.md@354:[[= include_code('code_samples/mcp/mcp-ibexa-example-wrapper.sh') =]]
docs/ai/mcp/mcp_usage.md@355:```

001⫶#!/bin/bash
002⫶set -e
003⫶
004⫶baseUrl='http://localhost' # Adapt to your test case

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
005⫶mcpServer="$baseUrl/mcp/example"
006⫶
007⫶jwtToken=$(curl -s -X 'POST' \
008⫶  "$baseUrl/api/ibexa/v2/user/token/jwt" \
009⫶  -H 'Content-Type: application/vnd.ibexa.api.JWTInput+json' \
010⫶  -H 'Accept: application/vnd.ibexa.api.JWT+json' \
011⫶  -d '{
012⫶        "JWTInput": {
013⫶          "_media-type": "application/vnd.ibexa.api.JWTInput+json",
014⫶          "username": "ibexa-example",
015⫶          "password": "Ibexa-3xample"
016⫶        }
017⫶      }' | jq -r .JWT.token)
018⫶
019⫶exec npx -y supergateway \
020⫶  --streamableHttp "$mcpServer" \
021⫶  --oauth2Bearer "$jwtToken" \
022⫶  --logLevel none


code_samples/mcp/mcp.sh



code_samples/mcp/mcp.sh

docs/ai/mcp/mcp_usage.md@168:``` bash
docs/ai/mcp/mcp_usage.md@169:[[= include_code('code_samples/mcp/mcp.sh', 5, 7) =]]
docs/ai/mcp/mcp_usage.md@170:```
docs/ai/mcp/mcp_usage.md@178:``` bash
docs/ai/mcp/mcp_usage.md@179:[[= include_code('code_samples/mcp/mcp.sh', 5, 8) =]]
docs/ai/mcp/mcp_usage.md@180:```

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

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


docs/ai/mcp/mcp_usage.md@174:``` bash
docs/ai/mcp/mcp_usage.md@175:[[= include_code('code_samples/mcp/mcp.sh', 9, 23) =]]
docs/ai/mcp/mcp_usage.md@176:```
docs/ai/mcp/mcp_usage.md@184:``` bash
docs/ai/mcp/mcp_usage.md@185:[[= include_code('code_samples/mcp/mcp.sh', 10, 24) =]]
docs/ai/mcp/mcp_usage.md@186:```

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


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_usage.md@178:``` json
docs/ai/mcp/mcp_usage.md@179:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 1, 7) =]]
docs/ai/mcp/mcp_usage.md@180:```
docs/ai/mcp/mcp_usage.md@188:``` json
docs/ai/mcp/mcp_usage.md@189:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 1, 7) =]]
docs/ai/mcp/mcp_usage.md@190:```

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⫶}


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_usage.md@184:``` bash
docs/ai/mcp/mcp_usage.md@185:[[= include_code('code_samples/mcp/mcp.sh', 21, 44) =]]
docs/ai/mcp/mcp_usage.md@186:```
docs/ai/mcp/mcp_usage.md@194:``` bash
docs/ai/mcp/mcp_usage.md@195:[[= include_code('code_samples/mcp/mcp.sh', 22, 45) =]]
docs/ai/mcp/mcp_usage.md@196:```

001⫶cat response.tmp.txt | jq
002⫶jwtToken=$(cat response.tmp.txt | jq -r .JWT.token)
003⫶rm response.tmp.txt
004⫶

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" \
005⫶curl -s -i -X 'POST' "$mcpServer" \
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 -i 'Mcp-Session-Id:' | sed 's/Mcp-Session-Id: \([0-9a-f-]*\).*/\1/i')
024⫶rm response.tmp.txt

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 -i 'Mcp-Session-Id:' | sed 's/Mcp-Session-Id: \([0-9a-f-]*\).*/\1/i')
024⫶rm response.tmp.txt

docs/ai/mcp/mcp_usage.md@188:``` http
docs/ai/mcp/mcp_usage.md@189:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 8, 16) =]]
docs/ai/mcp/mcp_usage.md@190:```
docs/ai/mcp/mcp_usage.md@198:``` http
docs/ai/mcp/mcp_usage.md@199:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 8, 16) =]]
docs/ai/mcp/mcp_usage.md@200:```

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


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_usage.md@192:``` json
docs/ai/mcp/mcp_usage.md@193:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 26, 51) =]]
docs/ai/mcp/mcp_usage.md@194:```
docs/ai/mcp/mcp_usage.md@202:``` json
docs/ai/mcp/mcp_usage.md@203:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 26, 51) =]]
docs/ai/mcp/mcp_usage.md@204:```

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⫶}


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_usage.md@198:``` bash
docs/ai/mcp/mcp_usage.md@199:[[= include_code('code_samples/mcp/mcp.sh', 46, 52) =]]
docs/ai/mcp/mcp_usage.md@200:```
docs/ai/mcp/mcp_usage.md@208:``` bash
docs/ai/mcp/mcp_usage.md@209:[[= include_code('code_samples/mcp/mcp.sh', 47, 53) =]]
docs/ai/mcp/mcp_usage.md@210:```


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

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_usage.md@202:``` http
docs/ai/mcp/mcp_usage.md@203:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 52, 56) =]]
docs/ai/mcp/mcp_usage.md@204:```
docs/ai/mcp/mcp_usage.md@212:``` http
docs/ai/mcp/mcp_usage.md@213:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 52, 56) =]]
docs/ai/mcp/mcp_usage.md@214:```

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


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_usage.md@208:``` bash
docs/ai/mcp/mcp_usage.md@209:[[= include_code('code_samples/mcp/mcp.sh', 54, 61) =]]
docs/ai/mcp/mcp_usage.md@210:```
docs/ai/mcp/mcp_usage.md@218:``` bash
docs/ai/mcp/mcp_usage.md@219:[[= include_code('code_samples/mcp/mcp.sh', 55, 62) =]]
docs/ai/mcp/mcp_usage.md@220:```


001⫶curl -s -X 'POST' "$baseUrl/mcp/example" \
001⫶curl -s -X 'POST' "$mcpServer" \
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

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_usage.md@212:``` json
docs/ai/mcp/mcp_usage.md@213:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 69, 128) =]]
docs/ai/mcp/mcp_usage.md@214:```
docs/ai/mcp/mcp_usage.md@222:``` json
docs/ai/mcp/mcp_usage.md@223:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 69, 128) =]]
docs/ai/mcp/mcp_usage.md@224:```

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⫶}


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_usage.md@218:``` bash
docs/ai/mcp/mcp_usage.md@219:[[= include_code('code_samples/mcp/mcp.sh', 63, 76) =]]
docs/ai/mcp/mcp_usage.md@220:```
docs/ai/mcp/mcp_usage.md@228:``` bash
docs/ai/mcp/mcp_usage.md@229:[[= include_code('code_samples/mcp/mcp.sh', 64, 77) =]]
docs/ai/mcp/mcp_usage.md@230:```


001⫶curl -s -X 'POST' "$baseUrl/mcp/example" \
001⫶curl -s -X 'POST' "$mcpServer" \
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

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_usage.md@222:``` json
docs/ai/mcp/mcp_usage.md@223:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 129, 148) =]]
docs/ai/mcp/mcp_usage.md@224:```
docs/ai/mcp/mcp_usage.md@232:``` json
docs/ai/mcp/mcp_usage.md@233:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 129, 148) =]]
docs/ai/mcp/mcp_usage.md@234:```

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⫶}


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_usage.md@228:``` bash
docs/ai/mcp/mcp_usage.md@229:[[= include_code('code_samples/mcp/mcp.sh', 78, 85) =]]
docs/ai/mcp/mcp_usage.md@230:```
docs/ai/mcp/mcp_usage.md@238:``` bash
docs/ai/mcp/mcp_usage.md@239:[[= include_code('code_samples/mcp/mcp.sh', 79, 86) =]]
docs/ai/mcp/mcp_usage.md@240:```


001⫶curl -s -X 'POST' "$baseUrl/mcp/example" \
001⫶curl -s -X 'POST' "$mcpServer" \
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

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_usage.md@232:``` json
docs/ai/mcp/mcp_usage.md@233:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 149, 172) =]]
docs/ai/mcp/mcp_usage.md@234:```
docs/ai/mcp/mcp_usage.md@242:``` json
docs/ai/mcp/mcp_usage.md@243:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 149, 172) =]]
docs/ai/mcp/mcp_usage.md@244:```

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⫶}


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_usage.md@238:``` bash
docs/ai/mcp/mcp_usage.md@239:[[= include_code('code_samples/mcp/mcp.sh', 87, 100) =]]
docs/ai/mcp/mcp_usage.md@240:```
docs/ai/mcp/mcp_usage.md@248:``` bash
docs/ai/mcp/mcp_usage.md@249:[[= include_code('code_samples/mcp/mcp.sh', 88, 101) =]]
docs/ai/mcp/mcp_usage.md@250:```


001⫶curl -s -X 'POST' "$baseUrl/mcp/example" \
001⫶curl -s -X 'POST' "$mcpServer" \
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

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_usage.md@242:``` json
docs/ai/mcp/mcp_usage.md@243:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 173, 187) =]]
docs/ai/mcp/mcp_usage.md@244:```
docs/ai/mcp/mcp_usage.md@252:``` json
docs/ai/mcp/mcp_usage.md@253:[[= include_code('code_samples/mcp/mcp.sh.output.txt', 173, 187) =]]
docs/ai/mcp/mcp_usage.md@254:```

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⫶}


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⫶}


Download colorized diff

      		
    

  





        

            

            

              
            

        

      


      

            
  
  

    
  
    
    

  

  

  


    












      

  
          

  
  

  
    

        

              @adriendupuis


        

      

            adriendupuis


            marked this pull request as ready for review

        August 3, 2026 08:04        
        
      

    














  
  

    

      

  










  








  
      

  
    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.





  
  



      
    

  




      

    

  
        

  

    

      1 participant
    

    

        
          @adriendupuis