📘 Cloudamize MCP Server – Admin & Setup Guide

🧩 Overview

Cloudamize MCP Server is a secure integration layer that connects Cloudamize APIs with:

AI assistants (Cursor, Claude Desktop, etc.)
AI agents
Enterprise agentic systems (AWS Transform, Kiro, workflows)

It provides access to:

Migration plans
Infrastructure assessment
Cost (TCO) insights
Recommendations
Migration grouping

🌐 Deployment Options

Mode	Endpoint	Use
🌍 Hosted	https://mcp.cloudamize.com	Recommended
🐳 Local	http://localhost:8080	Restricted environments

🌍 Hosted MCP Setup

🔑 Generate Token (Valid for 12 hours)

CODE

API_USER="your-email@cloudamize.com"
API_PASS="your-password"

AUTH=$(printf "%s:%s" "$API_USER" "$API_PASS" | base64)

TOKEN=$(curl --silent \
  --location 'https://precloud-api.cloudamize.com/auth/token?termsAccepted=true' \
  --header "Authorization: Basic $AUTH" \
  | tr -d '\n' | cut -d'"' -f4)

🚀 Call MCP

CODE

Authorization: Bearer <TOKEN>

CODE

curl --location 'https://mcp.cloudamize.com/mcp' \
--header "Authorization: Bearer $TOKEN" \
--data '{}'

🔐 API Key Option

CODE

X-API-Key: <API_KEY>
X-Customer-Id: <CUSTOMER_ID>

🐳 Local MCP Setup (Docker)

CODE

docker pull cloudamize/cmz-mcp-server:latest
(docker hub or aws ECR repo is yet to decide and set)

CODE

docker run -d \
  -p 8080:8080 \
  -e MODE=http \
  -e PRECLOUD_BASE_URL=https://precloud-api.cloudamize.com \
  -e GRAPH_BASE_URL=https://mp-api.cloudamize.com/api/v1 \
  cloudamize/cmz-mcp-server:latest

📡 Local Endpoint

CODE

http://localhost:8080/mcp

⏳ Token Info

Token validity: 12 hours
Expired token → returns 401 Unauthorized
Must be refreshed periodically

🔐 Auth Methods

Bearer Token (recommended)
API Key (server-to-server)

🧠 Architecture

CODE

AI Assistant / AI Agent
        ↓
MCP Server (Hosted / Local)
        ↓
Cloudamize APIs

⚙️ Admin Configuration

Variable	Description
MODE	http / stdio
PRECLOUD_BASE_URL	Cloudamize API endpoint
GRAPH_BASE_URL	Graph API endpoint
MCP_API_KEY	API key enforcement
JWT_TOKEN	Bearer token (stdio mode)

📌 Summary

Hosted MCP is recommended: https://mcp.cloudamize.com
Local Docker available for restricted environments
Token expires every 12 hours
Supports AI assistants, AI agents, and enterprise agentic systems