Candor UI MCP server
2026년 11월 14일 커밋shadcn/ui를 사용하여 정직한 에이전트 사용자 인터페이스를 구축하기 위한 문서와 컴포넌트 제안을 제공합니다.
다른 이름 MethodicDev/candor, candor
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 6.1.3
- 마지막 커밋
- 2026년 11월 14일
- 라이선스
- MIT
Candor UI MCP란?
Candor UI은(는) MCP server입니다. shadcn/ui를 사용하여 정직한 에이전트 사용자 인터페이스를 구축하기 위한 문서와 컴포넌트 제안을 제공합니다.
프로젝트 README에서 생성된 요약
Candor UI MCP server 정보
Candor UI는 AI 에이전트를 위한 정직한 사용자 인터페이스를 구축하도록 설계된 특화된 인터페이스 컴포넌트 세트와 문서를 제공합니다. shadcn/ui를 사용하는 개발자를 위해 구축되었으며 채팅 스레드, 도구 호출, 추론 디스플레이, 권한 프롬프트와 같은 컴포넌트를 제공합니다. 이러한 요소들은 허용(allow) 및 거부(deny)와 같은 결정 버튼이 어느 쪽도 미리 선택되지 않은 상태로 시작하도록 보장하고, 알 수 없는 데이터를 0이 아닌 측정되지 않음(not measured)으로 표시하는 등 특정 정직성 규칙을 따르도록 설계되었습니다.
개발자는 candor-ui CLI를 사용하거나 npm에서 @candor-ui/react 패키지를 설치하여 이러한 도구를 프로젝트에 통합할 수 있습니다. 이 server는 API key나 유료 계정 없이도 문서와 컴포넌트 제안을 제공하는 읽기 전용 MCP 도구로 작동합니다. 다양한 프레임워크와 호환되며 Vercel AI SDK, Claude Agent SDK, AG-UI용 어댑터를 포함합니다. 또한 UI가 확립된 정직성 원칙을 준수하는지 린팅, 감사 및 검증하기 위한 CLI 도구 모음도 제공합니다.
활용 사례
- 1정직한 UI 컴포넌트 제안AI 에이전트가 정직성 규칙을 준수하면서 특정 작업에 적합한 컴포넌트를 찾는 데 이 server를 사용할 수 있습니다.
- 2인터페이스 정직성 감사개발자가 명령어를 실행하여 현재 실행 중인 애플리케이션이 요구되는 디자인 원칙을 따르는지 확인할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Candor UI MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Candor UI MCP 설치
$ claude mcp add --transport http candor https://candor.themethodic.com/mcpCursor에 Candor UI MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"candor": {
"url": "https://candor.themethodic.com/mcp"
}
}
}VS Code에 Candor UI MCP 설치
.vscode/mcp.json
{
"servers": {
"candor": {
"type": "http",
"url": "https://candor.themethodic.com/mcp"
}
}
}VS Code CLI에 Candor UI MCP 설치
$ code --add-mcp '{"name":"candor","type":"http","url":"https://candor.themethodic.com/mcp"}'Codex에 Candor UI MCP 설치
$ codex mcp add candor --url https://candor.themethodic.com/mcpCodex config.toml에 Candor UI MCP 설치
~/.codex/config.toml
[mcp_servers.candor] url = "https://candor.themethodic.com/mcp"
Gemini CLI에 Candor UI MCP 설치
$ gemini mcp add -s user --transport http candor https://candor.themethodic.com/mcpGemini settings.json에 Candor UI MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"candor": {
"url": "https://candor.themethodic.com/mcp",
"type": "http"
}
}
}자동 검사
2026년 11월 15일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능methodicdev/candor is public and reachablegithub.com/methodicdev/candor ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-14github.com/methodicdev/candor ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답initialize answered with protocol 2025-06-18 in 124 ms통과
README
GitHub에서 보기Candor UI: the free tier
Honest agent UI for shadcn/ui: chat, tool calls and permission prompts that never overstate what an agent did. MIT.

