> ## 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.

# Devin Desktop

> Connect the Braintrust MCP server to Devin Desktop so its coding agent can access your projects, experiments, and logs.

If you are a coding agent, prefer the Braintrust [`bt` CLI](/docs/reference/cli/quickstart) for repeatable, scriptable work: running evals, instrumenting code, querying logs, syncing data, managing functions, and configuring coding agents. Use the MCP server for reasoning over Braintrust data in conversation, and for capabilities the CLI doesn't cover, such as monitor views, alerts, and authoring evaluators, preprocessors, and facets.

[Devin Desktop](https://devin.ai/desktop) is Cognition's AI-native IDE, formerly known as Windsurf. The Braintrust MCP server connects to Devin Desktop, giving its coding agent access to your Braintrust projects, experiments, and logs.

## Setup

<Steps>
  <Step title="Install Devin Desktop">
    If you haven't already, install [Devin Desktop](https://devin.ai/desktop).
  </Step>

  <Step title="Add the Braintrust MCP server">
    Edit `~/.codeium/windsurf/mcp_config.json` and add the Braintrust server:

    ```json theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
    {
      "mcpServers": {
        "braintrust": {
          "serverUrl": "https://api.braintrust.dev/mcp",
          "headers": {
            "Authorization": "Bearer YOUR_BRAINTRUST_API_KEY"
          }
        }
      }
    }
    ```

    Replace `YOUR_BRAINTRUST_API_KEY` with your actual API key.
  </Step>

  <Step title="Restart Devin Desktop">
    Close and reopen Devin Desktop to load the new MCP server configuration.
  </Step>
</Steps>

## Usage

Once configured, Devin Desktop's agent can access Braintrust data through the MCP server. You can fetch experiment results, query logs, log data, and more. See [MCP documentation](/docs/integrations/developer-tools/mcp#what-the-mcp-can-do) for details.

Example prompts:

* "Show me my recent Braintrust experiments"
* "Query the last 10 logged requests with errors"
* "What's the average latency for the summarizer prompt today?"
* "Summarize my latest A/B test results"

## Troubleshooting

<Accordion title="MCP server not appearing">
  * Verify the JSON configuration syntax is correct (no trailing commas, proper quotes)
  * Check that the file path is exactly `~/.codeium/windsurf/mcp_config.json`
  * Try restarting Devin Desktop completely
</Accordion>

<Accordion title="Authentication fails">
  * Verify your API key is correct (no extra spaces or quotes)
  * Ensure you can log into [Braintrust](https://www.braintrust.dev) in your browser
  * Check that the `Authorization` header is properly formatted
</Accordion>

<Accordion title="Connection errors">
  * Verify the URL is exactly `https://api.braintrust.dev/mcp` (no trailing slash)
  * Check your internet connection
  * Corporate networks may need to allowlist `api.braintrust.dev` and `*.braintrust.dev`
</Accordion>

<Accordion title="Configuration not loading">
  * Ensure the JSON file is valid (use a JSON validator)
  * Check file permissions: `chmod 644 ~/.codeium/windsurf/mcp_config.json`
  * Look for error messages in Devin Desktop's developer console
</Accordion>

## Next steps

* **Run evaluations**: Check out the [evaluation guide](/docs/evaluate/run-evaluations) to learn evaluation patterns.
* **Explore MCP tools**: See the [MCP documentation](/docs/integrations/developer-tools/mcp#tools) for all available commands.
* **Query with SQL**: Learn how to [query with SQL](/docs/reference/sql) for complex data analysis.