Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
261:mcpserver [2026/04/22 07:47] – [Installation] Policnik, Florian261:mcpserver [2026/07/09 12:39] (current) Policnik, Florian
Line 22: Line 22:
   * Activate [[261:api-tokens|API tokens in Stages]]   * Activate [[261:api-tokens|API tokens in Stages]]
   * Add ''mcp-server.properties'' to the Stages conf folder   * Add ''mcp-server.properties'' to the Stages conf folder
-    * adapt ''mcp-server.properties'' file regarding the workspace to be accessible 
   * Choose the right WAR file:   * Choose the right WAR file:
     * Stages 7.12: ''mcp-web-tomcat-9-*.war''     * Stages 7.12: ''mcp-web-tomcat-9-*.war''
Line 28: Line 27:
     * Extract the WAR file to ''stages/tomcat/webapps/mcp''. Ensue that the folders ''META-INF'' and ''WEB-INF'' are directly in the ''mcp'' folder     * Extract the WAR file to ''stages/tomcat/webapps/mcp''. Ensue that the folders ''META-INF'' and ''WEB-INF'' are directly in the ''mcp'' folder
   * Start Stages   * Start Stages
 +  * Go to the Company workspace and add the workspace variable ''mcpDefaultWorkspace''. Set the value to the ID of the workspace that you want to access.
   * In Stages go to Administration -> Jobs and create a job for MCP (e.g. "mcp")   * In Stages go to Administration -> Jobs and create a job for MCP (e.g. "mcp")
   * Upload the ''mcp.js'' file to MCP job   * Upload the ''mcp.js'' file to MCP job
Line 47: Line 47:
 ==== Configure AI system ===== ==== Configure AI system =====
  
-Currently Stages MCP server supports Server-Sent Events (SSE) protocol. The endpoint is ''/mcp/sse'', e.g.:+Configuration depends on Stages version 
 + 
 +=== Stages 7.12 / Tomcat 9 === 
 + 
 +Currently Stages MCP server supports Server-Sent Events (SSE) protocol for Tomcat 9 version. The endpoint is ''/mcp/sse'', e.g.:
  
 ''<nowiki>https://stages.example.com/mcp/sse</nowiki>'' ''<nowiki>https://stages.example.com/mcp/sse</nowiki>''
  
 The API token that was created must be provided to the MCP server via the header ''StagesToken''. The API token that was created must be provided to the MCP server via the header ''StagesToken''.
- 
  
 An example MCP configuration: An example MCP configuration:
Line 72: Line 75:
 </code> </code>
  
 +
 +=== Stages 26.1 / Tomcat 10 ===
 +
 +Currently Stages MCP server supports Streamable HTTP protocol for Tomcat 10 version. The endpoint is ''/mcp/http'', e.g.:
 +
 +''<nowiki>https://stages.example.com/mcp/http</nowiki>''
 +
 +The API token that was created must be provided to the MCP server via the header ''StagesToken''.
 +
 +An example MCP configuration:
 +
 +<code javascript>
 +{
 +  "command": "npx",
 +  "args": [
 +    "mcp-remote",
 +    "https://stages.example.com/mcp/http",
 +    "--header",
 +    "StagesToken: ${AUTH_TOKEN}"
 +  ],
 +  "env": {
 +    "AUTH_TOKEN": "eyJh..."
 +  },
 +  "active": true
 +}
 +</code>