Skip to content

Clarify MCP server tool compatibility and version pinning - #3167

Closed
mcncl wants to merge 2 commits into
mainfrom
docs/mcp-server-version-compatibility
Closed

mcncl wants to merge 2 commits into
mainfrom
docs/mcp-server-version-compatibility

Conversation

@mcncl

@mcncl mcncl commented Sep 28, 2026

Copy link
Copy Markdown
Contributor

The Buildkite MCP server is under active development, so the docs should not imply that its tools and behavior are stable across updates.

Add a short note explaining that breaking changes may occur and that users who need a particular tool or behavior can pin a locally run Docker image or release binary. Clarify that Buildkite-hosted remote endpoints update automatically and cannot be pinned.

@mcncl
mcncl requested a review from a team as a code owner September 28, 2026 23:57
@github-actions github-actions Bot added the api label Sep 28, 2026
@buildkite-systems

Copy link
Copy Markdown

@buildsworth-bk-app buildsworth-bk-app Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The new guidance matches the documented local and remote options. I left one note about carrying a pinned tag through the linked setup steps.

Want to dig deeper?

Paste this into your agent to explore the findings from this review's Buildkite build:

Download the buildsworth logs from build 33372, then answer my questions about the findings.

Install the reading-buildsworth-logs skill to run this.

About buildsworth

Model: gpt-6-sol with xhigh thinking.

How to request a review: Comment @buildsworth-bk review on the PR, or request buildsworth-bk as a reviewer.

Risk labels (how buildsworth classifies risk) — buildsworth classifies risk itself from the diff. Unless repository policy already allows L2 approval, grant it by mentioning @buildsworth-bk (see approval ceiling and L2 approval grant):

  • L1 — Low risk (dep bumps, docs/copy, lockfiles, small presentational fixes). buildsworth may approve by default.
  • L2 — Standard risk (new UI, additive API fields, refactors). Approved only when repository policy or a verified grant allows it; otherwise comment-only.
  • L3 — High risk (auth, migrations, payments, secrets, perf-critical pipeline paths). Human approval required unless repository policy explicitly allows L3 approval; per-PR grants cannot allow it.

Comment thread pages/apis/mcp_server.md Outdated

Buildkite provides both a [remote](#types-of-mcp-servers-remote-mcp-server) and [local](#types-of-mcp-servers-local-mcp-server) MCP server, both of which provide access to its [MCP server tools](/docs/apis/mcp-server/tools#available-mcp-tools). The remote MCP server supports OAuth authentication for interactive AI tools and [API token pass-through](#api-token-pass-through-remote-mcp-server) for headless agents.

The Buildkite MCP server is under active development. Tools or their behavior may change or be removed, including breaking changes. If you need continued access to a specific tool or behavior, [run the local server](/docs/apis/mcp-server/local/installing) with a versioned Docker image tag or a binary from a specific release. Buildkite-hosted remote endpoints update automatically and cannot be pinned to a version.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Non-blocking: The linked installation steps and AI-tool configuration examples use buildkite/mcp-server without a tag and --pull=always, so copying them still follows the latest release on each restart. A short note to replace that image with buildkite/mcp-server:<version> in both the run command and client configuration would make this pinning guidance easier to follow.

@mcncl mcncl closed this Sep 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants