Conversation
Unit 2 of the 2026-07-27 nav pivot: fold the developer-docs MCP page (developers.keboola.com/integrate/mcp) into its help peer at /ai/mcp-server, then the dev page gets deleted in a follow-up PR. The two pages were duplicates — help was UI-first, dev was the developer layer. Help deferred to dev via 3 external links; those are now closed by folding dev's unique content in: - New "Running the MCP Server Locally" — Docker (Snowflake + BigQuery) and uv/uvx, env vars, connecting a local client, local Cursor config - New "Programmatic Integration" — Claude Messages API connector, OpenAI Agents SDK, LangChain, Crew AI, build-your-own-client - New "MCP Server Capabilities" matrix - Expanded "Restricting Tool Access" with the full authorization spec: header examples, filter precedence, read-only tool table, worked examples - On-page dev signal (`:::note`) before the developer sections — the pivot's page-level "this part is for developers" instead of a nav flag - redirect_from /integrate/mcp/ (feeds the dev->help redirect contract) - Jekyll HTML callouts -> Starlight admonitions; help.keboola.com absolute links -> internal; kept help's UI walkthroughs (no duplicate remote setup) Fact-checked against devdocs source + keboola/mcp-server repo: merge itself was drift-free; fixed 3 inherited dev-docs bugs in the process — - OpenAI Agents SDK import (openai_agents_python -> agents) — would crash - env var KBC_API_URL -> KBC_STORAGE_API_URL (server's actual name) - dropped the stale hard "15 tools" count, pointed at the repo TOOLS.md Build clean (256 pages); audit 0 new broken links / 0 missing images; the 3 formerly-external deferrals are now in-page anchors. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Iamfle4ka
changed the title
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What & why
Unit 2 of the 2026-07-27 nav pivot (unit 1 = Extending Keboola, #1046). Jordan's model per unit: merge the dev page into its help peer, then delete the dev page — MCP was his worked example ("we can't have two pages called MCP Server; combine it and remove it from developers").
The dev page (
developers.keboola.com/integrate/mcp) and the help page (/ai/mcp-server) were duplicates: help = UI-first, dev = the developer layer. The help page deferred to dev via 3 external links — this PR closes them by folding dev's unique content in. Self-contained offmain, independent of the #1027 stack.Folded in (net-new to help)
:::notedev signal before the developer sections (the pivot's page-level "this part is for developers", not a nav flag)redirect_from: /integrate/mcp/(feeds the PRDCT-565 dev→help redirect contract)Kept help's UI-friendly client walkthroughs; did not duplicate the overlapping remote-setup / mcp-remote / Cursor-deeplink sections.
Fact-check
Ran the fact-checker against the dev source + the
keboola/mcp-serverrepo. The merge itself was drift-free (no fact altered in reformatting). It surfaced 3 bugs inherited from the dev docs, fixed here:ModuleNotFoundError)openai_agents_pythonagents/agents.mcpKBC_API_URLKBC_STORAGE_API_URL(server's actual name)TOOLS.mdThese are worth an upstream fix in keboola/developers-docs too (pre-existing there).
Owner-verify (Jordan, as offered on the 07-27 call) — platform facts I couldn't confirm from public sources, carried verbatim from the dev docs:
GOOGLE_APPLICATION_CREDENTIALShandling against the current image01.04.2026(pre-existing help content)Verification
npm run buildclean — 256 pages.node scripts/audit-phase2.mjs: 0 missing images, 0 new broken internal links; the 3 formerly-externaldevelopers.keboola.com/integrate/mcpdeferrals are now in-page anchors.Follow-up
integrate/mcp.mdfrom keboola/developers-docs — opened after this is approved (domain-level 301 is phase 3).🤖 Generated with Claude Code