docs(changelog): MCP server API token auth for headless and CI use

changelog/2026-04-08-flaky-tests-mcp-api-token-auth.mdx

@@ -0,0 +1,24 @@
+---
+title: "Flaky Tests: API Token Auth for the Trunk MCP Server"
+description: "The Trunk MCP server now accepts a Trunk organization API token via the Authorization: Bearer header, so you can use Trunk's MCP tools from CI jobs, scripts, and any client that doesn't support an OAuth flow."
+date: 2026-04-08
+category: Flaky Tests
+type: update
+---
+
+**The Trunk MCP server now accepts API token authentication as an alternative to OAuth, so you can use Trunk's MCP tools from CI jobs, scripts, and any client that doesn't support an OAuth flow.**
+
+OAuth stays the default for interactive clients. For headless and CI use, pass a Trunk organization API token via the standard `Authorization: Bearer <token>` header. The server first tries the OAuth (JWT) path; if the token isn't a valid JWT, it looks the token up as an org API token and authenticates the request at the org level. Authorization checks still apply.
+
+```json
+{
+  "mcpServers": {
+    "trunk": {
+      "url": "https://mcp.trunk.io/mcp",
+      "headers": { "Authorization": "Bearer <your-trunk-api-token>" }
+    }
+  }
+}
+```
+
+[Read the docs](https://docs.trunk.io/flaky-tests/reference/mcp-reference/configuration/bearer-auth) to learn more.

changelog/index.mdx

@@ -70,6 +70,12 @@ rss: true
   Merge Queue can now be managed fully through Terraform. Previously, creating, updating, and managing a Trunk Merge Queue was a manual process handled through our UI.
 </Update>
 
+<Update label="April 8, 2026" tags={["Flaky Tests"]}>
+  **[Flaky Tests: API Token Auth for the Trunk MCP Server](/changelog/2026-04-08-flaky-tests-mcp-api-token-auth)**
+
+  The Trunk MCP server now accepts a Trunk organization API token via the `Authorization: Bearer` header, so you can use Trunk's MCP tools from CI jobs, scripts, and any client that doesn't support an OAuth flow.
+</Update>
+
 ### March 2026
 
 <Update label="March 27, 2026" tags={["Flaky Tests"]}>

docs.json

@@ -625,6 +625,7 @@
               "changelog/2026-04-30-merge-queue-chrome-extension",
               "changelog/2026-04-21-merge-queue-drill-down-into-merge-metrics",
               "changelog/2026-04-13-merge-queue-terraform-provider",
+              "changelog/2026-04-08-flaky-tests-mcp-api-token-auth",
               "changelog/2026-03-27-flaky-tests-automatically-create-jira-issues-from-webhooks",
               "changelog/2026-03-26-merge-queue-testing-details-api-now-includes-impacted-target-information",
               "changelog/2026-03-25-merge-queue-multiple-queues-per-repo-with-grouped-selector",

flaky-tests/changelog.mdx

@@ -38,6 +38,14 @@ rss: true
   Tag, organize, and filter your test suite with org-wide labels.
 </Update>
 
+### April 2026
+
+<Update label="April 8, 2026" tags={["Flaky Tests"]}>
+  **[Flaky Tests: API Token Auth for the Trunk MCP Server](/changelog/2026-04-08-flaky-tests-mcp-api-token-auth)**
+
+  The Trunk MCP server now accepts a Trunk organization API token via the `Authorization: Bearer` header, so you can use Trunk's MCP tools from CI jobs, scripts, and any client that doesn't support an OAuth flow.
+</Update>
+
 ### March 2026
 
 <Update label="March 27, 2026" tags={["Flaky Tests"]}>