OpenCode - Installation Guide¶

OpenCode is an open-source terminal editor with built-in MCP support. Installing the F5 XC Cloud Status MCP server is done through a single configuration edit.

Prerequisites¶

Before starting, ensure you have: - OpenCode installed (which opencode should return a path) - Node.js 18.0.0 or higher (node --version) - npm installed (comes with Node.js)

Installation¶

Step 1: Locate OpenCode Configuration¶

OpenCode stores MCP server configuration in ~/.config/opencode/opencode.json:

# View your OpenCode configuration
cat ~/.config/opencode/opencode.json

If the file doesn't exist, OpenCode will create it on first launch.

Step 2: Add the F5 XC Cloud Status MCP Server¶

Edit the opencode.json file and add the server to the mcp section:

# Open the file in your editor
vim ~/.config/opencode/opencode.json

Add this configuration to the mcp object:

{
  "mcp": {
    "f5xc-cloudstatus": {
      "type": "local",
      "command": ["npx", "-y", "@robinmordasiewicz/f5xc-cloudstatus-mcp@latest"],
      "environment": {}
    }
  }
}

Step 3: Complete Example¶

Here's what the complete file might look like:

{
  "model": "opencode/minimax-m2.1-free",
  "plugin": ["oh-my-opencode"],
  "mcp": {
    "f5xc-cloudstatus": {
      "type": "local",
      "command": ["npx", "-y", "@robinmordasiewicz/f5xc-cloudstatus-mcp@latest"],
      "environment": {}
    }
  }
}

Verification¶

Method 1: Start OpenCode¶

# Start OpenCode terminal UI
opencode

# The MCP server will be available immediately
# Try typing a prompt like:
# "What is the current status of F5 Cloud services?"

Method 2: Command Line Verification¶

# Verify the package can be accessed
npx @robinmordasiewicz/f5xc-cloudstatus-mcp@latest --version

# You should see version information if successful

Quick Test Prompts¶

After installation, try these prompts to verify the server works:

Basic Status Check:

Prompt: "What is the current status of F5 Cloud services?"
Expected: Overall status, operational indicator, timestamp
Response Time: < 5 seconds

Component Listing:

Prompt: "Show me all F5 Cloud service components"
Expected: 100+ components organized by category
Response Time: < 5 seconds

Incident Check:

Prompt: "Are there any active incidents affecting F5 Cloud?"
Expected: Active incidents or confirmation of no issues
Response Time: < 5 seconds

Configuration Reference¶

Multiple MCP Servers¶

You can add multiple MCP servers in the same configuration:

{
  "mcp": {
    "f5xc-cloudstatus": {
      "type": "local",
      "command": ["npx", "-y", "@robinmordasiewicz/f5xc-cloudstatus-mcp@latest"],
      "environment": {}
    },
    "other-server": {
      "type": "local",
      "command": ["npx", "-y", "other-mcp-package"],
      "environment": {}
    }
  }
}

Using Local Development Build¶

If you're developing the MCP server locally:

{
  "mcp": {
    "f5xc-cloudstatus": {
      "type": "local",
      "command": ["node", "/path/to/f5xc-cloudstatus-mcp/dist/index.js"],
      "environment": {}
    }
  }
}

Replace /path/to/f5xc-cloudstatus-mcp with your actual project path.

Troubleshooting¶

"npx: command not found"¶

• Cause: Node.js or npm not properly installed
• Solution: Install Node.js from https://nodejs.org (v18.0.0+)
• Verify: Run npm --version

"Cannot find module '@robinmordasiewicz/f5xc-cloudstatus-mcp'"¶

• Cause: Package not on npm registry or network issue
• Solution: Check internet connection, run npm cache clean --force, then retry
• Verify: Run npm search @robinmordasiewicz/f5xc-cloudstatus-mcp

"Invalid JSON in opencode.json"¶

• Cause: Syntax error in configuration file
• Solution: Validate JSON: python -m json.tool ~/.config/opencode/opencode.json
• Fix: Check for missing commas, quotes, or brackets

Server not appearing in OpenCode¶

• Cause: Configuration not loaded or syntax error
• Solution:
• Verify JSON is valid: python -m json.tool ~/.config/opencode/opencode.json
• Check file location: ls -la ~/.config/opencode/opencode.json
• Restart OpenCode: opencode
• Verify: Run cat ~/.config/opencode/opencode.json | grep f5xc-cloudstatus

Uninstallation¶

To remove the F5 XC Cloud Status MCP server:

1. Edit ~/.config/opencode/opencode.json
2. Remove the f5xc-cloudstatus block from the mcp section
3. Restart OpenCode

{
  "mcp": {
    // f5xc-cloudstatus block removed
  }
}

Comparison with Claude Code¶

Next Steps¶

• Review Troubleshooting Guide if issues arise
• Check Home for tool descriptions and verification queries

Installation Time: ~2-3 minutes Difficulty Level: Easy Restart Required: No (just restart OpenCode) Last Updated: January 2026