From be90d6cad32def03d2ea363596389be2219eb100 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Mon, 7 Sep 2026 05:10:08 +0000
Subject: [PATCH] docs: document gRPC metadata, Bru comments, editor shortcuts,
 and MCP server

---
 ai/integration/overview.mdx           |  6 ++++++
 bru-lang/language.mdx                 | 15 +++++++++++++++
 get-started/configure/keybindings.mdx | 11 +++++++++++
 send-requests/grpc/grpc-request.mdx   | 12 ++++++++++++
 4 files changed, 44 insertions(+)

diff --git a/ai/integration/overview.mdx b/ai/integration/overview.mdx
index 0f7d6a08..00856814 100644
--- a/ai/integration/overview.mdx
+++ b/ai/integration/overview.mdx
@@ -11,6 +11,12 @@ You can configure Bruno to use any AI agent and editor of your choice.
 
 See [Use cases](./use-cases) for common workflows (generating collections, writing tests, CI/CD) and example prompts you can use with any supported agent.
 
+## MCP Server
+
+[Bruno MCP](https://github.com/usebruno/bruno-mcp) is a Model Context Protocol (MCP) server that lets MCP-compatible AI assistants, such as Claude and Cursor, work with your Bruno API collections. It exposes your requests, folders, and environments as MCP tools so an agent can discover, inspect, and run them, while your collection files stay on your local filesystem.
+
+The Bruno desktop app does not include a built-in MCP server. See the [Bruno MCP repository](https://github.com/usebruno/bruno-mcp) for details.
+
 ## Supported Agents
 
 - [Cursor](https://cursor.com) - AI code editor with powerful automation for API development workflows
diff --git a/bru-lang/language.mdx b/bru-lang/language.mdx
index 77b6c75e..cddb1478 100644
--- a/bru-lang/language.mdx
+++ b/bru-lang/language.mdx
@@ -49,3 +49,18 @@ vars:secret [
 ```
 Any key in the array block can be prefixed with `~` to indicate that it is disabled.
 
+### Comments
+
+The Bru markup language does not have a dedicated comment syntax. To keep an entry in a file without it taking effect, prefix it with `~` to disable it:
+
+```bash
+headers {
+  content-type: application/json
+  ~transaction-id: {{transactionId}}
+}
+```
+
+The content of `script:pre-request`, `script:post-response`, and `tests` blocks is JavaScript, so standard JavaScript comments (`//` and `/* */`) work inside those blocks.
+
+To document a request, use the `docs` block or the **Docs** tab in the app.
+
diff --git a/get-started/configure/keybindings.mdx b/get-started/configure/keybindings.mdx
index ac0faa83..15e0b480 100644
--- a/get-started/configure/keybindings.mdx
+++ b/get-started/configure/keybindings.mdx
@@ -81,6 +81,17 @@ Below are the default keyboard shortcuts. macOS equivalents replace `Ctrl` with
 | Open preferences | `⌘ ,` | `Ctrl ,` |
 | Close Bruno | `⌘ Q` | `Ctrl Shift Q` |
 
+**Code editor**
+
+These shortcuts work inside code editors such as the request body, script, and tests editors. They are built into the editor and don't appear in the Keybindings panel.
+
+| Command | macOS | Windows / Linux |
+|---|---|---|
+| Toggle comment on selected lines | `⌘ /` | `Ctrl /` |
+| Fold all | `⌘ Y` | `Ctrl Y` |
+| Unfold all | `⌘ I` | `Ctrl I` |
+| Trigger autocomplete | `⌘ Space` | `Ctrl Space` |
+
 ## Customizing keybindings
 
 You can remap most keyboard shortcuts to your preferred key combinations.
diff --git a/send-requests/grpc/grpc-request.mdx b/send-requests/grpc/grpc-request.mdx
index 299088ba..edbecb95 100644
--- a/send-requests/grpc/grpc-request.mdx
+++ b/send-requests/grpc/grpc-request.mdx
@@ -51,4 +51,16 @@ Bruno gRPC interface provides an intuitive way to interact with gRPC services. T
 
 You'll see the response in the **Response** section with detailed information about the request execution.
 
+## Adding metadata
+
+gRPC uses metadata instead of HTTP headers. Use metadata to send key-value pairs such as access tokens or tenant identifiers with a request.
+
+1. Open your gRPC request and select the **Metadata** tab in the request pane.
+2. Click **Add Metadata** and enter the key and value.
+3. Use the checkbox next to an entry to enable or disable it.
+
+Metadata values support variable interpolation, so you can reference environment or collection variables like `{{token}}`.
+
+For authentication methods such as Basic, Bearer, or API key, use the **Auth** tab instead of adding metadata manually.
+
 To learn about proto files, navigate to the [Adding Proto file section.](./grpc-proto)
\ No newline at end of file