Stages Documentation

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/15 11:57] – Policnik, Florian261:mcpserver [2026/07/09 12:39] (current) – Policnik, Florian
Line 19: Line 19:
 ==== Installation ===== ==== Installation =====
  
-  * In Stages go to Administration -> Jobs and create a job for MCP (e.g. "mcp") 
-  * Upload the ''mcp.js'' file to MCP job 
-  * Run the job once 
-  * Specify a cron expression to keep the data updated 
   * Stop Stages   * Stop Stages
-  * Activate [[261:api-tokens|API tokens in Stages]] and restart 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
   * Choose the right WAR file:   * Choose the right WAR file:
Line 31: 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")
 +  * Upload the ''mcp.js'' file to MCP job
 +  * Run the job once
 +  * Specify a cron expression to keep the data updated
  
-If Stages is running, you can check the path "/mcp/status" on your Stages server to see if the MCP server is running. For example: ''<nowiki>https://stages.example.com/mcp/status</nowiki>''+If Stages is running, you can check the path ''/mcp/status'' on your Stages server to see if the MCP server is running. For example: ''<nowiki>https://stages.example.com/mcp/status</nowiki>''
  
 ==== Configure credentials ===== ==== Configure credentials =====
Line 46: 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 71: 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>