Skip to main content

Deployments

This page lists the hosted MCP (Model Context Protocol) Services endpoints and how to register each with your AI client. For the registration mechanics see Getting started.

Hosted clusters​

ClusterPublic URLNotes
prod-1https://mcp.prod-1.octo-mesh.com/mcpProduction cluster — operate against production tenants only
prod-2https://mcp.prod-2.octo-mesh.com/mcpProduction cluster — operate against production tenants only
Production access

prod-1 and prod-2 expose live customer tenants. Every destructive call still requires confirm: true, but read calls (get_users, list_blueprint_installations, entity queries) hit real data. Treat these endpoints with the same care as the production Studio.

Internal test and staging environments use the same URL pattern (https://mcp.<cluster-domain>/mcp) but are not exposed to customers — contact the OctoMesh team if you need access for a pre-production rollout.

Register a hosted cluster​

# Claude Code
claude mcp add --transport http --scope user octomesh-prod-1 https://mcp.prod-1.octo-mesh.com/mcp
claude mcp add --transport http --scope user octomesh-prod-2 https://mcp.prod-2.octo-mesh.com/mcp
// Claude Desktop — claude_desktop_config.json
{
  "mcpServers": {
    "octomesh-prod-1": { "type": "http", "url": "https://mcp.prod-1.octo-mesh.com/mcp" },
    "octomesh-prod-2": { "type": "http", "url": "https://mcp.prod-2.octo-mesh.com/mcp" }
  }
}

Multiple environments side by side​

There is no constraint on registering several environments at once — each gets its own tool namespace inside the AI client (mcp__octomesh-prod-1__*, mcp__octomesh-prod-2__*, …). Tenant routing happens per call via the tenantId parameter, so you can administer different tenants in the same chat session without re-registering or re-authenticating per tenant.

You authenticate against each environment independently — they share no token store.

Local development​

Running the MCP Services from source against a local OctoMesh stack is covered in the Developer Guide: see MCP Services development → Local development.