Claude Connector

Connect Claude to vibe.pub — publish markdown, manage pages and collections, and close the comment feedback loop.

vibe.pub is a remote MCP server that turns agent-generated markdown into shareable web pages. Connect once via OAuth, then ask Claude to publish reports, kanban boards, changelogs, and multi-page collections.

Server URL: https://vibe.pub/mcp
Transport: Streamable HTTP
Authentication: OAuth 2.0 with PKCE and Client ID Metadata Documents (CIMD)

Connect in Claude

Claude.ai / Claude Desktop

Open Settings → Connectors.
Add a custom connector with URL https://vibe.pub/mcp.
Click Authenticate when prompted.
Enter your email, open the magic link, and approve the requested scopes.

Claude Code

claude mcp add --transport http vibe-pub https://vibe.pub/mcp

Then run /mcp, select vibe.pub, and choose Authenticate. Claude opens the OAuth flow in your browser.

OAuth endpoints

Endpoint	URL
Authorization server metadata	`/.well-known/oauth-authorization-server`
Protected resource metadata	`/.well-known/oauth-protected-resource/mcp`
Authorize	`/oauth/authorize`
Token	`/oauth/token`

Scopes

Scope	Grants
`pages:read`	Read your pages, comments, and version history
`pages:write`	Publish, update, delete pages; add and resolve comments; manage page shares
`collections:read`	Read your collections and collection parts
`collections:write`	Create, update, delete collections; manage parts and collection shares
`offline_access`	Issue refresh tokens so Claude can reconnect without re-authorizing

Tools

All tools include a human-readable title and a readOnlyHint or destructiveHint annotation for Claude's tool picker.

Public (no OAuth required)

These tools work before authentication. Read tools enforce the same access rules as the web — private pages return 403 unless you are signed in with permission.

Tool	Hint	Description
`format`	read	Load doc or kanban markdown format spec before writing
`whoami`	read	Check authentication status and API base URL
`get_page`	read	Fetch a page by slug (respects access controls)
`get_collection`	read	Fetch collection metadata, parts, and pages
`get_comments`	read	List open comments on a page
`get_versions`	read	List version history for a page
`get_version`	read	Fetch a specific page version snapshot

Authenticated

Write tools and account-scoped reads require a valid OAuth access token.

Tool	Hint	Description
`publish`	write	Publish markdown to a new URL
`update_page`	write	Replace page content or change access level
`delete_page`	write	Permanently delete a page
`list_pages`	read	List pages you own or shared with you
`add_comment`	write	Add a block-anchored comment
`resolve_comments`	write	Resolve one, some, or all comments on a page
`create_collection`	write	Create a multi-page collection with optional parts
`update_collection`	write	Update collection title, description, or access
`add_to_collection`	write	Add an existing page to a collection
`list_collection_parts`	read	List sections within a collection
`create_collection_part`	write	Add a new section to a collection
`update_collection_part`	write	Rename or reorder a collection section
`delete_collection_part`	write	Remove a section (pages become ungrouped)
`remove_from_collection`	write	Remove a page from a collection
`list_collections`	read	List collections you own or shared with you
`delete_collection`	write	Delete a collection (pages are kept)
`access_page_status`	read	View access level and share list for a page
`access_page_share`	write	Share a private page with a user or domain
`access_page_unshare`	write	Revoke page share for a user or domain
`access_collection_status`	read	View access level and share list for a collection
`access_collection_share`	write	Share a private collection with a user or domain
`access_collection_unshare`	write	Revoke collection share for a user or domain

Recommended agent workflow

Call format with doc or kanban before drafting.
Generate markdown matching the format spec.
Call publish and return the URL to the user.
For revisions, use update_page. For feedback loops, use get_comments → edit → update_page → resolve_comments.

Templates

Pages auto-detect a view from markdown structure, or you can set view explicitly:

doc — long-form articles (default)
kanban — ## Column + ### Card boards
changelog — keepachangelog-style releases
timeline — roadmap sections and periods
slides — slide decks (view: slides in frontmatter)
dashboard — metrics panels (view: dashboard)

Local MCP (CLI)

For development or offline use, run the stdio MCP server bundled in the CLI. This is separate from the hosted connector and uses a personal API token instead of OAuth:

npx vibe-pub --mcp

Configure in Claude Desktop with command npx, args ["-y", "vibe-pub", "--mcp"], and env VIBE_PUB_TOKEN.

Allowed link origins

Published pages and tool responses link to:

https://vibe.pub

Privacy & support

Directory review checklist

For Anthropic connector reviewers testing end-to-end access:

Add connector URL https://vibe.pub/mcp in Claude admin settings.
Authenticate with the test account email provided in the submission portal.
Verify public reads: format (doc), whoami, and get_page on a public demo slug.
Verify writes: publish → update_page → delete_page.
Optional: create_collection → delete_collection.