Skip to content

docs: recommend a custom connector for Cowork, revert MCP URL hardcode #6

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
isabelle-cedar merged 1 commit into from
Jul 14, 2026
Merged

docs: recommend a custom connector for Cowork, revert MCP URL hardcode #6

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 21 additions & 10 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,23 +1,34 @@
# Cedar Claude Plugin

Connects [Cedar](https://cedarcopilot.com) to Claude Code and Claude Cowork: Cedar's
tools via MCP, and conversation capture (via hooks) so what you do with Cedar through
Claude shows up in your Cedar chat history.
Connects [Cedar](https://cedarcopilot.com) to Claude Code: Cedar's tools via MCP, and
conversation capture (via hooks) so what you do with Cedar through Claude shows up in
your Cedar chat history.

## Install

**Claude Cowork**: open the Marketplace section, search for "cedar", click Install. The
exact flow for adding a marketplace that isn't yet in Anthropic's own directory (as
opposed to installing from one already listed) hasn't been verified end-to-end here yet
— confirm the discovery/add step works before assuming parity with the Claude Code path
below.

**Claude Code**:
**Claude Code** (full plugin — tools + conversation capture):
```
/plugin marketplace add CedarCopilot/cedar-plugin
/plugin install cedar@cedar-marketplace
```

**Claude Cowork** (tools only, no conversation capture — see below):
Cowork's plugin-marketplace sync currently rejects this plugin outright. Its
`hooks/hooks.json` uses the `mcp_tool` hook type (the only mechanism that lets a hook
call an MCP tool directly — required for conversation capture), but Cowork's
server-side marketplace-sync validator only accepts `command`/`prompt`/`agent` hook
types. This is a confirmed, deliberate Anthropic-side restriction, not a bug in this
repo — see [anthropics/claude-code#35653](https://github.com/anthropics/claude-code/issues/35653)
(closed `NOT_PLANNED`) for the identical restriction on HTTP hooks. Verified live via
`~/Library/Logs/Claude/claude.ai-web.log`'s `MARKETPLACE_ERROR:REMOTE_SYNC_FAILED`
payload, and by testing a hooks-free build of this exact repo (synced successfully with
hooks removed, failed identically with them present).

Until Anthropic lifts this restriction, add Cedar as a **custom connector** in Cowork
instead of installing this plugin: **Customize → Connectors → Add custom connector**,
URL `https://api.mail.cedarcopilot.com/mcp`. This gets you the same MCP tools with no
plugin involved — but no conversation capture, since that's entirely hook-driven.

## Testing (Claude Code — most controllable path, verified working)

After installing (above), this kicks off Cedar's OAuth consent flow the first time it
Expand Down
2 changes: 1 addition & 1 deletion cedar-plugin/.mcp.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"mcpServers": {
"cedar-mcp": {
"type": "http",
"url": "https://api.mail.cedarcopilot.com/mcp"
"url": "${CEDAR_MCP_URL:-https://api.mail.cedarcopilot.com/mcp}"
}
}
}
Loading