Repository navigation
feat(claude): add hosted braintrust mcp plugin - #255
Abhijeet Prasad (AbhiPrasad) wants to merge 2 commits into
Conversation
> 🤖 **This text was AI-generated.** The Claude marketplace offered session tracing but did not provide a packaged connection to Braintrust's hosted MCP tools. Add a separate Braintrust plugin that connects through OAuth, alongside the existing tracing plugin: ```text Claude marketplace ├── braintrust → hosted MCP server └── trace-claude-code → bt tracing ``` Document installation and data handling, validate the MCP-only package, and keep the marketplace and plugin versions aligned during releases. Anthropic directory submission remains a manual step.
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 00b3df59c6
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "Codex (@codex) review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "Codex (@codex) address that feedback".
| @@ -0,0 +1,8 @@ | |||
| { | |||
| "mcpServers": { | |||
There was a problem hiding this comment.
.mcp.json server-map shape
When this plugin is installed, Claude parses a plugin-root .mcp.json as the server-name map; Anthropic's official example places example-server directly at the root rather than under a project-style mcpServers wrapper. With this shape Claude treats mcpServers as the server entry, which has neither type nor url, so braintrust is never registered and /mcp cannot offer the advertised OAuth connection; update this file and the validator's equality check to use {"braintrust": {...}}.
AGENTS.md reference: src/plugins/claude/content/AGENTS.md:L21-L24
Useful? React with 👍 / 👎.
There was a problem hiding this comment.
Fixed: .mcp.json now uses the root server map ({"braintrust": {...}}), and the validator and README were updated to match.
| ## Install | ||
|
|
||
| ```text | ||
| /plugin install braintrust --marketplace braintrustdata/braintrust-claude-plugin |
There was a problem hiding this comment.
When a user follows this first installation block inside Claude, /plugin install expects a qualified <plugin>@<marketplace> after the marketplace has been added, as shown by Anthropic's official marketplace instructions. --marketplace is not a supported single-plugin flag, so this documented path fails before the user can authenticate; show the two slash commands corresponding to the working shell example below.
Useful? React with 👍 / 👎.
There was a problem hiding this comment.
Fixed: the README now shows /plugin marketplace add braintrustdata/braintrust-claude-plugin followed by /plugin install braintrust@braintrust-claude-plugin.
Plugin-root .mcp.json is the server map itself, so drop the mcpServers wrapper that kept braintrust from registering. Also show the supported slash-command install syntax in the plugin README. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
ref https://linear.app/braintrustdata/issue/SDK-739/add-official-braintrust-anthropic-marketplace-plugin
The Claude marketplace offered session tracing but did not provide a packaged connection to Braintrust's hosted MCP tools.
Add a separate Braintrust plugin that connects through OAuth, alongside the existing tracing plugin:
Document installation and data handling, validate the MCP-only package, and keep the marketplace and plugin versions aligned during releases. Anthropic directory submission remains a manual step.