docs: adds a subsection for mcp guardrails

[Madhuvod]

Summary

Adds a dedicated MCP Guardrails section to the guardrails documentation, explaining how guardrails apply at the tool-execution boundary for MCP targets, including phase behavior, UI field descriptions, and provider compatibility notes.

Changes

• Replaced the brief inline mention of MCP rule behavior in the Architecture section with a cross-reference link to the new dedicated section.
• Added a new ## MCP Guardrails section covering:
  • How input, output, and both phases apply at the tool-execution boundary.
  • A table describing the flow and block behavior for each phase.
  • Guidance on selecting MCP clients, tools, and tool arguments when creating rules.
  • A note clarifying that all supported guardrail providers work with MCP rules and that redaction support follows the same provider constraints as LLM rules.
  • Cross-references to existing sections for rule configuration and CEL expression examples.
• Added a screenshot (ui-mcp-guardrail-rule.png) showing the MCP guardrail rule editor in the UI.

Type of change

• Bug fix
• Feature
• Refactor
• Documentation
• Chore/CI

Affected areas

• Core (Go)
• Transports (HTTP)
• Providers/Integrations
• Plugins
• UI (React)
• Docs

How to test

Navigate to the rendered guardrails documentation page and verify:

• The Architecture section links to #mcp-guardrails instead of containing inline MCP text.
• The new MCP Guardrails section renders correctly with the phase table, screenshot, and note.
• The screenshot image loads without errors.

Screenshots/Recordings

The new section includes a screenshot of the MCP guardrail rule editor (ui-mcp-guardrail-rule.png).

Breaking changes

• Yes
• No

Related issues

Security considerations

None. Documentation-only change.

Checklist

• I read docs/contributing/README.md and followed the guidelines
• I added/updated tests where appropriate
• I updated documentation where needed
• I verified builds succeed (Go and UI)
• I verified the CI pipeline passes locally if applicable

[coderabbitai]

📝 Walkthrough

Summary by CodeRabbit

• Documentation
  • Added comprehensive documentation for MCP Guardrails.
  • Explained execution-boundary protection, input/output phases, blocking and redaction behavior.
  • Documented UI targeting, shared provider support, and reusable profiles, sampling, and timeout settings.
  • Updated architecture guidance to link to the new MCP Guardrails section.

Walkthrough

This PR updates docs/enterprise/guardrails.mdx. It replaces an inline architecture note with a reference to a new MCP Guardrails section. The new section documents inspection phases, block and redact behavior, UI targeting fields, provider support, and reused settings.

Changes

MCP guardrails documentation

Layer / File(s)	Summary
MCP guardrails section docs/enterprise/guardrails.mdx	The architecture text now points to a dedicated MCP Guardrails section. That section documents pre-execution, post-execution, and combined inspection behavior, blocking and redaction outcomes, UI targeting fields, provider compatibility, and reuse of existing guardrail settings.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

• maximhq/bifrost#5758: This PR expands the MCP guardrail behavior and concepts documented there.
• maximhq/bifrost#5520: Both PRs modify docs/enterprise/guardrails.mdx with related guardrail documentation updates.

Suggested reviewers: akshaydeo, bearts

🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (2 warnings)

Check name	Status	Explanation	Resolution
Linked Issues check	⚠️ Warning	The PR adds MCP guardrails documentation but does not address linked issue #123 requirements for provider File API support.	Implement or link changes that support file uploads through provider File APIs, including the required endpoint and related workflows.
Out of Scope Changes check	⚠️ Warning	The MCP guardrails documentation changes are unrelated to linked issue #123, which concerns File API support for providers.	Link this PR to an MCP guardrails documentation issue, or revise the changes to address the File API Support objectives in issue #123.

✅ Passed checks (3 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Title check	✅ Passed	The title clearly identifies the main documentation change: adding an MCP Guardrails subsection.
Description check	✅ Passed	The description covers the purpose, changes, testing steps, affected areas, screenshots, breaking changes, security, and checklist.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch 08-05-docs_adds_a_subsection_for_mcp_guardrails

---

_{Comment @coderabbitai help to get the list of available commands.}

[Madhuvod]

• docs: adds a subsection for mcp guardrails #5869 👈 (View in Graphite)
• dev

This stack of pull requests is managed by Graphite. Learn more about stacking.

[akshaydeo]

Merge activity

• Aug 5, 6:14 PM UTC: A user started a stack merge that includes this pull request via Graphite.
• Aug 5, 6:15 PM UTC: @akshaydeo merged this pull request with Graphite.