Part 15 of 15 • 🔴 Advanced • ⏱️ 120 minutes

Deploying Remote Containerized MCP Servers on IBM Cloud Code Engine: Overcoming 422 Gateway Errors & SSE Handshakes

Architecting containerized Node.js/Python MCP microservices, configuring streamable HTTP / SSE, and solving gateway connection mapping issues.

---

Step 1: Write Tool Logic (server.js)

import express from "express";
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
import { z } from "zod";

const app = express();
const server = new McpServer({
  name: "enterprise-ticket-mcp",
  version: "1.0.0"
});

server.tool(
  "query_incident",
  "Lookup incident details from enterprise ITSM",
  { incident_id: z.string().describe("Incident ticket identifier, e.g. INC-1029") },
  async ({ incident_id }) => {
    return {
      content: [{
        type: "text",
        text: `Incident ${incident_id}: High CPU Alert in cluster ca-tor. Status: Investigating.`
      }]
    };
  }
);

let transport = null;

app.get("/sse", async (req, res) => {
  console.log("👉 [WxO Handshake] SSE Connection established");
  transport = new SSEServerTransport("/message", res);
  await server.connect(transport);
});

app.post("/message", async (req, res) => {
  if (transport) {
    await transport.handlePostMessage(req, res);
  } else {
    res.status(400).send("No active transport");
  }
});

app.get("/health", (req, res) => res.json({ status: "healthy", timestamp: new Date() }));

const PORT = process.env.PORT || 8080;
app.listen(PORT, () => console.log(`🚀 Remote MCP server listening on port ${PORT}`));

Step 2: Dependencies (requirements.txt)

express>=4.18.2
@modelcontextprotocol/sdk>=1.0.1
zod>=3.22.0

Step 3: Agent Manifest (agent.yaml)

spec_version: v1
kind: native
name: remote_incident_agent
title: "Remote Incident Commander"
description: "Connects to containerized MCP microservices running on IBM Cloud Code Engine."
model: ibm/granite-3-8b-instruct
tools:
  - query_incident

Step 4: Live Execution

curl -i https://mcp-ticket-demo.ca-tor.codeengine.appdomain.cloud/health

HTTP/2 200 
content-type: application/json; charset=utf-8
{
  "status": "healthy",
  "timestamp": "2026-09-24T20:30:00.000Z"
}

---

💡 Pro Tips & Architecture Insights

---