docs(mcp): Consolidate MCP server docs by ian-at-airbyte · Pull Request #78241 · airbytehq/airbyte

Ian Alton (ian-at-airbyte) · 2026-05-19T20:52:36Z

What

Consolidates the public MCP server docs under the Community docs instance for AGENTIC-1656: https://linear.app/airbyteio/issue/AGENTIC-1656/consolidate-mcp-server-docs-into-one-section

Requested by Ian Alton.

How

Moves Airbyte Knowledge MCP and PyAirbyte MCP docs from docs/developers/mcp-servers to docs/community/mcp-servers.
Adds a new Community MCP landing page with a prominent Agent MCP section/card linking to /ai-agents/interfaces/mcp/.
Keeps Agent MCP nested under the Community MCP servers sidebar category.
Replaces the landing page DocCardList with explicit custom cards for Knowledge MCP server and PyAirbyte MCP server, avoiding a duplicate Agent MCP card.
Removes the Connector Builder MCP page and Developer sidebar entry.
Adds Community sidebar entries and Vercel redirects from the old Developer MCP URLs.
Adds a Knowledge MCP sidebar label via page frontmatter.

Review guide

docs/community/mcp-servers/readme.md
docusaurus/sidebar-community.js
docusaurus/sidebar-developers.js
docusaurus/vercel.json

User Impact

Users find MCP server docs under Community, with Agent MCP presented as the primary recommended MCP server. Existing Airbyte Knowledge MCP and PyAirbyte MCP URLs redirect to their new Community locations.

Can this PR be safely reverted and rolled back?

YES 💚
NO ❌

Validation:

corepack pnpm install
git diff --check
/home/ubuntu/.local/bin/pre-commit run --files docusaurus/vercel.json docusaurus/sidebar-community.js docusaurus/sidebar-developers.js docs/community/mcp-servers/readme.md docs/community/mcp-servers/airbyte-knowledge-mcp.md docs/community/mcp-servers/pyairbyte-mcp.md
corepack pnpm clear && corepack pnpm build

Link to Devin session: https://app.devin.ai/sessions/aa95e15dbd8c41f891fec61d6f85b53a
Requested by: Ian Alton (@ian-at-airbyte)

devin-ai-integration · 2026-05-19T20:52:40Z

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

Disable automatic comment and CI monitoring

linear · 2026-05-19T20:52:41Z

AGENTIC-1656

github-actions · 2026-05-19T20:53:07Z

👋 Greetings, Airbyte Team Member!

Here are some helpful tips and reminders for your convenience.

💡 Show Tips and Tricks

PR Slash Commands

