Aspect docs in your AI assistant

The Aspect documentation is served through a hosted Model Context Protocol (MCP) server. Connecting your AI coding assistant to it lets the assistant search and read the Aspect docs directly while it works in your repo. Use it for tasks like migrating YAML tasks to AXL, extending Gazelle in Starlark, upgrading Aspect Workflows, or wiring up the Aspect CLI in CI. This server serves documentation. To give an agent your build and test results, see Build results over MCP.

MCP server URLs

Endpoint	URL	For
Anonymous	`https://aspect.build/mcp`	Aspect Cloud customers and users of the Aspect CLI and rulesets
Authenticated	`https://aspect.build/authed/mcp`	Aspect Enterprise customers

The anonymous endpoint serves every public page: Aspect Cloud, the Aspect CLI, the open-source rulesets and the training courses. The authenticated endpoint adds the installation and configuration pages for Aspect Enterprise, so agents working on an Enterprise deployment can read them. It needs a one-time OAuth authorization with an Aspect account that has customer documentation access. Documentation search and retrieval are read-only; the server also exposes an optional tool for submitting documentation feedback.

Quick copy from any docs page

Every page on this site exposes a contextual menu (top of the page) with one-click options to:

Copy MCP Server: Copies the anonymous endpoint to your clipboard.
Connect to Cursor: Installs the anonymous endpoint in Cursor.
Connect to VS Code: Installs the anonymous endpoint in VS Code.

Connect from common clients

Claude Desktop

Anonymous
Authenticated

Open Settings → Connectors in Claude.
Click Add custom connector.
Set the name to Aspect Docs and the URL to https://aspect.build/mcp.
Click Add.
In a Claude chat, click the attachments (+) button and select Aspect Docs to give that thread access to the Aspect docs.

Open Settings → Connectors in Claude.
Click Add custom connector.
Set the name to Aspect Docs and the URL to https://aspect.build/authed/mcp.
Click Add.
Complete the OAuth authorization with your Aspect account.
In a Claude chat, click the attachments (+) button and select Aspect Docs to give that thread access to the Aspect docs.

Claude Code

Anonymous
Authenticated

claude mcp add --transport http aspect-docs https://aspect.build/mcp

claude mcp add --transport http aspect-docs https://aspect.build/authed/mcp
claude mcp login aspect-docs

Verify with:

claude mcp list

Codex CLI

Anonymous
Authenticated

Add the server to ~/.codex/config.toml:

[mcp_servers.aspect-docs]
url = "https://aspect.build/mcp"

Add the server to ~/.codex/config.toml:

[mcp_servers.aspect-docs]
url = "https://aspect.build/authed/mcp"

Authorize the server:

codex mcp login aspect-docs

Then start a Codex session and ask “What tools do you have available?” The aspect-docs server should be listed.

Cursor

Open the command palette with Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux).
Run Open MCP settings.
Click Add custom MCP and add the following to mcp.json:

Anonymous
Authenticated

{
  "mcpServers": {
    "aspect-docs": {
      "url": "https://aspect.build/mcp"
    }
  }
}

{
  "mcpServers": {
    "aspect-docs": {
      "url": "https://aspect.build/authed/mcp"
    }
  }
}

Cursor prompts for the OAuth authorization the first time it connects.

VS Code

Create .vscode/mcp.json in your workspace with:

Anonymous
Authenticated

{
  "servers": {
    "aspect-docs": {
      "type": "http",
      "url": "https://aspect.build/mcp"
    }
  }
}

{
  "servers": {
    "aspect-docs": {
      "type": "http",
      "url": "https://aspect.build/authed/mcp"
    }
  }
}

VS Code prompts for the OAuth authorization the first time it connects.

See the VS Code MCP documentation for details on scope and permissions.

What the assistant can do with it

Once connected, the assistant can:

Search the Aspect docs across the CLI, Aspect Workflows, AXL reference, and Bazel guides.
Fetch full pages as Markdown when it needs the complete instructions (for example, an upgrade guide or a migration walk-through).
Cite the page it used, so you can jump to the source directly.

The migration docs recommend pointing an AI coding assistant at them for the bulk of a YAML-to-AXL conversion.

Troubleshooting

The tool doesn’t appear after adding it. Restart the AI client after editing mcp.json / config.toml. Most clients only load MCP servers at startup.
The client can search public docs but can’t find Aspect Enterprise docs. Check that it uses https://aspect.build/authed/mcp, then complete the client’s OAuth login. The /mcp endpoint is anonymous and public-only.
The client reports 401, 405, or “method not allowed” when opening the URL in a browser. That’s expected: the MCP endpoints respond to MCP protocol requests, not plain GET requests. Configure the URL in your MCP client instead of visiting it directly.

​MCP server URLs

​Quick copy from any docs page

​Connect from common clients

​Claude Desktop

​Claude Code

​Codex CLI

​Cursor

​VS Code

​What the assistant can do with it

​Troubleshooting