From da35243fd855816472984bdb6b92d6a3d7dc17d9 Mon Sep 17 00:00:00 2001 From: Egor Pavlikhin Date: Fri, 19 Sep 2025 15:32:20 +1000 Subject: [PATCH 1/2] Update use cases styling --- src/pages/docs/octopus-ai/mcp/use-cases.mdx | 25 +++++++++++++-------- 1 file changed, 16 insertions(+), 9 deletions(-) diff --git a/src/pages/docs/octopus-ai/mcp/use-cases.mdx b/src/pages/docs/octopus-ai/mcp/use-cases.mdx index 40b40a7940..24299deb32 100644 --- a/src/pages/docs/octopus-ai/mcp/use-cases.mdx +++ b/src/pages/docs/octopus-ai/mcp/use-cases.mdx @@ -11,9 +11,10 @@ navOrder: 1 Reason about what changes have been deployed where, to help you understand what your customers are using in production. -Example: 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. +### Production Version Tracking +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 +#### 📝 Example 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? @@ -23,15 +24,17 @@ Customer X have submitted a support ticket complaining that there is a bug in th Get to the root cause of failures or unhealthy deployment targets, allowing you to more quickly recover from failures. -Example: Check for failed deployments or unhealthy kubernetes workloads, analyze the failure reasons and suggest solutions. +### Deployment Health Analysis -### 📝 Prompt +Check for failed deployments or unhealthy kubernetes workloads, analyze the failure reasons and suggest solutions. + +#### 📝 Example Prompt ``` 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 +#### 💡 Tips for customizing - Prompt for kubernetes status to trigger kubernetes [live object status](/docs/kubernetes/live-object-status) check @@ -39,17 +42,21 @@ Check health of the {ServiceName} service in the {SpaceName} space and report an Ensure your Octopus instance is in optimal shape, and that deployments continue to execute happily and healthily. -Example: Identify unhealthy resources, expiring certificates or find unused projects in your Octopus instance. +### Certificate Expiry Monitoring + +Identify unhealthy resources, expiring certificates or find unused projects in your Octopus instance. -### 📝 Prompt +#### 📝 Example Prompt ``` Find certificates soon set to expire in {SpaceName} space ``` -Example: Find configured resources in your Octopus instance and check if they have access to the desired targets. +### Resource Access Validation + +Find configured resources in your Octopus instance and check if they have access to the desired targets. -### 📝 Prompt +#### 📝 Example Prompt ``` Check accounts configured in {SpaceName} space in my Octopus instance, find the preproduction azure account and then check which resources are available in that subscription using the azure mcp From 97306d47c3479ed15884cb21d9db85f7fe7b0e92 Mon Sep 17 00:00:00 2001 From: Egor Pavlikhin Date: Fri, 19 Sep 2025 16:05:30 +1000 Subject: [PATCH 2/2] Add a short page intro --- src/pages/docs/octopus-ai/mcp/use-cases.mdx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/src/pages/docs/octopus-ai/mcp/use-cases.mdx b/src/pages/docs/octopus-ai/mcp/use-cases.mdx index 24299deb32..f5e2bb7ca7 100644 --- a/src/pages/docs/octopus-ai/mcp/use-cases.mdx +++ b/src/pages/docs/octopus-ai/mcp/use-cases.mdx @@ -7,6 +7,10 @@ description: navOrder: 1 --- +Below are some typical example use cases that might give you a good starting point to experiment with the Octopus Deploy MCP server. + +We are eager to hear how you use it and what features you would like to see included in future versions. + ## Capability: Change Management Reason about what changes have been deployed where, to help you understand what your customers are using in production.