docs(mcp): update project selection and storage-token deprecation - #1059
docs(mcp): update project selection and storage-token deprecation#1059Matovidlo wants to merge 1 commit into
Conversation
OAuth login now defers project selection to in-conversation get_accessible_projects/set_project_scope tool calls instead of picking a single project at the consent screen (server now requests the projectless OAuth scope). Updates the per-client setup steps accordingly, and cross-links the developers-docs deprecation notice for static KBC_STORAGE_TOKEN setups.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
|
@claude review |
There was a problem hiding this comment.
Pull request overview
Updates the Keboola MCP Server documentation to reflect the new multi-project OAuth flow (projectless auth + in-chat project scoping) and to warn about the upcoming deprecation of static Storage API token auth for local/CLI setups.
Changes:
- Added a centralized “Choosing Your Project(s)” section describing post-auth project selection/scoping.
- Updated multiple client setup sections to reference selecting project(s) after authentication and link to the new section.
- Added a deprecation callout for
KBC_STORAGE_TOKEN-based local/CLI authentication with a link to the developer docs.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
|
|
||
| ### Choosing Your Project(s) | ||
|
|
||
| Authenticating no longer pins your session to a single project up front. Once you're connected, ask your assistant something like *"what Keboola projects can you access?"* — it will list every project reachable by your account and ask which one(s) you want to work in. You can work across several projects at once, or re-scope to a different project or subset at any point later in the conversation. |
| For CLI control, dev environments, or contributing to the MCP Server, check out the [MCP GitHub repo](https://github.com/keboola/mcp-server). | ||
|
|
||
| :::caution | ||
| **Storage Token Deprecation:** Local/CLI setups that authenticate with a static Storage API token (`KBC_STORAGE_TOKEN`) should migrate to the browser-based `login` command — static-token support will be removed in a future release. See the [Developer Documentation](https://developers.keboola.com/integrate/mcp/#authenticating-without-a-static-storage-token-browser-login) for details. |
keboola-pr-reviewer-bot
left a comment
keboola-pr-reviewer-bot
left a comment
There was a problem hiding this comment.
Verdict: needs_human (risk 2/5) · profile docs
Needs human: the PR adds new product-behaviour claims and an unverifiable cross-repo Keboola link, both of which policy bars from auto-approval.
Concerns:
src/content/docs/ai/mcp-server/index.md: New 'Choosing Your Project(s)' section asserts unverified product behaviour (projectless OAuth scope, multi-project scoping).src/content/docs/ai/mcp-server/index.md: New cross-repo link to developers.keboola.com deprecation anchor unverifiable; companion PR #404 unmerged.src/content/docs/ai/mcp-server/index.md: Storage-token removal 'in a future release' is a roadmap claim needing product-team confirmation.
Suggested reviewers: @keboola/docs
|
Closing — this was based on the pre-consolidation duplicate page. The real target is #1050 (PRDCT-580), which folds developers-docs' MCP page into this one and is still open. Re-landing the project-selection and storage-token-deprecation fixes as a PR against the |
Jira issue(s): none (docs correction/addition following the MCP server's multi-project auth (PSGO-261) rollout)
Changes:
projectlessscope and no longer pins the session to one project at the consent screen — project selection happens afterward viaget_accessible_projects/set_project_scopetool calls in the conversation. Updated this across all six per-client setup sections (Claude Desktop, mcp-remote, ChatGPT stays as-is since it already only mentions "select the specific project", Cursor, Windsurf, VS Code).KBC_STORAGE_TOKENlocal/CLI setups, cross-linking the equivalent notice just added to developers.keboola.com.Companion PR on the developer docs: keboola/developers-docs#404