docs(mcp): retire the dev MCP page, redirect to help (PRDCT-580) - #405
Merged
Conversation
The dev /integrate/mcp/ page was merged into help.keboola.com/ai/mcp-server/ in keboola/connection-docs#1050. Everything it covered — MCP clients, the Claude Messages API connector, OpenAI Agents SDK / LangChain / CrewAI, building your own client, tool-authorization headers, local Docker/uv execution and the remote (OAuth) setup — now lives on the help page, in most cases in a fresher form (correct `anthropic-beta` header, the official `langchain-mcp-adapters` package, fixed Agents SDK imports). Leaving the dev page up means two competing MCP overviews, so it becomes a `redirect_to` stub: the URL stays alive for the one inbound reference in the org and for bookmarks, but the duplicate content is gone. The only dev-only section, the "MCP Server Capabilities" support matrix, is intentionally dropped rather than ported. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Collaborator
Author
|
Sibling of #406 — same pattern ( Note this one is not an identical-path move: |
jordanrburger
approved these changes
Aug 5, 2026
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
2 participants
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.
Jira issue(s): PRDCT-580 — companion delete-from-dev PR for connection-docs#1050 (merged 2026-08-03).
The dev MCP page was merged into
help.keboola.com/ai/mcp-server/. Leaving it up means two competing MCP overviews, which is exactly what the migration is supposed to remove — so the page becomes a redirect stub instead of a duplicate.Changes:
integrate/mcp.md→ front-matter-onlyredirect_to: https://help.keboola.com/ai/mcp-server/stub (jekyll-redirect-from, already enabled in_config.yml). The URL stays alive for bookmarks and for the one inbound reference in thekeboolaorg; the duplicate content is gone.MCP Integrationentry from_data/navigation.yml.index.md,overview/index.md) straight at help, so they don't bounce through the stub.Coverage check before stubbing: everything the dev page documented is on the help page, in most cases fresher — MCP clients, the Claude Messages API connector (help has the current
anthropic-beta: mcp-client-2025-11-20header), OpenAI Agents SDK (help has the correctagentsimports), LangChain (help uses the officiallangchain-mcp-adapters; the dev copy still says no connector exists), CrewAI, building your own client, tool-authorization headers, local Docker/uvexecution, remote OAuth setup and themcp-remotefallback.The only dev-only section is the MCP Server Capabilities support matrix (Transports/Prompts/Tools/Resources/Sampling/Roots). It is intentionally dropped, not ported — per the review note on #1050.
Not in this PR: real 301s for
developers.keboola.com.redirect_toemits a meta-refresh page (HTTP 200 + canonical); a 301 needs an S3 routing-rule / CloudFront change outside this repo.