> ## Documentation Index > Fetch the complete documentation index at: https://developer.upsun.com/llms.txt > Use this file to discover all available pages before exploring further. # The Upsun MCP Server > The Upsun Model Context Protocol (MCP) Server allows users to perform infrastructure operations, monitor environments, and manage resources using natural language commands and AI assistants. {/* vale off */} The Upsun Model Context Protocol [(MCP) Server](https://devcenter.upsun.com/posts/upsun-mcp-announcement/) enables management of Upsun projects and environments through AI assistants such as Claude. It supports conversational commands to create, modify, and monitor infrastructure without using the terminal or console. MCP projects ## Key capabilities | Capability | Description | Use case | | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | **Natural Language Infrastructure Management** | Converts user instructions written in natural language to corresponding API operations. | - “Show me all active environments in my project.”
- “Add Redis caching to my staging environment.” | | **CI/CD Integration** | Integrates with existing development workflows and interacts with CI/CD pipelines to trigger or respond to automated workflows. | - Trigger deployments from the IDE.
- Monitor build progress from documentation tools or chat interfaces. | | **AI-Based Automation** | Supports AI-driven automation that adapts to real-world conditions by analyzing metrics, historical data, and usage patterns. | - Resource allocation based on usage trends.
- Automated troubleshooting with suggested root causes.
- Adaptive backup scheduling. | ## Security Model All MCP operations follow the existing Upsun [security model](https://upsun.com/trust-center/security/). The MCP Server defaults to read-only operations for safety, with write operations available through explicit configuration. To enable write operations, include the following header in your MCP configuration: ```json theme={null} { "enable-write": "true" } ```

Security Implications

Enable write operations **only** if you understand the associated security implications and trust your AI assistant to modify infrastructure resources. ## Architecture The Upsun MCP Server uses [Streamable HTTP transport](https://modelcontextprotocol.io/docs/learn/architecture) for communication and event streaming. It uses HTTP POST for client-to-server messages with optional Server-Sent Events for streaming capabilities. This transport enables remote server communication and supports standard HTTP authentication methods including bearer tokens, API keys, and custom headers. MCP Architecture ## Installation ### 1. Generate an API Token * In the Upsun [Console](https://console.upsun.com/), open your account settings. * Generate a new API token with permissions appropriate for your projects. ### 2. Configure the MCP Client * Configure your MCP client to connect to `mcp.upsun.com/mcp`. ### 3. Connect and Use * Connect your AI assistant or any MCP-compatible client. * Begin managing Upsun resources using natural language commands.

Select your preferred client

