Clarion for VS Code

Connect Clarion to VS Code agent mode in one click — no mcp.json editing.

Once connected, your coding agent (GitHub Copilot agent mode and other MCP‑aware surfaces) can reach Clarion's MCP server: your decisions, customers, opportunities, specs, goals, personas, and roadmap — so it builds the right thing with full product context, and can log decisions back.

Features

One‑click connect. Clarion: Sign In runs a secure browser OAuth flow (PKCE) and registers Clarion's hosted MCP server with VS Code automatically.
No manual config. The MCP server appears in agent mode without touching mcp.json. Tokens are stored in VS Code's encrypted Secret Storage and refreshed automatically.
Works elsewhere too. Clarion: Copy MCP Config copies a ready‑to‑paste snippet for agents that use their own config (Cursor, Windsurf, …).

Getting started

Install the extension.
Run Clarion: Sign In from the Command Palette (⇧⌘P / Ctrl+Shift+P).
Approve access in the browser. That's it — open Copilot agent mode and the Clarion MCP tools are available.

Commands

Command	What it does
`Clarion: Sign In`	Browser OAuth (PKCE) → connects the MCP server
`Clarion: Sign Out`	Revokes the token and removes the server
`Clarion: Show Connection Status`	Shows the connected instance + token expiry
`Clarion: Copy MCP Config (for other agents)`	Copies an `mcp.json` snippet

Settings

Setting	Default	Description
`clarion.baseUrl`	`https://getclarion.in`	Advanced — Clarion is a hosted service; leave this at the default.

Requirements

VS Code 1.101+ (finalized MCP server definition provider API).
A Clarion account. The extension uses Clarion's OAuth 2.0 (PKCE) + MCP endpoints.

How it works

The extension implements the same OAuth flow as @clarion/cli: it discovers Clarion's OAuth metadata at /.well-known/oauth-authorization-server, dynamically registers a public client (loopback redirect), runs the PKCE authorization‑code flow, and stores the resulting token in Secret Storage. It then contributes an McpHttpServerDefinition pointing at <baseUrl>/api/mcp with a fresh Bearer token attached at connection time.

Privacy

The extension stores only your OAuth tokens (encrypted, on your machine) and the public OAuth client id. It talks only to Clarion (getclarion.in).

Publishing: the Marketplace publisher is clarion, so the listing id is clarion.clarion-vscode-extension. The icon (media/icon.png, 128×128) is in place. See the project plan's G7 note for the exact vsce steps.