Skip to content

docs: fix install, sign-in and self-hosted steps found in review - #12

Merged
alamin-br merged 3 commits into
mainfrom
fix/readme-review-findings
Oct 15, 2026
Merged

alamin-br merged 3 commits into
mainfrom
fix/readme-review-findings

Conversation

@alamin-br

Copy link
Copy Markdown
Collaborator

README:

  • Quick start uses add-mcp -g -a <agent>. Without -g it writes config into the current folder (or aborts when its default list includes Claude Desktop); tested in an isolated home.
  • Codex and Copilot CLI use their own plugin marketplace add and install commands instead of npx plugins add, which only reaches agents whose CLI is on the PATH.
  • Add to Cursor, VS Code and Goose use the https install pages (cursor.com/install-mcp, vscode.dev/redirect, goose-docs.ai), since GitHub strips cursor:, vscode: and goose: links.
  • Self-hosted requirements: a version newer than 2.4.1, the OAuth flag, public and outbound HTTPS, and an exact /mcp proxy match so /mcp-authorize/ stays on the frontend.
  • Gemini self-hosted uses -s user; Copilot self-hosted says to uninstall the plugin first, as its server overrides a hand-added one.
  • Signing in lists where each agent starts it, and that changing workspace or tools needs a fresh sign-in, not a reconnect.
  • The two-servers fix keeps the working server (claude plugin disable or claude mcp remove).
  • Endpoint keys go to agents that support SSE; Codex and Goose don't.
  • The settings menu is My settings → MCP server, here and in SECURITY.md.

Checker: reads the server URL out of the https install links, reports app-scheme links, and also catches stale URLs in bold, tables and http://.

Several README commands installed nothing or the wrong thing, the app-scheme install links don't work on GitHub, and Baserow 2.4.1 and older have no /mcp.
@alamin-br alamin-br self-assigned this Oct 15, 2026
@alamin-br
alamin-br merged commit 745aadd into main Oct 15, 2026
1 check passed
@alamin-br
alamin-br deleted the fix/readme-review-findings branch October 15, 2026 20:12
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