Skip to content

Self-Hosted MCP


Overview

The self-hosted CloudAEye deployment includes an OAuth-protected MCP server for Claude Code. This page covers the deployment and installation steps.

Prerequisites

  • A deployed CloudAEye self-hosted environment.
  • The value returned by terraform output -raw app_base_url.
  • Claude Code.
  • A tenant account created by the deployment bootstrap task.

Step 1: Get The MCP Endpoint

From the Terraform deployment directory, get the application URL:

terraform output -raw app_base_url

Configure the MCP endpoint as:

<app_base_url>/mcp

The required OAuth scope is mcp:tools.

Step 2: Install The Plugin

Add the marketplace and install the plugin with the self-hosted endpoint:

/plugin marketplace add CloudAEye/claude-plugin
/plugin install cloudaeye --config url=<app_base_url>/mcp

Restart Claude Code after installation so the MCP server connection is loaded.

Step 3: Authenticate

  1. Run /mcp in Claude Code.
  2. Select CloudAEye and choose Authenticate.
  3. Sign in at <app_base_url>/ui/auth/sign-in and approve the consent screen.
  4. Return to Claude Code after the browser reports a successful connection.

The initial admin uses the password account created by the bootstrap task.

HTTPS is required to use MCP.

Use the standard MCP documentation for command behavior, inputs, and output. This page only links the commands.

Command Documentation
/cloudaeye:inspect Inspect
/cloudaeye:security Security
/cloudaeye:review Review
/cloudaeye:implement Implement
/cloudaeye:describe Describe
/cloudaeye:check-task Check Task
/cloudaeye:ask Ask
/cloudaeye:init Initialize a repository

For the general MCP workflow, see the MCP overview, Claude Code setup, usage guide, tool reference, and custom context.