Try the app demo · Honest against typical, side by side · Docs · Changelog
Interface components for agent apps: a thread, messages, a composer, tool calls, reasoning and citations, the
building blocks under them, a light, dark and high-contrast theme, and adapters for the Vercel AI SDK, the Claude
Agent SDK and AG-UI. For shadcn/ui projects, installed with the candor-ui CLI or shadcn's own, MIT licensed.
This repo is the source of Candor UI's 73 free items (version 4.0.2), the skill and plugins for coding agents and 3 starter apps. Docs and live examples: https://candor.themethodic.com.
The same free items are on npm as @candor-ui/react, for people who
would rather npm install than copy code in. That package changes only when a free item changes, so its version can be
behind the kit's after a release that changed only Pro items; the CLI, candor-ui, has a version of its own. The
changelog says which release changed what.
Try it in a minute, no key
npx degit MethodicDev/candor/starter-vite-ag-ui my-app
cd my-app
npm install
npm run dev
Open the address it prints. A scripted agent answers in the page: fixed replies, no model, no server and no API key,
and the page says so. Ask it to add "Try a Candor block" to your list and you'll see a line of its reasoning, a tool
call marked "Needs you", and a permission prompt that shows what it will run, with Deny and Allow and neither
chosen for you. That is what the image above shows. Point VITE_AGENT_URL at an AG-UI agent (LangGraph, CrewAI…)
when you want a real one.
Why Candor
An agent that acts on real systems can mislead without saying anything false: a spinner nobody has heard from, a total that treats a missing cost as zero, an approval that now applies to a different change. Candor's components keep these 9 rules. Where Honest against typical has a moment that shows one, the link goes to its Typical and Honest switch; the others go to Principles.
- Model output is text, never markup: Adapters read what a model writes as a small safe subset of markdown; a link becomes plain text with its address beside it.
- Unknown stays unknown: A cost or duration the service didn't report reads “not measured”, not zero, and an estimate says it is one.
- A control that can't be used says why: A control that can't be used carries its reason, on hover and focus and to screen readers.
- Nothing is pre-selected in a decision: Approve and reject, allow and deny start with neither chosen.
- Approve the exact change: A decision is tied to a hash of the change that was asked about; a change that moved since is refused.
- Reasoning is believed, not verified: Reasoning is shown as the model's own account and marked as unchecked; evidence is shown as evidence.
- The agent is always named, by the app: Every agent message names its agent from the app's data, never from model output.
- Say what can and can't be undone: Destructive actions say what they remove and whether it can be brought back.
- Motion follows the outcome: A success mark is drawn after the result settles; motion reports a change and never predicts one.
Install
npx candor-ui@latest init
npx candor-ui add thread message composer
candor-ui init adds the @candor registry to components.json and the theme to your CSS; in a project without
shadcn yet it runs shadcn's setup first (--yes sets it up with Base UI and shadcn's nova preset, no questions). Or add the registry by
hand: "@candor": "https://candor.themethodic.com/r/{name}.json". If shadcn asks to overwrite a primitive such as
ui/button.tsx, answer yes: Candor's button styles locked actions; without a terminal, pass --overwrite.
Or from npm
npm install @candor-ui/react
import { Thread, Message, Composer } from "@candor-ui/react"
Then @import "@candor-ui/react/styles.css" after Tailwind. The package holds the free tier only, and its version can be
behind the kit's; its README has the adapters and the entry points.
Tools
candor-ui also checks what you build, from the CLI's own docs:
lintchecks your.tsx,.ts,.jsxand.jsfiles against Candor's honesty rules and printspath:line:col rule messagefor each finding; it exits 1 on an error.auditislintplus a look at a running page:npx candor-ui audit http://localhost:3000runs axe and the honesty rules on it and writesAUDIT.md.updatemoves installed items to the latest version and keeps your changes: a file you edited gets a three-way merge, and where you and we changed the same lines it writes conflict markers.verifyis for CI: it checkscandor-lock.jsonagainst the registry's versioned snapshots and the files on disk.theme checkchecks your theme's colour contrast and its motion and sound values, and changes nothing.
candor-ui doctor explains an install that looks wrong. Every command is in the
CLI's README.
For coding agents
llms-install.md tells an agent how to set Candor up in a project by itself: the CLI, the docs MCP server, the skill
and the honesty rules to keep. The skill alone:
npx skills add MethodicDev/candor
installs two skills: skills/candor-ui (which component fits which job, the adapters, and the rules the components
keep, with a design-system reference read from the shipped CSS) and skills/candor-agent-ui (design fundamentals for
screens where an AI agent acts, with a review checklist to run after each screen; it works with or without Candor).
The plugins install the skill and the docs MCP server together. Claude Code: claude plugin marketplace add MethodicDev/candor, then claude plugin install candor-ui@candor (or, in a session,
/plugin install candor-ui --marketplace MethodicDev/candor). GitHub Copilot CLI: copilot plugin marketplace add MethodicDev/candor, then copilot plugin install candor-ui@candor. VS Code installs candor-ui from this repo's URL;
Cursor reads .cursor-plugin/marketplace.json; the Codex package is plugins/codex/candor-ui.
The MCP server at https://candor.themethodic.com/mcp serves docs and component suggestions only: read-only, no key,
never paid source. .mcp/server.json describes it for the MCP registry. Agents can also read
https://candor.themethodic.com/llms.txt.
Starters
Starter apps with a working agent chat built from these components (3 of them). Each installs and builds on its own:
| Folder | Stack | Agent |
|---|---|---|
starter-vite-ag-ui/ |
Vite and React, no server | a scripted one in the page (no key; see above), or any AG-UI agent (LangGraph, CrewAI…) |
starter/ |
Next.js 16 | Vercel AI SDK at /, Claude Agent SDK at /claude (needs an Anthropic API key) |
starter-tanstack-start-claude/ |
TanStack Start | Claude Agent SDK (needs an Anthropic API key) |
npx degit MethodicDev/candor/starter-vite-ag-ui my-agent-app
npx degit MethodicDev/candor/starter my-agent-app
npx degit MethodicDev/candor/starter-tanstack-start-claude my-agent-app
What's here
73 free items, each with a docs page that has its props and live examples. Install any of them by name:
npx candor-ui add <name>.
| Area | What it's for | Items |
|---|---|---|
| Chat (20) | A conversation with an agent: messages, the composer, tool calls, reasoning, citations. | agent-avatar, ai-disclosure, attachment-preview, card-registry, citation, composer, context-meter, entity-chip, folded-turns, message-actions, message-content, message, payload, permission-prompt, prompt-suggestions, reasoning, thread-divider, thread-event, thread, tool-call |
| Adapters (7) | Map an agent SDK's messages onto Candor's data: the Vercel AI SDK, the Claude Agent SDK and AG-UI. | ag-ui, ai-sdk, claude-agent-sdk, claude-agent-server, use-ag-ui, use-candor-chat, use-claude-agent |
| Building blocks (7) | Small pieces every screen uses: locked controls, status dots, step lists, relative times. | copy-field, degraded-panel, relative-time, status-dot, step-list, streaming-text, surface |
| App shell (2) | The app around the agent: layout, sidebar, command menu, sessions, notices. | page-header, page-state |
| Primitives (13) | The shadcn/ui primitives Candor's components are built on. | accordion, alert, button, checkbox, collapsible, label, locked, popover, progress, skeleton, slider, switch, tooltip |
| Themes (6) | The default theme and 5 gallery themes: colours, type, radius and motion as CSS variables, in light, dark and high contrast. | tokens, theme, theme-slate, theme-paper, theme-console, theme-signal |
Shared types and helpers (15): Types and pure functions the components share.
chat, fill-strings, format-elapsed, highlight, know, layer, locale, mcp-input, motion, safe-markdown, sound, status, use-copy, use-shortcut, use-virtual-list
Fonts (3): Self-hosted, and optional: without one the theme uses the system font.
font-inter, font-source-sans, font-ibm-plex
Pro, Premium and Team
One-time prices, no subscription. A licence includes every version Candor UI publishes, major ones included. You can ask for a full refund within 30 days of buying. The free tier here is MIT.
| Tier | Price | What's in it | Support |
|---|---|---|---|
| Free (this repo) | $0, MIT | 73 items: the chat core, building blocks, themes, adapters; 3 starters; the skill and plugins | public issues here |
| Pro | $149, one person | All 293 items, the free ones included: the app shell, plans, approvals, diffs, runs, evals and admin | none; the docs and examples |
| Premium | $249, one person | Pro, plus 11 full-stack blocks and 4 templates, each for the Vercel AI SDK and the Claude Agent SDK | email, best effort |
| Team | $999, up to 10 people in one company | Premium | email, a first reply within 2 business days |
Buy at https://candor.themethodic.com/#pricing. The terms are the Candor UI Commercial Licence; SUPPORT.md repeats the support each tier includes. Your key arrives in Polar's receipt email and customer portal; https://candor.themethodic.com/licence-key says where, and what a refund does to it. Then, in your project:
npx candor-ui key <your licence key> # saves it to .env.local, checks it, and has the registry send it
npx candor-ui add approval-request # a Pro item, installed like any other
In CI, set CANDOR_LICENSE_KEY as a secret, so installs and npx candor-ui verify can read paid items. Installed code
needs no key to run; the key is only for installing and updating. Never put a key in an issue, a pull request or a
repository.
How this repository works
- The source of truth is private. Candor UI's main repository holds the free items and the paid tiers together. This repository is generated from it on each release, so a change made here by hand would be overwritten.
- From 2.6.2, each release is a commit, a tag and a GitHub Release. The commit
Candor X.Y.Z, the tagvX.Y.Zand the release all carry that version's changelog section. - Issues are read. Use the forms. There is no promised reply time for the free tier; the support each paid tier includes is in SUPPORT.md. A vulnerability goes to SECURITY.md, not to an issue.
- A pull request isn't merged here. If it is accepted, it is applied upstream by hand, credited in that release's changelog entry, and closed with a link to the release that holds it. CONTRIBUTING.md has the rest.
- Every release is reviewed over its full diff by a separate review session that had no part in writing it, before the owner approves the merge. Most of the code is written with AI coding assistants, and the commits here say so in a Co-Authored-By line.
Licence
MIT, © Methodic LLC. See LICENSE. It covers this repository's free items; Candor UI's paid items are under the
Candor UI Commercial Licence.
Candor UI MCP 질문
Candor UI MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --transport http candor https://candor.themethodic.com/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Candor UI MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Candor UI MCP server는 무엇을 제공하나요?
Candor UI 라이브러리에 대한 문서와 컴포넌트 제안을 제공하는 MCP server입니다.
기존 shadcn/ui 프로젝트에서 Candor UI를 사용할 수 있나요?
네, candor-ui CLI를 사용하여 shadcn/ui 프로젝트에 Candor UI 컴포넌트를 설치할 수 있습니다.