@robinmordasiewicz/f5xc-terraform-mcp 2.11.0 → 2.12.0

package/README.md

@@ -16,20 +16,31 @@ Choose the installation method that best fits your environment:
 
 | Method | Best For | Requirements |
 |--------|----------|--------------|
-| [VSCode MCP Gallery](#vscode-mcp-gallery) | VSCode users with Node.js | VSCode 1.99+, Node.js |
+| [VSCode MCP Gallery](#vscode-mcp-gallery) | VSCode users (easiest) | VSCode 1.99+ |
 | [npx (Recommended)](#from-npm) | Developers with Node.js | Node.js 18+ |
-| [MCPB Bundle](#mcpb-bundle-no-nodejs-required) | Corporate laptops | None |
+| [MCPB Bundle](#mcpb-bundle-no-nodejs-required) | Corporate laptops (no Node.js) | None |
 | [From Source](#from-source) | Contributors | Node.js 18+, npm |
 
 ### VSCode MCP Gallery
 
-The easiest way to install if you're using VSCode with GitHub Copilot:
+The easiest way to install for VSCode users. Choose from multiple options:
+
+**Option A: MCP Gallery Search (Recommended for VSCode 1.105+)**
+
+1. Open VSCode
+2. Open the Extensions view (`Ctrl+Shift+X` / `Cmd+Shift+X`)
+3. Type `@MCP` in the search box to filter MCP servers
+4. Search for `f5xc` or `F5 Distributed Cloud`
+5. Click **Install**
+
+**Option B: Command Palette**
 
 1. Open VSCode
 2. Press `Ctrl+Shift+P` / `Cmd+Shift+P` to open Command Palette
 3. Run `MCP: Add Server`
-4. Search for `f5xc` or `@robinmordasiewicz/f5xc-terraform-mcp`
-5. Click Install
+4. Select `npm package`
+5. Enter: `@robinmordasiewicz/f5xc-terraform-mcp`
+6. Choose scope: **Global** (all workspaces) or **Workspace** (this project only)
 
 ### From npm
 
@@ -45,14 +56,26 @@ npx @robinmordasiewicz/f5xc-terraform-mcp
 
 ### MCPB Bundle (No Node.js Required)
 
-For corporate environments where Node.js cannot be installed:
+For corporate environments where Node.js cannot be installed. The MCPB bundle is fully self-contained with all dependencies included.
+
+**For VSCode:**
+
+1. Download the latest `.mcpb` file from [GitHub Releases](https://github.com/robinmordasiewicz/terraform-provider-f5xc/releases)
+2. In VSCode, press `Ctrl+Shift+P` / `Cmd+Shift+P`
+3. Run `MCP: Add Server`
+4. Drag and drop the `.mcpb` file, or select it when prompted
+5. Run `MCP: List Servers` to verify installation
+
+**For Claude Desktop:**
 
 1. Download the latest `.mcpb` file from [GitHub Releases](https://github.com/robinmordasiewicz/terraform-provider-f5xc/releases)
-2. Double-click the file to install, or drag it into Claude Desktop / VSCode
-3. The bundle includes everything needed - no external dependencies
+2. Double-click the file to install, or drag it into Claude Desktop
+3. Restart Claude Desktop to activate
 
 **File**: `f5xc-terraform-mcp-X.Y.Z.mcpb`
 
+-> **Note:** MCPB bundles are automatically built and attached to each GitHub Release. No npm or Node.js installation is required.
+
 ### From Source
 
 ```bash
@@ -174,6 +197,18 @@ To make the MCP server available across all workspaces, add to your VS Code user
 }
 ```
 
+**Verify VSCode Installation:**
+
+1. Press `Ctrl+Shift+P` / `Cmd+Shift+P`
+2. Run `MCP: List Servers`
+3. Look for `f5xc-terraform` with a green status indicator
+
+**Troubleshooting VSCode:**
+
+- **Server not appearing**: Restart VSCode after adding the server configuration
+- **Connection issues**: Check the Output panel (`View > Output`) and select "MCP" from the dropdown
+- **Node.js not found**: Use the [MCPB Bundle](#mcpb-bundle-no-nodejs-required) method instead
+
 ## Available Tools
 
 ### Documentation Tools

package/dist/docs/resources/api_credential.md

@@ -49,6 +49,8 @@ resource "f5xc_api_credential" "example" {
 
 <a id="name"></a>&#x2022; [`name`](#name) - Required String<br>Name of the API Credential. Must be unique within the namespace
 
+<a id="namespace"></a>&#x2022; [`namespace`](#namespace) - Required String<br>Namespace where the API Credential will be created
+
 <a id="annotations"></a>&#x2022; [`annotations`](#annotations) - Optional Map<br>Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata
 
 <a id="description"></a>&#x2022; [`description`](#description) - Optional String<br>Human readable description for the object
@@ -57,8 +59,6 @@ resource "f5xc_api_credential" "example" {
 
 <a id="labels"></a>&#x2022; [`labels`](#labels) - Optional Map<br>Labels is a user defined key value map that can be attached to resources for organization and filtering
 
-<a id="namespace"></a>&#x2022; [`namespace`](#namespace) - Optional String<br>Namespace for the API Credential. For this resource type, namespace should be empty or omitted
-
 ### Spec Argument Reference
 
 <a id="password"></a>&#x2022; [`password`](#password) - Optional String<br>Password. Password is used for generating an API certificate P12 bundle user can use to protect access to it. this password will not be saved/persisted anywhere in the system. Applicable for credential type API_CERTIFICATE Users have to use this password when they use the certificate, e.g. in curl or while adding to key chain

package/dist/docs/resources/child_tenant.md

@@ -54,8 +54,6 @@ resource "f5xc_child_tenant" "example" {
 
 <a id="name"></a>&#x2022; [`name`](#name) - Required String<br>Name of the Child Tenant. Must be unique within the namespace
 
-<a id="namespace"></a>&#x2022; [`namespace`](#namespace) - Required String<br>Namespace where the Child Tenant will be created
-
 <a id="annotations"></a>&#x2022; [`annotations`](#annotations) - Optional Map<br>Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata
 
 <a id="description"></a>&#x2022; [`description`](#description) - Optional String<br>Human readable description for the object
@@ -64,6 +62,8 @@ resource "f5xc_child_tenant" "example" {
 
 <a id="labels"></a>&#x2022; [`labels`](#labels) - Optional Map<br>Labels is a user defined key value map that can be attached to resources for organization and filtering
 
+<a id="namespace"></a>&#x2022; [`namespace`](#namespace) - Optional String<br>Namespace for the Child Tenant. For this resource type, namespace should be empty or omitted
+
 ### Spec Argument Reference
 
 <a id="child-tenant-manager"></a>&#x2022; [`child_tenant_manager`](#child-tenant-manager) - Optional Block<br>Object reference. This type establishes a direct reference from one object(the referrer) to another(the referred). Such a reference is in form of tenant/namespace/name<br>See [Child Tenant Manager](#child-tenant-manager) below for details.

package/dist/docs/resources/cloud_connect.md

@@ -54,8 +54,6 @@ resource "f5xc_cloud_connect" "example" {
 
 <a id="name"></a>&#x2022; [`name`](#name) - Required String<br>Name of the Cloud Connect. Must be unique within the namespace
 
-<a id="namespace"></a>&#x2022; [`namespace`](#namespace) - Required String<br>Namespace where the Cloud Connect will be created
-
 <a id="annotations"></a>&#x2022; [`annotations`](#annotations) - Optional Map<br>Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata
 
 <a id="description"></a>&#x2022; [`description`](#description) - Optional String<br>Human readable description for the object
@@ -64,6 +62,8 @@ resource "f5xc_cloud_connect" "example" {
 
 <a id="labels"></a>&#x2022; [`labels`](#labels) - Optional Map<br>Labels is a user defined key value map that can be attached to resources for organization and filtering
 
+<a id="namespace"></a>&#x2022; [`namespace`](#namespace) - Optional String<br>Namespace for the Cloud Connect. For this resource type, namespace should be empty or omitted
+
 ### Spec Argument Reference
 
 -> **One of the following:**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robinmordasiewicz/f5xc-terraform-mcp",
-  "version": "2.11.0",
+  "version": "2.12.0",
   "description": "MCP server for F5 Distributed Cloud Terraform provider - provides documentation and API specification access for AI assistants",
   "type": "module",
   "main": "dist/index.js",