Skip to content

docs(troubleshooting): update MCP config for Gemini and migrate images#630

Merged
castrojo merged 5 commits intoprojectbluefin:mainfrom
castrojo:docs/mcp-troubleshooting
Feb 13, 2026
Merged

docs(troubleshooting): update MCP config for Gemini and migrate images#630
castrojo merged 5 commits intoprojectbluefin:mainfrom
castrojo:docs/mcp-troubleshooting

Conversation

@castrojo
Copy link
Contributor

@castrojo castrojo commented Feb 13, 2026

Summary

  • Update Goose configuration to use Google Gemini 2.0 Flash
  • Add browser-based authentication instructions (no API key needed)
  • Migrate GitHub-hosted images to local static directory
  • Move Automated Troubleshooting section to bottom of document
  • Fix Configuration info box formatting

Changes

MCP Configuration Updates

  • Configure Goose with provider: google-gemini and gemini-2.0-flash-exp model
  • Add authentication note explaining browser-based OAuth (no API key configuration required)

Image Migration

  • Migrate two GitHub user-attachments images to static/img/troubleshooting/:
    • top-cpu-usage.png (was: 537d5f2c-0a84-460d-b936-ae699376a1d7)
    • troubleshooting-example.png (was: 0ca8873d-a0d4-4822-b4a9-6486588bdbbd)

Content Reorganization

  • Move "Automated Troubleshooting" section (linux-mcp-server examples) to bottom of document
  • Fix Configuration section info box to proper multi-line format

Validation

  • ✅ Validated with npm run prettier
  • ✅ Build succeeds with npm run build
  • ✅ Only modifies docs/troubleshooting.mdx and adds two images
  • ✅ Manually tested at http://localhost:3000/docs/troubleshooting
  • ✅ Single clean commit with all changes

- Download and host ask-bluefin-menu.png locally in static/img/troubleshooting/
- Update markdown to use local image path instead of GitHub user-attachments URL
- Fixes broken image display in Docusaurus rendered page

Assisted-by: Claude Sonnet 4.5 via OpenCode
@castrojo
Copy link
Contributor Author

Closing - contains unauthorized trivial formatting edits across multiple files. The substantive MCP configuration work was already merged in PR #629.

@castrojo castrojo closed this Feb 13, 2026
@castrojo castrojo reopened this Feb 13, 2026
- Update Goose configuration to use Google Gemini 2.0 Flash (gemini-2.0-flash-exp)
- Add browser-based authentication instructions for Gemini (no API key needed)
- Migrate GitHub-hosted images to local static directory:
  - top-cpu-usage.png
  - troubleshooting-example.png

Assisted-by: Claude Sonnet 4.5 via OpenCode
@castrojo castrojo force-pushed the docs/mcp-troubleshooting branch from 1311c08 to 026dd96 Compare February 13, 2026 17:02
@castrojo castrojo changed the title docs(troubleshooting): remove unnecessary recommendation section docs(troubleshooting): update MCP config for Gemini and migrate images Feb 13, 2026
…ize sections

- Update Goose configuration to use Google Gemini 2.0 Flash (gemini-2.0-flash-exp)
- Add browser-based authentication instructions (no API key needed)
- Migrate GitHub-hosted images to local static directory:
  - top-cpu-usage.png
  - troubleshooting-example.png
- Move Automated Troubleshooting section to bottom of document
- Fix Configuration info box formatting

Assisted-by: Claude Sonnet 4.5 via OpenCode
@castrojo castrojo force-pushed the docs/mcp-troubleshooting branch from 2686380 to 033b8fa Compare February 13, 2026 17:16
Removed installation instructions for dosu-mcp from troubleshooting guide.
@castrojo castrojo merged commit 4337138 into projectbluefin:main Feb 13, 2026
1 check 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