Airbyte Maintainers (that's you!) can execute the following slash commands on your PR:

🛠️ Quick Fixes
- /format-fix - Fixes most formatting issues.
- /bump-version - Bumps connector versions, scraping changelog description from the PR title.
  - Bump types: patch (default), minor, major, major_rc, rc, promote.
  - The rc type is a smart default: applies minor_rc if stable, or bumps the RC number if already RC.
  - The promote type strips the RC suffix to finalize a release.
  - Example: /bump-version type=rc or /bump-version type=minor
- /bump-progressive-rollout-version - Alias for /bump-version type=rc. Bumps with an RC suffix and enables progressive rollout.
❇️ AI Testing and Review (internal link: AI-SDLC Docs):
- /ai-prove-fix - Runs prerelease readiness checks, including testing against customer connections.
- /ai-canary-prerelease - Rolls out prerelease to 5-10 connections for canary testing.
- /ai-review - AI-powered PR review for connector safety and quality gates.
📝 AI Documentation:
- /ai-docs-review - AI-powered documentation review for PRs with connector changes.
- /ai-create-docs-pr - Creates a documentation PR for connector changes, stacked on the current PR.
🚀 Connector Releases:
- /publish-connectors-prerelease - Publishes pre-release connector builds (tagged as {version}-preview.{git-sha}) for all modified connectors in the PR.
☕️ JVM connectors:
- /update-connector-cdk-version connector=<CONNECTOR_NAME> - Updates the specified connector to the latest CDK version.
  Example: /update-connector-cdk-version connector=destination-bigquery
🐍 Python connectors:
- /poe connector source-example lock - Run the Poe lock task on the source-example connector, committing the results back to the branch.
- /poe source example lock - Alias for /poe connector source-example lock.
- /poe source example use-cdk-branch my/branch - Pin the source-example CDK reference to the branch name specified.
- /poe source example use-cdk-latest - Update the source-example CDK dependency to the latest available version.
⚙️ Admin commands:
- /force-merge reason="<REASON>" - Force merges the PR using admin privileges, bypassing CI checks. Requires a reason.
  Example: /force-merge reason="CI is flaky, tests pass locally"

📚 Show Repo Guidance

Helpful Resources

Breaking Changes Guide - Breaking changes, migration guides, and upgrade deadlines
Developing Connectors Locally
Managing Connector Secrets
On-Demand Regression Tests
#connector-ci-issues
#connector-publish-updates
#connector-build-statuses

📝 Edit this welcome message.

github-actions · 2026-05-19T21:12:07Z

Deploy preview for airbyte-docs ready!

Project:	`airbyte-docs`
Status:	✅ Deploy successful!
Preview URL:	https://airbyte-docs-ir6kw2b0m-airbyte-growth.vercel.app
Latest Commit:	`f415a34`

Deployed with vercel-action

Ian Alton (ian-at-airbyte) · 2026-05-19T22:13:54Z

For the Airbyte knowledge MCP, specify that this is a tool to provide knowledge to agents, but not the primary interface agents should work with. Link to the Agent MCP docs, which is the primary way agents should use Airbyte to work with data.

For the PyAirbyte MCP, specify that this is a tool to manage Airbyte data replication connections, but not the primary interface agents should work with. Link to the Agent MCP, which is the primary way agents should use Airbyte to work with data.

Ian Alton (ian-at-airbyte) · 2026-05-19T22:14:26Z

Also add a link to the Agent MCP in the sidebar in the new Community section.

And remove the link to the public roadmap.

Ian Alton (ian-at-airbyte) · 2026-05-19T23:24:54Z

+  },
+  items: [
+    {
+      type: "link",


The DocCardList element is generated because of this. This isn't really necessary because we already fully highlight this MCP above the DocCardList. How likely is it that we can prevent this from rendering a DocCard on the page?

Moved the Agent MCP link outside the MCP servers category in 9fa6860. That keeps it in the Community sidebar but prevents DocCardList on the MCP landing page from rendering a duplicate Agent MCP card.

Devin session

Ian Alton (ian-at-airbyte) · 2026-05-19T23:25:22Z

+# MCP servers
+
+Airbyte provides MCP (Model Context Protocol) servers for connecting AI assistants to Airbyte and Airbyte-related context.
+


Suggested change

## Agent MCP

Added this heading in 9fa6860.

Devin session

Ian Alton (ian-at-airbyte) · 2026-05-19T23:26:50Z

@@ -1,8 +1,8 @@
 # Airbyte knowledge MCP server


Can we add frontmatter and set the sidebar label to "Knowledge MCP server"?

Added frontmatter with sidebar_label: Knowledge MCP server in 9fa6860.

Devin session

Ian Alton (ian-at-airbyte) · 2026-05-20T18:26:13Z

Moving the Agent MCP isn't exactly the right solution. I still want it to be a child of the larger MCP section. I just don't want it to appear in the DocCardList, if possible. Present a plan before implementing.

devin-ai-integration · 2026-05-20T18:32:34Z

Plan before changing anything:

Restore Agent MCP as the first child item inside the mcpServers.items array so it stays nested under the larger MCP servers sidebar section.
Stop using default <DocCardList /> on docs/community/mcp-servers/readme.md, because it renders all children of that sidebar category.
Replace that auto-generated list with an explicit “Other Airbyte MCP servers” set containing only Knowledge MCP server and PyAirbyte MCP. I’d use the existing card/grid style if it looks consistent; otherwise a simple two-link list is the fallback.
Run focused pre-commit plus Docusaurus build, then update the PR description if the implementation details changed.

This keeps the sidebar hierarchy you want while avoiding a duplicate Agent MCP card on the landing page.

Devin session

Ian Alton (ian-at-airbyte) · 2026-05-20T20:04:25Z

Using the custom card component we have seems like the right choice.

devin-ai-integration · 2026-05-20T20:13:43Z

Implemented in f415a34 using the custom card component:

Restored Agent MCP as a child of the MCP servers sidebar category.
Removed the auto DocCardList from the MCP landing page.
Added explicit custom cards for only Knowledge MCP server and PyAirbyte MCP server under “Other Airbyte MCP servers.”

Local validation passed: git diff --check, focused pre-commit, and corepack pnpm clear && corepack pnpm build.

Devin session

Alexandre Girard (girarda) · 2026-05-21T02:24:08Z

+
+</Grid>
+
+## Other Airbyte MCP servers


:chef-kiss:

docs(mcp): Consolidate MCP server docs

7cc6ca1

devin-ai-integration Bot assigned Ian Alton (ian-at-airbyte) May 19, 2026

docs(mcp): Clarify MCP positioning

f330688

Ian Alton (ian-at-airbyte) commented May 19, 2026

View reviewed changes

Comment thread docs/community/mcp-servers/airbyte-knowledge-mcp.md Outdated

Apply suggestion from @ian-at-airbyte

30970ca

Ian Alton (ian-at-airbyte) commented May 19, 2026

View reviewed changes

Comment thread docs/community/mcp-servers/pyairbyte-mcp.md Outdated

Apply suggestion from @ian-at-airbyte

760a88c

Ian Alton (ian-at-airbyte) commented May 19, 2026

View reviewed changes

docs(mcp): Address MCP docs review feedback

9fa6860

docs(mcp): Use explicit MCP landing cards

f415a34

Ian Alton (ian-at-airbyte) marked this pull request as ready for review May 20, 2026 21:00

Alexandre Girard (girarda) approved these changes May 21, 2026

View reviewed changes

Ian Alton (ian-at-airbyte) merged commit f91f282 into master May 21, 2026
60 of 63 checks passed

Ian Alton (ian-at-airbyte) deleted the devin/1779221733-agentic-1656-mcp-docs branch May 21, 2026 02:31

This was referenced May 21, 2026

docs: rename PyAirbyte MCP references airbytehq/PyAirbyte#1031

Merged

docs(mcp): rename replication MCP references #78313

Merged

		# MCP servers

		Airbyte provides MCP (Model Context Protocol) servers for connecting AI assistants to Airbyte and Airbyte-related context.

Uh oh!

Conversation

Ian Alton (ian-at-airbyte) commented May 19, 2026 • edited by devin-ai-integration Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What

How

Review guide

User Impact

Can this PR be safely reverted and rolled back?

Uh oh!

devin-ai-integration Bot commented May 19, 2026

🤖 Devin AI Engineer

Uh oh!

linear Bot commented May 19, 2026

Uh oh!

github-actions Bot commented May 19, 2026

👋 Greetings, Airbyte Team Member!

PR Slash Commands

Helpful Resources

Uh oh!

github-actions Bot commented May 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Ian Alton (ian-at-airbyte) commented May 19, 2026

Uh oh!

Ian Alton (ian-at-airbyte) commented May 19, 2026

Uh oh!

Uh oh!

Uh oh!

Ian Alton (ian-at-airbyte) May 19, 2026

Choose a reason for hiding this comment

Uh oh!

devin-ai-integration Bot May 19, 2026

Choose a reason for hiding this comment

Uh oh!

Ian Alton (ian-at-airbyte) May 19, 2026

Choose a reason for hiding this comment

Uh oh!

devin-ai-integration Bot May 19, 2026

Choose a reason for hiding this comment

Uh oh!

Ian Alton (ian-at-airbyte) May 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

devin-ai-integration Bot May 19, 2026

Choose a reason for hiding this comment

Uh oh!

Ian Alton (ian-at-airbyte) commented May 20, 2026

Uh oh!

devin-ai-integration Bot commented May 20, 2026

Uh oh!

Ian Alton (ian-at-airbyte) commented May 20, 2026

Uh oh!

devin-ai-integration Bot commented May 20, 2026

Uh oh!

Alexandre Girard (girarda) May 21, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Ian Alton (ian-at-airbyte) commented May 19, 2026 •

edited by devin-ai-integration Bot

Loading

github-actions Bot commented May 19, 2026 •

edited

Loading

Ian Alton (ian-at-airbyte) May 19, 2026 •

edited

Loading