Skip to main content
Claude Cowork extends Claude’s agentic capabilities to general knowledge work. You can connect Cowork to Braintrust in two independent ways:
  • Trace Cowork sessions to send Cowork activity to Braintrust through the trace-claude-code plugin and bt.
  • Connect to Braintrust MCP to work with Braintrust projects, experiments, logs, and other data from Cowork.

​
Trace Cowork sessions

Tracing requires setup in both a terminal and the Claude desktop app.

​
Set up tracing

Configure tracing from a terminal, install the tracing plugin in Cowork, then verify that a Cowork task appears in Braintrust.
1

Configure tracing in the terminal

Follow the bt CLI quickstart to install bt, authenticate, and set your active context. Then configure tracing for your Braintrust project:
For configuration options, see bt trace enable.
2

Install the tracing plugin in the Claude desktop app

Open Cowork in the Claude desktop app and follow Anthropic’s plugin instructions to add the marketplace and install the Braintrust tracing plugin. Use these identifiers:
  • Marketplace source: braintrustdata/braintrust-claude-plugin
  • Plugin: trace-claude-code
3

Verify tracing

Restart Cowork, complete a short task, then go to Logs and confirm that the trace appears in the intended project.

​
Troubleshooting tracing

Run bt trace doctor claude in the terminal to check the local tracing configuration and authentication. A successful check does not verify that Cowork can use that configuration. Confirm that the tracing plugin is installed in Cowork and that a test task produces a trace. If authentication succeeds but traces do not appear, confirm that your account has permission to write logs to the selected project. For local configuration, authentication, tracing destination, and endpoint problems, see bt trace troubleshooting.

​
Connect to Braintrust MCP

Use a remote custom connector to give Cowork access to Braintrust tools. The trace-claude-code marketplace plugin does not install or configure this connection.

​
Set up the MCP server

Follow Anthropic’s remote custom connector instructions using the Braintrust connection details below.
Team and Enterprise organizations require an Owner or Primary Owner to add the connector before members connect their individual accounts.
1

Choose the Braintrust endpoint

Use the MCP endpoint for your Braintrust organization. The default US endpoint is:
For EU and self-hosted organizations, find the appropriate URL under MCP endpoints.
2

Add the remote connector

Add a remote custom connector using Anthropic’s instructions. Provide these values when prompted:
  • Name: Braintrust
  • Remote MCP server URL: The endpoint from the previous step.
  • Authentication: OAuth. Braintrust supports dynamic client registration, so you do not need to provide an OAuth client ID or client secret.
3

Authenticate and verify the connection

Follow Anthropic’s instructions to connect your Braintrust account and make the connector available to Cowork. Complete the Braintrust OAuth flow when prompted.Ask Cowork to list your recent Braintrust projects. Confirm that Cowork uses the Braintrust connector and returns projects your account can access.

​
Use MCP tools

Once connected, Cowork can query logs, compare experiments, work with datasets, and use other Braintrust tools. For example:
  • “Show me my recent Braintrust experiments.”
  • “Query the last 10 logged requests with errors.”
  • “Compare accuracy scores between my two latest experiments.”
See what the Braintrust MCP can do for more workflows and example prompts.

​
Troubleshooting MCP

Confirm that the connector has been added according to Anthropic’s remote custom connector instructions. For Team and Enterprise organizations, an Owner or Primary Owner must add it before members connect their accounts.
Use Anthropic’s connector controls to disconnect and reconnect Braintrust, then complete OAuth again. For regional and self-hosted endpoints, authentication details, and network requirements, see the Braintrust MCP guide.

​
Next steps