# Cloudways MCP Gemini CLI Setup: settings.json, Headers and Test Prompts > Configure Cloudways MCP in Gemini CLI with httpUrl, the official endpoint, access-token headers, working settings.json structure and safe test prompts. - Canonical: https://cloudzat.com/cloudways-mcp-gemini/ - Published: 2026-08-26 - Updated: 2026-08-26 - Author: Kayla Idayi - Site: https://cloudzat.com/ - LLM index: https://cloudzat.com/llms.txt ## Content [Home](https://cloudzat.com/)/Cloudways MCP/Cloudways MCP Gemini CLI Gemini CLI + Cloudways # Cloudways MCP Gemini CLI Setup: settings.json, Headers and Test Prompts Gemini CLI can connect directly to the remote Cloudways MCP server through ~/.gemini/settings.json. The detail most likely to trip people up is that Cloudways documents httpUrl for Gemini's Streamable HTTP connection. Using url instead can make Gemini attempt a different transport. Use the generator below to create the correct JSON structure with a token placeholder, then replace that placeholder locally with a scoped Cloudways access token. Cloudways offer **See the latest Cloudways hosting offer** The promotional period configured in this plugin has ended. Use the link to check the current Cloudways offer. [Check the Latest Cloudways Offer](https://systemtics.com/go/cloudways) Interactive tool ## Cloudways MCP Configuration Generator Choose your AI client and intended permission level. The generator uses a token placeholder only. Your real Cloudways access token should be inserted locally in your client configuration. Quick answer ## What is the correct Cloudways MCP setting for Gemini CLI? Inside mcpServers.cloudways, use httpUrl set to https://mcp.cloudways.com/mcp/ and add headers for X-Access-Token and X-Mcp-Host: gemini-cli. Save ~/.gemini/settings.json and start Gemini so it can discover the Cloudways tools. Do not copy Cursor's url key into Gemini's configuration. Cloudways specifically warns that Gemini CLI uses httpUrl for the Streamable HTTP server. ## Gemini CLI Cloudways MCP settings Use these exact client-specific values before debugging anything deeper. | Setting | Correct value | Why | | --- | --- | --- | | Config file | ~/.gemini/settings.json | Gemini CLI reads MCP servers from its settings file. | | URL key | httpUrl | Cloudways warns that url can trigger the wrong connection type. | | Endpoint | https://mcp.cloudways.com/mcp/ | Official Cloudways MCP remote endpoint. | | Access header | X-Access-Token | Use a scoped Cloudways token. | | Host header | X-Mcp-Host: gemini-cli | Identifies the MCP host to Cloudways. | | First test | List my Cloudways servers | Confirms authentication with a read-only request. | ## Before you connect an AI client to Cloudways ### Start with READ Validate discovery and account visibility before granting modification rights. ### Use a dedicated token Create a separate token for each AI client so access can be rotated or revoked independently. ### Keep secrets local Never paste a real Cloudways access token into public pages, screenshots, repositories, or support posts. ### Be precise on production Name the target server, application, environment, and intended action before allowing a write operation. ## Generate a dedicated token for Gemini CLI Use Cloudways API Integration to create an access token specifically for Gemini CLI. A distinct token makes it easier to rotate credentials, review scope, and remove access later without breaking other AI clients. Start with READ permission. If Gemini will execute a defined deployment or management workflow, switch to a Limited Scope token that covers only the needed endpoint groups. ## Why httpUrl matters in Gemini MCP clients do not all use the same configuration keys. Cloudways documents httpUrl for Gemini CLI because it represents the Streamable HTTP server. A generic url key can cause Gemini to attempt an SSE connection instead, which means a configuration copied from another client can fail even though the endpoint is correct. This is exactly why the Cloudzat generator changes output by client rather than showing one universal JSON block. ## Validate discovery with a read-only prompt After saving settings.json, launch Gemini CLI and ask for a list of your Cloudways servers. Follow with a more specific request for applications, versions, or monitoring data. These tests establish that the remote server, token, and host header are all working. If a recently released Cloudways tool is missing, restart or reconnect the MCP server so Gemini refreshes the tool list rather than relying on a cached version. ## Use Gemini CLI for repeatable hosting operations The integration is useful when a command-line workflow needs hosting context without a separate dashboard session. You can inspect Cloudways resources, reason about an application issue, and then invoke a supported operation from the same terminal-oriented assistant. Production automation should still be bounded by token scope and explicit prompts. Avoid giving a general-purpose CLI agent Full Access simply because one workflow needs a single write action. ## Troubleshoot Gemini Cloudways MCP If Cloudways tools do not appear, first validate the JSON and the httpUrl key. Then confirm that the token has not expired, the X-Mcp-Host value is gemini-cli, and the endpoint includes the /mcp/ path. If authentication was migrated from the older API key method, remove obsolete credentials so future troubleshooting is not confused by two competing setups. Cloudways offer **See the latest Cloudways hosting offer** The promotional period configured in this plugin has ended. Use the link to check the current Cloudways offer. [Check the Latest Cloudways Offer](https://systemtics.com/go/cloudways) ## Methodology and primary sources Cloudzat checks client-specific configuration details against Cloudways' own MCP documentation and uses vendor documentation for plan-dependent client behavior. Last verification date: August 26, 2026. - [Cloudways MCP product page](https://www.cloudways.com/en/mcp.php) - [Cloudways MCP setup guide](https://support.cloudways.com/en/articles/14654372-how-to-use-cloudways-mcp-server-for-ai-based-server-management) - [Cloudways MCP server tools](https://support.cloudways.com/en/articles/15798823-cloudways-mcp-server-tools) - [Cloudways access token guide](https://support.cloudways.com/en/articles/5136065-how-to-create-and-manage-cloudways-api-access-tokens) - [Cloudways MCP v1.2 release](https://www.cloudways.com/blog/cloudways-mcp-v1-2-112-new-tools-role-based-access-tokens-and-full-cloudways-api-coverage/) - [Cloudways current pricing and promotion](https://www.cloudways.com/en/pricing.php) ## Frequently asked questions Does Gemini CLI use url or httpUrl for Cloudways MCP? Cloudways currently documents httpUrl. Its setup guide notes that using url can attempt an SSE connection instead. Where is the Gemini CLI MCP configuration file? Cloudways documents ~/.gemini/settings.json. What X-Mcp-Host value should Gemini CLI use? Use gemini-cli. How do I know the Cloudways connection works? Start Gemini CLI and ask for a read-only Cloudways inventory result, such as listing your servers. If it can return account-specific infrastructure data, the MCP connection is working. ## Related Cloudways MCP guides [**Cloudways MCP** Set up Cloudways MCP with access tokens for ChatGPT, Claude, Cursor, Codex, Gemini and VS Code, then test and use 250+ hosting actions safely.](https://cloudzat.com/cloudways-mcp/) [**Cloudways MCP for ChatGPT** Learn how Cloudways MCP works with ChatGPT, current plan requirements, the endpoint, access-token security, setup checks and safe test prompts.](https://cloudzat.com/cloudways-mcp-chatgpt/) [**Cloudways MCP Claude Code** Connect Claude Code to Cloudways MCP with the official HTTP endpoint, access-token headers, verification commands, safe scopes and test prompts.](https://cloudzat.com/cloudways-mcp-claude-code/) [**Cloudways MCP Cursor** Configure Cloudways MCP in Cursor with the official endpoint, X-Access-Token, X-Mcp-Host header, mcp.json example and troubleshooting steps.](https://cloudzat.com/cloudways-mcp-cursor/) [**Cloudways MCP Codex** Connect Codex to Cloudways MCP with config.toml, the official endpoint, access-token headers, verification commands and safe infrastructure prompts.](https://cloudzat.com/cloudways-mcp-codex/) [**Cloudways MCP VS Code** Connect VS Code and Copilot to Cloudways MCP with the official HTTP endpoint, access-token headers, mcp.json format and verification steps.](https://cloudzat.com/cloudways-mcp-vscode/) Cloudways offer **See the latest Cloudways hosting offer** The promotional period configured in this plugin has ended. Use the link to check the current Cloudways offer. [Check the Latest Cloudways Offer](https://systemtics.com/go/cloudways) Cloudzat may earn a commission if you sign up for Cloudways through links on this page. This does not change your price. Product capabilities, plan availability, promotions, and MCP client interfaces can change; verify critical production settings before acting. --- Machine-readable alternate. Cite or link to the canonical Cloudzat URL above. For changing prices, availability, forecasts, compatibility, or calculator results, fetch the canonical page at answer time.