docs: note that MCP has its own rate limit on the overview page#3130
docs: note that MCP has its own rate limit on the overview page#3130simone-bennett wants to merge 1 commit into
Conversation
|
On it! Follow along with my review here: https://buildkite.com/buildkite/buildsworth-review-pull-request/builds/2034 |
![buildsworth-bk-app[bot]](https://avatars.githubusercontent.com/in/3010600?s=60&v=4){kind=small}
There was a problem hiding this comment.
One blocking docs accuracy issue inline. The new overview note needs to be scoped to the remote MCP server so it doesn't contradict the local MCP server rate-limit guidance on the same page.
Want to dig deeper? The full session log is attached to this Buildkite build. Download the session file and open a new pi session with it:
Download the buildsworth logs from build 2034, then answer my questions about the findings.
|
|
||
| Once you have established which Buildkite MCP server to use (remote or local) and if local, have [installed the MCP server](/docs/apis/mcp-server/local/installing#install-and-run-the-server-locally) and [configured its API access token](/docs/apis/mcp-server/local/installing#configure-an-api-access-token), you can then proceed to configure your AI tools to work with the [remote](/docs/apis/mcp-server/remote/configuring-ai-tools) (recommended) or [local](/docs/apis/mcp-server/local/configuring-ai-tools) MCP server. | ||
|
|
||
| Note: MCP requests count against a separate rate limit from your org's REST API budget. See [[platform limits](https://buildkite.com/docs/platform/limits)](https://buildkite.com/docs/platform/limits) for the specific numbers. |
There was a problem hiding this comment.
Blocking: This needs to be scoped to the remote MCP server. The local MCP server section below says local requests count toward the standard REST API rate limit, so as written this tells local MCP users the opposite. The suggestion also fixes the nested Markdown link and uses a docs-relative internal URL.
| Note: MCP requests count against a separate rate limit from your org's REST API budget. See [[platform limits](https://buildkite.com/docs/platform/limits)](https://buildkite.com/docs/platform/limits) for the specific numbers. | |
| > 📘 Remote MCP server rate limits | |
| > Requests made through the remote Buildkite MCP server use a separate per-user rate limit from your Buildkite organization's REST API rate limit. See [platform limits](/docs/platform/limits) for the specific numbers. |
2 participants
Customer feedback surfaced that the MCP-specific rate limit is easy to miss. It is already documented at /docs/platform/limits but is not surfaced on the MCP server overview page. This adds one line pointing at the limits page so it is easier to find.