WIP mcp use cases

Author: egorpavlikhin

src/pages/docs/octopus-ai/mcp/index.mdx

@@ -9,4 +9,65 @@ description: An overview of the the Octopus MCP server, allowing AI clients to l
 navOrder: 2
 ---
 
-TODO: Content for an Octopus MCP landing page.
+### Octopus MCP Server
+
+The upcoming Octopus MCP ([Model Context Protocol](https://modelcontextprotocol.io/)) server represents a significant leap forward in AI integration capabilities. Built on Anthropic's open standard for connecting AI assistants to external data sources and tools, the MCP server will enable AI assistants like Claude to interact directly with your Octopus Deploy infrastructure.
+
+The Octopus MCP server provides similar capabilities to the Octopus AI Assistant, but provides further benefits:
+
+- You can use it with your client and model of choice.
+- It can work alongside other MCP servers to accomplish more complex orchestrations across Octopus and your other essential software services.
+
+The MCP server provides tools designed to solve key use-cases within change management, troubleshooting, administration audit & compliance, and standardization at scale.
+
+The MCP server architecture ensures that your deployment data remains secure while enabling powerful AI-assisted workflows. All interactions are logged and auditable, maintaining the compliance and governance standards your organization requires.
+
+We are releasing the MCP server as an open source tool that anyone can contribute to. It is available for free on Github at [https://github.com/OctopusDeploy/mcp-server](https://github.com/OctopusDeploy/mcp-server)
+
+:::div{.info}
+This project is currently in Early Access, and subject to breaking changes.
+:::
+
+## 🚀 Installation
+
+### Requirements
+- Node.js >= v20.0.0
+- Octopus Deploy instance that can be accessed by the MCP server via HTTPS
+- Octopus Deploy API Key
+
+### Configuration
+
+Full example configuration (for Claude Desktop, Claude Code, and Cursor):
+```json
+{
+  "mcpServers": {
+    "octopusdeploy": {
+      "command": "npx",
+      "args": ["-y", "@octopusdeploy/mcp-server", "--api-key", "YOUR_API_KEY", "--server-url", "https://your-octopus.com"]
+    }
+  }
+}
+```
+
+The Octopus MCP Server is typically configured within your AI Client of choice. 
+
+It is packaged as an npm package and executed via Node's `npx` command. Your configuration will include the command invocation `npx`, and a set of arguments that supply the Octoups MCP Server package and provide the Octopus Server URL and API key required, if they are not available as environment variables.
+
+The command line invocation you will be configuring will be one of the two following variants:
+
+```bash
+npx -y @octopusdeploy/mcp-server
+```
+
+With configuration provided via environment variables:
+```bash
+OCTOPUS_API_KEY=API-KEY
+OCTOPUS_SERVER_URL=https://your-octopus.com
+```
+
+Or with configuration supplied via the command line:
+```bash
+npx -y @octopusdeploy/mcp-server --server-url https://your-octopus.com --api-key YOUR_API_KEY
+```
+
+For detailed documentation visit [the official Github repo](https://github.com/OctopusDeploy/mcp-server).

src/pages/docs/octopus-ai/mcp/use-cases.mdx

@@ -11,39 +11,43 @@ navOrder: 1
 
 Quickly find out what version of your software a customer, represented by a Tenant, is running in Production, and identify if there were any issues with their most recent deployment.
 
-## 📝 Prompt
+### 📝 Prompt
 
 ```
 Customer X have submitted a support ticket complaining that there is a bug in the latest release of App. Can you tell me what release they are on, when it was deployed, and if there were any issues with the deployment?
 ```
 
 ## Capability: Troubleshooting
 
-TODO: Something about diagnosing deployment failure. K8s - live object status to show failure.
+Check for failed deployments or unhealthy kubernetes workloads, analyze the failure reasons and suggest solutions.
 
-## 📝 Prompt
+### 📝 Prompt
 
 ```
-TODO
+Check health of the {ServiceName} service in the {SpaceName} space and report any issues found, check status of kubernetes services to produce a comprehensive report
 ```
 
+### 💡 Tips for customizing
+
+- Prompt for kubernetes status to trigger kubernetes [live object status](/docs/kubernetes/live-object-status) check
+
 ## Capability: Administration, Audit, and Compliance
 
-TODO: something about providing a list of certificates in a space that are expiring in the next x months.
+Identify unhealthy resources, expiriting certificates or find unused projects in your Octopus instance.
 
-## 📝 Prompt
+### 📝 Prompt
 
 ```
-TODO
+Find certificates soon set to expire in {SpaceName} space
 ```
 
-## Capability: Standardization at Scale
+## Capability: Configuration Management
 
 TODO: something about finding an account that will provide you access to a particular azure subscription.
 
 See if it can work together with Azure MCP.
 
-## 📝 Prompt
+### 📝 Prompt
 
 ```
 TODO