IONOS CLOUD MCP Setup & Guide
io.github.ionos-cloud/ionoscloud-mcp · v1.1.2
Inspect and manage IONOS CLOUD infrastructure via MCP. Writes are opt-in and off by default.
Copy the install config on this page first, then verify docs and permissions upstream.
Overview
Inspect and manage IONOS CLOUD infrastructure via MCP. Writes are opt-in and off by default. IONOS CLOUD MCP Server is a MCP Server listed from MCP Registry. Transports: stdio. This page includes an overview, setup tutorial, install commands, and use cases for Trae, Tongyi Lingma, Cursor, Claude Code, and VS Code.
Use cases
AgentHub Verified AvailabilityTested & Ready
Automated pipeline validated install commands, protocol & client compatibility
Copy by platform
Choose your platform
- Open or create .cursor/mcp.json in your project root
- Click Copy config and paste; merge only this mcpServers entry if others exist
- Replace <placeholders> in env with real secrets (see Environment variables below)
- Save, then Cmd+Shift+P → Reload Window
Pre-fill Environment Variables (Optional)
{
"mcpServers": {
"ionoscloud-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/ionos-cloud/ionoscloud-mcp:1.1.2"
],
"env": {
"IONOS_TOKEN": "<IONOS_TOKEN>"
}
}
}
}Setup tutorial
- Open the IONOS CLOUD MCP Server page and confirm this MCP Server (source: MCP Registry).
- Copy the Cursor, Claude Code, or VS Code snippet.
- Merge it into mcpServers and replace env placeholders with real secrets.
- Reload the window, then call the MCP tools from your agent chat.
Install commands
Install commands and setup steps are in the HTML so search engines and no-JS browsers can read them without running client JavaScript.
Claude Code (local)
- Install Claude Code CLI
- Copy the command below, replace <placeholders> with real env values, then run in terminal
- See Environment variables below if listed
claude mcp add ionoscloud-mcp --env IONOS_TOKEN=<IONOS_TOKEN> -- docker run -i --rm ghcr.io/ionos-cloud/ionoscloud-mcp:1.1.2Cursor — .cursor/mcp.json (local)
- Open or create .cursor/mcp.json in your project root
- Click Copy config and paste; merge only this mcpServers entry if others exist
- Replace <placeholders> in env with real secrets (see Environment variables below)
- Save, then Cmd+Shift+P → Reload Window
{
"mcpServers": {
"ionoscloud-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/ionos-cloud/ionoscloud-mcp:1.1.2"
],
"env": {
"IONOS_TOKEN": "<IONOS_TOKEN>"
}
}
}
}VS Code — .vscode/mcp.json (local)
- Install GitHub Copilot in VS Code with MCP support
- Open or create .vscode/mcp.json in your project root
- Click Copy config and paste; merge only this mcpServers entry if others exist
- Replace <placeholders> in env with real secrets
- Save and Developer: Reload Window
{
"mcpServers": {
"ionoscloud-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/ionos-cloud/ionoscloud-mcp:1.1.2"
],
"env": {
"IONOS_TOKEN": "<IONOS_TOKEN>"
}
}
}
}Claude Desktop — claude_desktop_config.json (local)
- Open Claude Desktop claude_desktop_config.json (see remote guide for paths)
- Click Copy config and merge under mcpServers
- Replace <placeholders> in env with real secrets
- Fully quit and restart Claude Desktop
{
"mcpServers": {
"ionoscloud-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/ionos-cloud/ionoscloud-mcp:1.1.2"
],
"env": {
"IONOS_TOKEN": "<IONOS_TOKEN>"
}
}
}
}Trae — .trae/mcp.json (local)
- Trae → Settings → MCP, or edit .trae/mcp.json / global mcp.json
- Click Copy config and merge mcpServers
- Replace <placeholders> in env with real secrets
- Save and reload Trae
{
"mcpServers": {
"ionoscloud-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/ionos-cloud/ionoscloud-mcp:1.1.2"
],
"env": {
"IONOS_TOKEN": "<IONOS_TOKEN>"
}
}
}
}Cherry Studio — MCP settings (local)
- Cherry Studio → Settings → MCP Servers → Add (STDIO)
- Or import JSON: click Copy config and merge mcpServers
- Replace <placeholders> in env; ensure Node.js / uv (npx, uvx) are installed
- Enable the server and check tools load
{
"mcpServers": {
"ionoscloud-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/ionos-cloud/ionoscloud-mcp:1.1.2"
],
"env": {
"IONOS_TOKEN": "<IONOS_TOKEN>"
}
}
}
}Tongyi Lingma — MCP config (local)
- Lingma Settings → MCP → + → STDIO or config file
- Click Copy config and merge mcpServers
- Replace <placeholders> in env; need Node.js 18+ (npx) or uv (uvx)
- Confirm connected before using tools in agent chat
{
"mcpServers": {
"ionoscloud-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/ionos-cloud/ionoscloud-mcp:1.1.2"
],
"env": {
"IONOS_TOKEN": "<IONOS_TOKEN>"
}
}
}
}Windsurf — mcp_config.json (local)
- Edit ~/.codeium/windsurf/mcp_config.json
- Click Copy config and merge mcpServers (stdio same as Cursor)
- Replace <placeholders> in env, save, refresh Cascade
{
"mcpServers": {
"ionoscloud-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/ionos-cloud/ionoscloud-mcp:1.1.2"
],
"env": {
"IONOS_TOKEN": "<IONOS_TOKEN>"
}
}
}
}Cline — MCP Servers (local)
- Cline panel → Settings → MCP Servers
- Click Copy config and merge
- Replace <placeholders> in env, then save
{
"mcpServers": {
"ionoscloud-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/ionos-cloud/ionoscloud-mcp:1.1.2"
],
"env": {
"IONOS_TOKEN": "<IONOS_TOKEN>"
}
}
}
}WorkBuddy — .workbuddy/mcp.json (local)
- Edit ~/.workbuddy/mcp.json (user) or project .workbuddy/mcp.json
- Or Plugins → MCP Servers → Configure MCP and paste the JSON below
- Replace <placeholders> in env; on Windows prefer absolute paths for command/scripts
- Save, restart WorkBuddy, confirm connector status is green
{
"mcpServers": {
"ionoscloud-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/ionos-cloud/ionoscloud-mcp:1.1.2"
],
"env": {
"IONOS_TOKEN": "<IONOS_TOKEN>"
}
}
}
}Troubleshooting & Common ErrorsFAQ
Common connection errors and verified fixes for IONOS CLOUD MCP Server
Getting 'connection closed' or exit code 1 in Cursor / Claude Code for IONOS CLOUD MCP Server?
Usually caused by missing runtime paths or IDE environment inheritance. Fix steps: 1. Verify Node.js 18+ (npx) or Python 3.10+ (uvx) is installed; 2. Run 'which npx' or 'which uvx' in terminal, and replace 'command' with absolute path; 3. Reload or restart the client window after modifying config.
# Check binary path in terminal: which npx node -v
Getting 'spawn npx ENOENT' or 'command not found'?
The editor background process does not inherit your full terminal PATH. Solution: Globally install the package, or set the absolute binary path (e.g. C:\Program Files\nodejs\npx.cmd on Windows, or /usr/local/bin/npx on macOS).
Missing required environment variable or authentication failure?
IONOS CLOUD MCP Server requires environment variables (IONOS_TOKEN). Ensure you have added valid keys under the 'env' object in your config file without trailing whitespace.
// .cursor/mcp.json 或 claude_desktop_config.json
{
"env": {
"IONOS_TOKEN": "your_actual_key_here"
}
}Tool Mock Playground
SandboxIONOS CLOUD MCP Server Tool Interface Simulation · Preview tool schema & outputs without local runtime
{
"target": "IONOS CLOUD MCP Server",
"action": "execute",
"options": {
"mode": "standard",
"timeoutMs": 5000
}
}Click 'Run Mock' above
to preview the raw response returned to the LLM
Decision Guide: Why & When to Use
Assess suitability before installing to save trial-and-error time
- PR review
- Changelog generation
- Cross-repo issue search
- Replacing human security audit
- Unauthorized repo access
IONOS CLOUD MCP Server + Scenario Prompt → Complete Agent Automation
MCP hands-on: install to visible results
Follow the full lab (expected UI/output + contrast checks). After installing this item, verify with the tutorial prompts.
Related resources
Deus Witness
v0.2.27
io.github.sipkigroup/witness
Checks every MCP tool call of your agent with an independent witness and gives signed receipts.
pepe
v0.55.2
io.github.omarmhaimdat/pepe
Load-test a URL, ping it by phase, ramp to find the capacity, compare runs: JSON reports, guardrails
Bowmark
v8.190.1
ai.bowmark/bowmark
Do things on live websites: prices, availability, quotes, bookings, anything behind a form or login.
ReMCP
v0.2.177
io.github.getremcp/remcp
Securely control paired computers with ReMCP.
Deyaho Phone Calls MCP
v0.1.6
com.deyaho/phone-calls
Let any AI agent make real phone calls to Mexico and Spain. Telephony included, 0.25 USD/min.
Shurava
v1.0.0
com.shurava/shurava
Run your Shurava focus groups from Claude — questions, polls, members, campaigns.
Often paired with
中文公文写作
v2.0.41
io.clawhub.gongyu0918-debug/chinese-official-writing
用于中文公文、事务性材料和新闻稿件的起草、改写、压缩、润色、审校、文种核对、去口语化、降 AI 味及 Word 格式处理，适用于机关、企事业单位、学校和新闻机构。涵盖申请、请示、报告、通知、通告、意见、决定、决议、议案、公报、命令、函、复函、批复、说明、方案、纪要、公告、公示、通报、制度、规定、办法、细则、操作规程、工作要点、总结、调研、讲话、致辞、主持词、述职、可研、审查材料、技术需求、新闻消息、编者按、新闻评论，以及采购、整改、反馈和 AI 算力等场景。
Planning with files
v3.25.0
io.clawhub.othmanadi/planning-with-files
Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk; lifecycle hooks inject selected project planning context. Automatic recovery reads project planning files only. Explicit session-catchup.py --metadata reads same-project local agent session records and emits aggregate counts only; --replay may emit bounded nonce-framed excerpts. Optional gated mode can request continuation only when the host supports it and never runs commands declared in Markdown. The skill has no network upload path. Use for research or work needing 5+ tool calls.
canonry
v7.50.1+a36190c
io.clawhub.arberx/canonry
Navigate Canonry through connected MCP tools or the `cnry` CLI to inspect evidence, diagnose changes, plan measurement, review integrations, and report results. Use this optional host-native skill for CLI workflows and detailed references; connected MCP users can operate through canonry_help without installing a local runtime or skill.
gitlab-cli-skills
v1.13.33
io.clawhub.vince-winkintel/gitlab-cli-skills
Comprehensive GitLab CLI (glab) command reference and workflows for all GitLab operations. Use when working with merge requests, CI/CD pipelines, issues, releases, repositories, authentication, variables, labels, milestones, snippets, or any glab command. Covers 40+ sub-commands including glab mr, glab ci, glab issue, glab repo, glab release, glab variable, and more.
Keep exploring AgentHub
Most people compare similar tools or check scenario guides before installing—start here.
Listing badge: put AgentHub on your site
Copy either snippet into your project homepage, docs, or GitHub README. The badge is a hotlinked SVG — nothing to host — and it links back to this page so visitors can find the install steps.
<a href="https://myagenthub.cn/p/io.github.ionos-cloud/ionoscloud-mcp" title="Listed on AgentHub: IONOS CLOUD MCP Server" target="_blank" rel="noopener">
<img src="https://myagenthub.cn/badge/io.github.ionos-cloud/ionoscloud-mcp?lang=en" alt="Listed on AgentHub: IONOS CLOUD MCP Server" height="20" style="border:0"/>
</a>[](https://myagenthub.cn/p/io.github.ionos-cloud/ionoscloud-mcp)Badges are generated on the fly from /badge/<package-id>, so name and listing changes propagate automatically. Keep the link target unchanged — it is what counts as the referral.
Unified Manifest
{
"id": "io.github.ionos-cloud/ionoscloud-mcp",
"type": "mcp-server",
"version": "1.1.2",
"displayName": "IONOS CLOUD MCP Server",
"description": "Inspect and manage IONOS CLOUD infrastructure via MCP. Writes are opt-in and off by default.",
"repository": {
"url": "https://github.com/ionos-cloud/ionoscloud-mcp",
"source": "github"
},
"distribution": {
"packages": [
{
"registryType": "oci",
"identifier": "ghcr.io/ionos-cloud/ionoscloud-mcp:1.1.2",
"transport": "stdio",
"environmentVariables": [
{
"name": "IONOS_TOKEN",
"description": "IONOS CLOUD API token (required for all products except Object Storage)",
"isRequired": true,
"isSecret": true
},
{
"name": "IONOS_S3_ACCESS_KEY",
"description": "S3 access key for IONOS Object Storage",
"isSecret": true
},
{
"name": "IONOS_S3_SECRET_KEY",
"description": "S3 secret key for IONOS Object Storage",
"isSecret": true
},
{
"name": "IONOS_MCP_LOAD_MODE",
"description": "Tool registration strategy (the --load-mode flag overrides this). 'eager' (default): register all tools at startup. 'lazy': defer Compute and Object Storage behind 'ionos_load_compute_tools' / 'ionos_load_objectstorage_tools' sentinel tools (requires MCP client support for notifications/tools/list_changed). 'dynamic' (alias 'search'): expose only the ionos_search_tools / ionos_describe_tools / ionos_call_tool meta-tools and browse the full catalog through them — for clients with hard tool caps and no tool search of their own (Cursor, Windsurf)."
},
{
"name": "IONOS_MCP_TOOL_SCOPE",
"description": "Opt in to write operations. Unset (default) leaves the server read-only: only list_/get_/head_ tools are registered. 'write' additionally registers create_/update_ tools and the non-disruptive actions (start_, resume_, attach_, assign_); 'destructive' also registers delete_ and the disruptive actions (stop_, reboot_, suspend_, upgrade_, restore_, detach_, recreate_, import_) and implies 'write'. Comma-separated, case-insensitive, hierarchical; unrecognised values stay read-only. WARNING: enabling this lets an AI model provision, modify and delete billable resources in a live IONOS CLOUD account. Every create and delete requires a two-phase confirmation, but that cannot stop a client configured to approve tool calls automatically. Leave unset unless writes are needed."
}
]
}
],
"remotes": []
},
"dependencies": [],
"installTargets": [
"claude-code",
"claude-desktop",
"cursor",
"vscode",
"trae",
"cherry-studio",
"lingma",
"windsurf",
"cline",
"workbuddy"
],
"keywords": [],
"provenance": {
"origin": "official-mcp-registry",
"originalId": "io.github.ionos-cloud/ionoscloud-mcp",
"originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.ionos-cloud%2Fionoscloud-mcp/versions/latest",
"isOfficial": true,
"status": "active"
}
}