Skip to content

Add Claude Plugin guide and rewrite MCP Server docs#70

Merged
doriwilson merged 3 commits intomainfrom
adding-mcp-docs
Feb 25, 2026
Merged

Add Claude Plugin guide and rewrite MCP Server docs#70
doriwilson merged 3 commits intomainfrom
adding-mcp-docs

Conversation

@doriwilson
Copy link
Copy Markdown
Contributor

Summary

  • New page: Claude Plugin getting started guide (docs/2-getting-started/claude-plugin.md) — installation, slash commands, example workflows, FAQ, and troubleshooting
  • Rewritten page: MCP Server docs (docs/5-data-diffing/mcp-server.md) — added prerequisites, multi-client tabbed config (Claude Code, Cursor, Windsurf, Generic), available tools table, use cases, FAQ, troubleshooting, and What's Next section
  • Site config: expanded site_description for AISEO, updated changelog link to reccehq.com/changelog/, added Changelog to top nav, added descriptive nav labels

Key improvements

  • AISEO: Both pages now have description front matter, keyword-rich H1s, FAQ sections, and explicit entity associations (dbt, MCP, Claude Code, Cursor, Windsurf, Snowflake, BigQuery, etc.)
  • Multi-client support: MCP server page covers 5 clients in tabs instead of only Claude Code
  • Plugin-first routing: Claude Code users are directed to the plugin (easiest path) before manual MCP setup
  • No dead ends: Both pages have What's Next sections with cross-links

Still needed (separate ticket)

Screenshots are pending real dbt workflow captures — tracked in GTM-535. Pages have <!-- TODO --> placeholders for 4 required images.

Test plan

  • mkdocs serve — both pages render correctly
  • Tabbed config sections render properly (requires pymdownx.tabbed)
  • Changelog link in top nav points to reccehq.com/changelog/
  • All internal cross-links resolve (plugin ↔ MCP server, What's Next links)
  • FAQ sections display correctly
  • Tip/warning admonitions render properly

🤖 Generated with Claude Code

- Add new Claude Plugin getting started guide with installation,
  commands, example workflows, FAQ, and troubleshooting
- Rewrite MCP Server page with prerequisites, multi-client tabbed
  config (Claude Code, Cursor, Windsurf, Generic), available tools,
  FAQ, and troubleshooting
- Expand site_description for SEO/AISEO with AI agent keywords
- Update changelog link to reccehq.com/changelog
- Add Changelog to top nav header
- Add descriptive nav labels for plugin and MCP pages

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@doriwilson doriwilson requested a review from ijac13 February 23, 2026 20:11
Comment thread docs/2-getting-started/claude-plugin.md Outdated
Comment thread docs/2-getting-started/claude-plugin.md Outdated
Remove duplicated example workflow, clarify [selector] → [model], replace
git checkout - with explicit branch name, and remove TODO placeholders.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Comment thread mkdocs.yml Outdated
Copy link
Copy Markdown
Contributor

@ijac13 ijac13 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I left 3 comments are minor issues.
I approve so you can publish it if you want and fix the issue later.
btw, I'm not able to verify the technical details and I assume you are right.

@doriwilson doriwilson self-assigned this Feb 25, 2026
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@doriwilson doriwilson merged commit 0240d21 into main Feb 25, 2026
@doriwilson doriwilson deleted the adding-mcp-docs branch February 25, 2026 20:19
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.

2 participants