May 11, 2026

Claude Code

Setup guide added for connecting Claude Code to the Catio MCP server. Covers adding the server via the claude mcp add command, completing the OAuth flow through /mcp, and verifying the connection. Also documents how to re-authenticate or switch workspaces.

See Claude Code.

OpenCode

Setup guide added for OpenCode. Covers adding the Catio server to the OpenCode config file, completing the browser OAuth flow on first tool use, and verifying the session.

See OpenCode.

Cursor

Setup guide added for Cursor. Covers editing ~/.cursor/mcp.json, completing the OAuth flow on first tool use, and verifying the connection from Cursor Composer.

See Cursor.

VSCode

Setup guide added for VSCode with GitHub Copilot (VSCode 1.99+). Covers both workspace-level (.vscode/mcp.json) and user-level configuration, OAuth authentication on first tool use, and verifying from the Chat view.

See VSCode.

Windsurf

Setup guide added for Windsurf by Codeium. Covers editing mcp_config.json, completing the OAuth flow on first tool use, and verifying from the Cascade panel.

See Windsurf.

Zed

Setup guide added for Zed. Covers adding the server under context_servers in Zed settings, completing the OAuth flow, and verifying from the Agent Panel.

See Zed.

Claude Desktop

Setup guide added for Claude Desktop. Covers editing claude_desktop_config.json on macOS and Windows, completing the OAuth flow on first tool use, and verifying from a conversation.

See Claude Desktop.

Other MCPs

Reference page added for any MCP client that supports the Streamable HTTP transport and OAuth 2.0. Lists the server URL, transport, and authentication method so users can configure clients outside the supported list.

See Other MCPs.

Prompting Best Practices

New section added covering how to get the most out of Catio through your MCP client. Includes guidance organized by use case:

Architecture Inventory Prompts for exploring components, filtering by category or tag, inspecting details, and tracing relationships.
Requirements Prompts for loading workspace context, searching by topic, and looking up specific requirements.
Recommendations Prompts for finding, prioritizing, and reviewing recommendations and their implementation plans.
Archie Prompts for asking architecture, compliance, and recommendation questions through the AI assistant.
Best Practices covering useful prompt combinations for common tasks like compliance checks, prioritization, dependency mapping, and design review prep.

See Best Practices.

Workspace Scoping

New page added explaining how MCP connections are scoped to a single workspace at login time. Covers connecting to multiple workspaces by adding Catio as separate named servers, switching workspaces by clearing authentication, and example configurations for Claude Code and Cursor.

See Workspace Scoping.

Changelog

MCP Release Log

April Product Release