docs(mcp): retire the dev MCP page, redirect to help (PRDCT-580) - #405
Merged
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
jordanrburger
enabled auto-merge
August 5, 2026 16:20
This was referenced Aug 19, 2026
Iamfle4ka
pushed a commit
that referenced
this pull request
Aug 26, 2026
Resolves 10 conflicts. Every one is on a page main has since turned into a redirect_to stub (#405/#406/#412/#413), so the fix queued for it is invisible to readers of this site; main's stub wins in each case: extend/common-interface/config-file.md "colummns"; missing , after destination extend/common-interface/development-branches.md "accross" -> "across" extend/common-interface/folders.md URL split across a newline; missing leading /; "my-inpupt" extend/component/running/index.md "you loose"; 2 heading renames for inbound links .../generic-extractor/.../api/pagination/index.md offset link pointed at the pagenum page .../generic-extractor/configuration/config/index.md #dataType -> #data-type extend/generic-extractor/functions.md unterminated "http://example.com/ string extend/generic-extractor/tutorial/basic.md #configuration-sections anchor; missing , in JSON integrate/mcp.md 2 root-relative links that pointed off-site integrate/variables/index.md singular #...-for-variable anchor; localhost:4000 URL Those belong against help now, alongside connection-docs#1077 — listed above so they are not lost. The 11 surviving fixes (/cli/, /integrate/jobs/, /overview/, /extend/generic-writer/) are untouched. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Wc7aH2VDs4qYwxCai1JuSA
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.