The Upsun MCP server works with all major AI development environments. **Choose your preferred client from the list below:**
Install in Cursor Go to: `Settings` -> `Cursor Settings` -> `MCP` -> `Add new global MCP server` Copying the following configuration into your Cursor `~/.cursor/mcp.json` file is the recommended approach. You may also install in a specific project by creating `.cursor/mcp.json` in your project folder. See the [Cursor MCP docs](https://docs.cursor.com/context/model-context-protocol) for more info. #### Cursor Remote Server Connection ```json theme={null} { "mcpServers": { "upsun": { "url": "https://mcp.upsun.com/mcp", "headers": { "upsun-api-token": "YOUR_API_TOKEN", "enable-write": "false" } } } } ```
Install in Claude Code Run this command. See [Claude Code MCP docs](https://docs.anthropic.com/en/docs/claude-code/mcp) for more info. #### Claude Code Remote Server Connection ```sh theme={null} claude mcp add --transport http upsun https://mcp.upsun.com/mcp --header "upsun-api-token: YOUR_API_TOKEN" --header "enable-write: false" ```
Install in Windsurf Add this to your Windsurf MCP config file. See [Windsurf MCP docs](https://docs.windsurf.com/windsurf/cascade/mcp) for more info. #### Windsurf Remote Server Connection ```json theme={null} { "mcpServers": { "upsun": { "serverUrl": "https://mcp.upsun.com/mcp", "headers": { "upsun-api-token": "YOUR_API_TOKEN", "enable-write": "false" } } } } ```
Install in VS Code Add this to your VS Code MCP config file. See [VS Code MCP docs](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) for more info. #### VS Code Remote Server Connection ```json theme={null} "mcp": { "servers": { "upsun": { "type": "http", "url": "https://mcp.upsun.com/mcp", "headers": { "upsun-api-token": "YOUR_API_TOKEN", "enable-write": "false" } } } } ```
Install in Cline You can easily configure the Upsun MCP server through Cline: 1. Open **Cline**. 2. Click the hamburger menu icon (☰) to enter the **MCP Servers** section. 3. On the **Remote Servers** tab, click **Edit Configuration**. 4. Add upsun to `mcpServers`: ```json theme={null} { "mcpServers": { "upsun": { "url": "https://mcp.upsun.com/mcp", "type": "streamableHttp", "headers": { "upsun-api-token": "YOUR_API_TOKEN", "enable-write": "false" } } } } ```
Install in Zed Add this to your Zed `settings.json`. See [Zed Context Server docs](https://zed.dev/docs/assistant/context-servers) for more info. ```json theme={null} { "context_servers": { "Upsun": { "settings": { "url": "https://mcp.upsun.com/mcp", "headers": { "upsun-api-token": "YOUR_API_TOKEN", "enable-write": "false" } } } } } ```
Install in Augment Code To configure the Upsun MCP server in Augment Code: **Manual Configuration** 1. Press Cmd/Ctrl+Shift+P or go to the hamburger menu in the Augment panel. 2. Select Edit Settings 3. Under Advanced, click Edit in settings.json 4. Add the server configuration to the `mcpServers` array in the `augment.advanced` object ```json theme={null} "augment.advanced": { "mcpServers": [ { "name": "upsun", "url": "https://mcp.upsun.com/mcp", "headers": { "upsun-api-token": "YOUR_API_TOKEN", "enable-write": "false" } } ] } ``` Once the MCP server is added, restart your editor. If you receive any errors, check the syntax to make sure closing brackets or commas are not missing.
Install in Roo Code Add this to your Roo Code MCP configuration file. See [Roo Code MCP docs](https://docs.roocode.com/features/mcp/using-mcp-in-roo) for more info. #### Roo Code Remote Server Connection ```json theme={null} { "mcpServers": { "upsun": { "type": "streamable-http", "url": "https://mcp.upsun.com/mcp", "headers": { "upsun-api-token": "YOUR_API_TOKEN", "enable-write": "false" } } } } ```
Install in Gemini CLI See [Gemini CLI Configuration](https://google-gemini.github.io/gemini-cli/docs/tools/mcp-server.html) for details. 1. Open the Gemini CLI settings file. The location is `~/.gemini/settings.json` (where `~` is your home directory). 2. Add the following to the `mcpServers` object in your `settings.json` file: ```json theme={null} { "mcpServers": { "upsun": { "httpUrl": "https://mcp.upsun.com/mcp", "headers": { "upsun-api-token": "YOUR_API_TOKEN", "enable-write": "false", "Accept": "application/json, text/event-stream" } } } } ``` If the `mcpServers` object does not exist, create it.
Install in Claude Desktop #### Remote Server Connection Open Claude Desktop and navigate to Settings > Connectors > Add Custom Connector. Enter the name as `Upsun` and the remote MCP server URL as `https://mcp.upsun.com/mcp`. Add your API token in the headers configuration: ```json theme={null} { "upsun-api-token": "YOUR_API_TOKEN", "enable-write": "false" } ```
Install in Opencode Add this to your Opencode configuration file. See [Opencode MCP docs](https://opencode.ai/docs/mcp-servers) for more info. #### Opencode Remote Server Connection ```json theme={null} "mcp": { "upsun": { "type": "remote", "url": "https://mcp.upsun.com/mcp", "headers": { "upsun-api-token": "YOUR_API_TOKEN", "enable-write": "false" }, "enabled": true } } ```
Install in JetBrains AI Assistant See [JetBrains AI Assistant Documentation](https://www.jetbrains.com/help/ai-assistant/configure-an-mcp-server.html) for more details. 1. In JetBrains IDEs, go to `Settings` -> `Tools` -> `AI Assistant` -> `Model Context Protocol (MCP)` 2. Click `+ Add`. 3. Click `Command` in the top-left corner of the dialog and select **As JSON** from the list. 4. Add this configuration and click `OK` ```json theme={null} { "mcpServers": { "upsun": { "url": "https://mcp.upsun.com/mcp", "headers": { "upsun-api-token": "YOUR_API_TOKEN", "enable-write": "false" } } } } ``` 5. Click `Apply` to save changes. 6. Repeat these steps to add `upsun` for JetBrains Junie: Go to `Settings` -> `Tools` -> `Junie` -> `MCP Settings`.
Install in Kiro See [Kiro Model Context Protocol Documentation](https://kiro.dev/docs/mcp/configuration/) for details. 1. Navigate `Kiro` > `MCP Servers` 2. Add a new MCP server by clicking the `+ Add` button. 3. Paste the configuration given below: ```json theme={null} { "mcpServers": { "Upsun": { "url": "https://mcp.upsun.com/mcp", "headers": { "upsun-api-token": "YOUR_API_TOKEN", "enable-write": "false" }, "disabled": false, "autoApprove": [] } } } ``` 4. Click `Save` to apply the changes.
Install in Trae Use the **Add manually** feature and populate the JSON configuration information for that MCP server. For more details, visit the [Trae documentation](https://docs.trae.ai/ide/model-context-protocol?_lang=en). #### Trae Remote Server Connection ```json theme={null} { "mcpServers": { "upsun": { "url": "https://mcp.upsun.com/mcp", "headers": { "upsun-api-token": "YOUR_API_TOKEN", "enable-write": "false" } } } } ```
Install in Amazon Q Developer CLI Add this to your Amazon Q Developer CLI configuration file. See [Amazon Q Developer CLI docs](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html) for more details. ```json theme={null} { "mcpServers": { "upsun": { "url": "https://mcp.upsun.com/mcp", "headers": { "upsun-api-token": "YOUR_API_TOKEN", "enable-write": "false" } } } } ```
Install in Warp See [Warp Model Context Protocol Documentation](https://docs.warp.dev/knowledge-and-collaboration/mcp#adding-an-mcp-server) for details. 1. Navigate `Settings` > `AI` > `Manage MCP servers`. 2. Add a new MCP server by clicking the `+ Add` button. 3. Paste the configuration given below: ```json theme={null} { "Upsun": { "url": "https://mcp.upsun.com/mcp", "headers": { "upsun-api-token": "YOUR_API_TOKEN", "enable-write": "false" }, "start_on_launch": true } } ``` 4. Click `Save` to apply the changes.
Install in Copilot Coding Agent **Using Upsun MCP with Copilot Coding Agent** Add the following configuration to the `mcp` section of your Copilot Coding Agent configuration file Repository->Settings->Copilot->Coding agent->MCP configuration: ```json theme={null} { "mcpServers": { "upsun": { "type": "http", "url": "https://mcp.upsun.com/mcp", "headers": { "upsun-api-token": "YOUR_API_TOKEN", "enable-write": "false" } } } } ``` For more information, see the [official GitHub documentation](https://docs.github.com/en/enterprise-cloud@latest/copilot/how-tos/agents/copilot-coding-agent/extending-copilot-coding-agent-with-mcp).
Install in LM Studio See [LM Studio MCP Support](https://lmstudio.ai/blog/lmstudio-v0.3.17) for more information. #### Manual set-up: 1. Navigate to `Program` (right side) > `Install` > `Edit mcp.json`. 2. Paste the configuration given below: ```json theme={null} { "mcpServers": { "Upsun": { "url": "https://mcp.upsun.com/mcp", "headers": { "upsun-api-token": "YOUR_API_TOKEN", "enable-write": "false" } } } } ``` 3. Click `Save` to apply the changes. 4. Toggle the MCP server on/off from the right hand side, under `Program`, or by clicking the plug icon at the bottom of the chat box.
Install in Visual Studio 2022 You can configure the Upsun MCP server in Visual Studio 2022 by following the [Visual Studio MCP Servers documentation](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022). Add this to your Visual Studio MCP config file (see the [Visual Studio docs](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022) for details): ```json theme={null} { "inputs": [], "servers": { "upsun": { "type": "http", "url": "https://mcp.upsun.com/mcp", "headers": { "upsun-api-token": "YOUR_API_TOKEN", "enable-write": "false" } } } } ``` For more information and troubleshooting, refer to the [Visual Studio MCP Servers documentation](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022).
Install in Crush Add this to your Crush configuration file. See [Crush MCP docs](https://github.com/charmbracelet/crush#mcps) for more info. #### Crush Remote Server Connection (HTTP) ```json theme={null} { "$schema": "https://charm.land/crush.json", "mcp": { "upsun": { "type": "http", "url": "https://mcp.upsun.com/mcp", "headers": { "upsun-api-token": "YOUR_API_TOKEN", "enable-write": "false" } } } } ```
Install in BoltAI Open the "Settings" page of the app, navigate to "Plugins," and configure the Upsun MCP server: ```json theme={null} { "mcpServers": { "upsun": { "url": "https://mcp.upsun.com/mcp", "headers": { "upsun-api-token": "YOUR_API_TOKEN", "enable-write": "false" } } } } ``` More information is available on [BoltAI's Documentation site](https://docs.boltai.com/docs/plugins/mcp-servers). For BoltAI on iOS, [see this guide](https://docs.boltai.com/docs/boltai-mobile/mcp-servers).
Install in Rovo Dev CLI Edit your Rovo Dev CLI MCP config by running the following command: ```bash theme={null} acli rovodev mcp ``` Example config - #### Remote Server Connection ```json theme={null} { "mcpServers": { "upsun": { "url": "https://mcp.upsun.com/mcp", "headers": { "upsun-api-token": "YOUR_API_TOKEN", "enable-write": "false" } } } } ```
Install in Zencoder To configure the Upsun MCP server in Zencoder, follow these steps: 1. Go to the Zencoder menu (...) 2. From the dropdown menu, select Agent tools 3. Click on the Add custom MCP 4. Add the name and server configuration from below, and make sure to hit the Install button ```json theme={null} { "url": "https://mcp.upsun.com/mcp", "headers": { "upsun-api-token": "YOUR_API_TOKEN", "enable-write": "false" } } ``` Once the MCP server is added, you can easily continue using it.
Install in Qodo Gen See [Qodo Gen docs](https://docs.qodo.ai/qodo-documentation/qodo-gen/qodo-gen-chat/agentic-mode/agentic-tools-mcps) for more details. 1. Open Qodo Gen chat panel in VSCode or IntelliJ. 2. Click Connect more tools. 3. Click + Add new MCP. 4. Add the following configuration: #### Qodo Gen Remote Server Connection ```json theme={null} { "mcpServers": { "upsun": { "url": "https://mcp.upsun.com/mcp", "headers": { "upsun-api-token": "YOUR_API_TOKEN", "enable-write": "false" } } } } ```
Install in Perplexity Desktop See [Local and Remote MCPs for Perplexity](https://www.perplexity.ai/help-center/en/articles/11502712-local-and-remote-mcps-for-perplexity) for more information. 1. Navigate to `Perplexity` > `Settings`. 2. Select `Connectors`. 3. Click `Add Connector`. 4. Select `Advanced`. 5. Enter Server Name: `Upsun` 6. Paste the following JSON in the text area: ```json theme={null} { "url": "https://mcp.upsun.com/mcp", "headers": { "upsun-api-token": "YOUR_API_TOKEN", "enable-write": "false" } } ``` 7. Click `Save`.
## Related content ### Upsun AI tutorials * Upsun [AI and Machine Learning tutorials](https://devcenter.upsun.com/posts/ai/?utm_source=docs\&utm_medium=ai-agent\&utm_campaign=tutorials) * [Experiment with Chainlit AI interface with RAG](https://devcenter.upsun.com/posts/deploying-chainlit-with-rag/) on Upsun * [Access Upsun Documentation contextually via Context7 + MCP](https://devcenter.upsun.com/posts/context7-mcp/) * Use the Upsun API to [automate Agent deployment](https://devcenter.upsun.com/posts/using-the-upsun-api/) * Upsun [MCP Server Announcement](https://devcenter.upsun.com/posts/upsun-mcp-announcement/) ### Upsun AI documentation * [Host AI Agents](/docs/get-started/ai/aiagent) on Upsun * [Deploy AI](/docs/get-started/ai) on Upsun