Cloudgate MCP

Build and manage Cloudgate workflow-APIs — controllers, actions, workflow graphs, and databases — from any MCP-compatible AI client, including Claude, OpenAI Codex, and others.

Cloudgate runs a hosted, remote MCP server at api.cloudgate.dev. It speaks the standard Model Context Protocol over streamable HTTP and authenticates each user with OAuth, so any client that supports remote MCP servers can connect. This repo also packages the server as a ready-to-install Claude plugin for convenience.

• MCP server URL: https://api.cloudgate.dev/mcp/workflow
• Registry: listed in the official MCP Registry as dev.cloudgate/workflow

Connect

Claude (Cowork / Desktop / Web)

1. Open Customize → Plugins.
2. In Personal plugins, click + → Add marketplace.
3. Choose Add from a repository and enter this repo: https://github.com/cloudgatedevs/mcp
4. Install cloudgate-builder from the marketplace.
5. Start a chat and ask to list your Cloudgate controllers — you'll be sent to hub.cloudgate.dev to sign in, then the tools become available.

Claude Code

claude plugin marketplace add cloudgatedevs/mcp
claude plugin install cloudgate-builder@cloudgate-app-templates

OpenAI Codex

Add the remote server to ~/.codex/config.toml (OAuth remote servers use Codex's RMCP client):

experimental_use_rmcp_client = true

[mcp_servers.cloudgate]
url = "https://api.cloudgate.dev/mcp/workflow"

Then authenticate:

codex mcp login cloudgate

Other MCP clients

Any client that supports remote (streamable HTTP) MCP servers can connect directly to https://api.cloudgate.dev/mcp/workflow and complete the OAuth sign-in.

For clients that only support stdio servers, bridge to the remote endpoint with mcp-remote:

{
  "mcpServers": {
    "cloudgate": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.cloudgate.dev/mcp/workflow"]
    }
  }
}

Authentication

The Cloudgate MCP server uses OAuth 2.1 (authorization code + PKCE). Each user signs in as themselves; every MCP call is scoped to that user's tenant and account. No tokens or secrets are stored in this repository.

What's in this repo

The hosted server works on its own with any MCP client. This repo additionally ships the cloudgate-builder Claude plugin, which bundles the connection config plus a cloudgate-build skill — a playbook that guides the model through creating controllers, actions, workflow graphs, and databases correctly.

.claude-plugin/marketplace.json     # Claude marketplace manifest (lists the plugins)
plugins/cloudgate-builder/          # the Claude plugin
  .claude-plugin/plugin.json        # plugin manifest
  .mcp.json                         # MCP server connection (native remote HTTP)
  README.md                         # plugin readme
  skills/cloudgate-build/SKILL.md   # the cloudgate-build skill
server.json                         # MCP Registry metadata (dev.cloudgate/workflow)

License

© Cloudgate Dev LLC.