Skip to content

Conversation

@miqcie
Copy link

@miqcie miqcie commented Nov 17, 2025

Summary

Adds comprehensive Claude Code CLI setup documentation to address the gap identified in #137.

Changes

  • Hosted option: Documents the claude mcp add command for OAuth-based remote server
  • Self-hosted option: Provides .mcp.json and settings.json configuration for stdio transport
  • Security guidance: Lists credential management best practices (env vars, Keychain, 1Password, cloud secret managers)

Context

Currently, the README documents setup for Claude Desktop, Cursor, and Zed, but not Claude Code CLI. The Claude Code MCP documentation only covers the hosted HTTP transport option. This PR fills the gap by documenting both approaches for Claude Code CLI users.

This addresses the request in #137 for Claude Code integration.

Developer Experience

The documentation follows progressive disclosure:

  1. Shows both hosted (simple) and self-hosted (control) options upfront
  2. Provides copy-paste ready configurations
  3. Includes security best practices without overwhelming detail

Closes #137

- Add hosted (HTTP) and self-hosted (stdio) configuration options
- Include .mcp.json and settings.json setup steps
- Add security best practices for credential management
- Addresses issue makenotion#137

Provides clear setup path for Claude Code CLI users who want to
use either the remote Notion MCP or self-host the open-source server.
@miqcie miqcie marked this pull request as draft November 17, 2025 16:15
Use list format to clearly present multiple documentation resources
@miqcie miqcie marked this pull request as ready for review November 17, 2025 16:33
@miqcie miqcie marked this pull request as draft November 17, 2025 16:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add Claude Code Plugin / Marketplace

1 participant