> ## Documentation Index
> Fetch the complete documentation index at: https://braintrust.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Cowork

> Trace Claude Cowork sessions and connect Cowork to Braintrust MCP

[Claude Cowork](https://support.claude.com/en/articles/13345190) 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.

<Steps>
  <Step title="Configure tracing in the terminal">
    Follow the [`bt` CLI quickstart](/docs/reference/cli/quickstart) to install `bt`, authenticate, and set your active context. Then configure tracing for your Braintrust project:

    ```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
    bt trace enable claude --project <your-project>
    ```

    For configuration options, see [`bt trace enable`](/docs/reference/cli/trace#bt-trace-enable).
  </Step>

  <Step title="Install the tracing plugin in the Claude desktop app">
    Open Cowork in the Claude desktop app and follow [Anthropic's plugin instructions](https://support.claude.com/en/articles/13837440) to add the marketplace and install the Braintrust tracing plugin. Use these identifiers:

    * **Marketplace source**: `braintrustdata/braintrust-claude-plugin`
    * **Plugin**: `trace-claude-code`
  </Step>

  <Step title="Verify tracing">
    Restart Cowork, complete a short task, then go to [**<Icon icon="activity" /> Logs**](https://www.braintrust.dev/app/~/logs) and confirm that the trace appears in the intended project.
  </Step>
</Steps>

### 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](/docs/reference/cli/trace#project-log-permissions).

For local configuration, authentication, tracing destination, and endpoint problems, see [`bt trace` troubleshooting](/docs/reference/cli/trace#troubleshooting).

## Connect to Braintrust MCP

Use a remote custom [connector](https://support.claude.com/en/articles/11175166) 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](https://support.claude.com/en/articles/11175166) using the Braintrust connection details below.

<Note>
  Team and Enterprise organizations require an Owner or Primary Owner to add the connector before members connect their individual accounts.
</Note>

<Steps>
  <Step title="Choose the Braintrust endpoint">
    Use the MCP endpoint for your Braintrust organization. The default US endpoint is:

    ```text theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
    https://api.braintrust.dev/mcp
    ```

    For EU and self-hosted organizations, find the appropriate URL under [MCP endpoints](/docs/integrations/developer-tools/mcp#endpoints).
  </Step>

  <Step title="Add the remote connector">
    Add a remote custom connector using Anthropic's [instructions](https://support.claude.com/en/articles/11175166). 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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

### 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](/docs/integrations/developer-tools/mcp#what-the-mcp-can-do) for more workflows and example prompts.

### Troubleshooting MCP

<AccordionGroup>
  <Accordion title="The Braintrust connector is unavailable">
    Confirm that the connector has been added according to [Anthropic's remote custom connector instructions](https://support.claude.com/en/articles/11175166). For Team and Enterprise organizations, an Owner or Primary Owner must add it before members connect their accounts.
  </Accordion>

  <Accordion title="MCP authentication or connection fails">
    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](/docs/integrations/developer-tools/mcp#connect-your-client).
  </Accordion>
</AccordionGroup>

## Next steps

* **Learn the CLI**: See the full [`bt trace` reference](/docs/reference/cli/trace).
* **Run evaluations**: Follow the [evaluation guide](/docs/evaluate/run-evaluations).
* **Explore MCP tools**: See the [Braintrust MCP tool reference](/docs/integrations/developer-tools/mcp#tools).
* **Browse the source**: View the [coding-agent plugins repository](https://github.com/braintrustdata/braintrust-coding-agent-plugins).