Skip to content

docs: simplify MCP configuration with shared Dosu UUID#629

Merged
castrojo merged 1 commit intoprojectbluefin:mainfrom
castrojo:docs/mcp-troubleshooting
Feb 13, 2026
Merged

docs: simplify MCP configuration with shared Dosu UUID#629
castrojo merged 1 commit intoprojectbluefin:mainfrom
castrojo:docs/mcp-troubleshooting

Conversation

@castrojo
Copy link
Contributor

Summary

  • Make Goose the default tab in all MCP configuration sections
  • Add shared Bluefin documentation deployment UUID for easier setup
  • Simplify Dosu configuration - no API key required for read-only access
  • Reorganize troubleshooting page structure for better flow

Changes

Configuration Simplification

  • Users can now copy-paste the shared Bluefin docs UUID: 018da525-51f8-75ec-befc-c36a5f27ce5c
  • No need to sign up for Dosu or generate API keys for basic usage
  • Removed complex 4-step credential setup process
  • Added clear note that shared UUID works for all Bluefin users

UX Improvements

  • Goose is now the default tab (most Bluefin users will use Goose)
  • OpenCode configuration moved to secondary tab position
  • Consistent tab ordering across all configuration sections

Content Reorganization

  • Moved MCP server descriptions to top of configuration section
  • Grouped related configuration steps together
  • Updated all code examples to use shared UUID

Testing

  • ✅ Validated with npm run prettier
  • ✅ Build succeeds with npm run build
  • ✅ Manually tested in dev server at http://localhost:3000/docs/troubleshooting
  • ✅ All tabs function correctly
  • ✅ Code blocks render properly in both Goose and OpenCode sections

Related

  • Addresses user feedback about complex MCP setup
  • Aligns with Ask Bluefin initiative
  • Improves onboarding experience for new users

- Make Goose the default tab in all MCP configuration sections
- Add shared Bluefin documentation deployment UUID (018da525-51f8-75ec-befc-c36a5f27ce5c)
- Remove complex API key setup - users can now copy-paste shared UUID
- No authentication required for read-only access to Bluefin docs
- Reorganize content structure for better flow
- Update all configuration examples to prioritize Goose over OpenCode

Assisted-by: Claude Sonnet 4.5 via OpenCode
@castrojo castrojo merged commit 5b5e514 into projectbluefin:main Feb 13, 2026
2 checks passed
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.

1 participant

Comments