Skip to content

Conversation

@beonde
Copy link
Member

@beonde beonde commented Jan 17, 2026

Summary

Integrates MCP Guard content into the main CapiscIO documentation site, featuring MCP Guard as a first-class product alongside Core and SDK.

Changes

New Pages

File Purpose
docs/concepts/mcp-security.md MCP Security concepts (RFC-006/007 overview)
docs/overview/index.md "How CapiscIO Works" - product overview page
docs/reference/sdk-python/mcp.md Complete MCP Guard Python API reference

Updated Pages

File Changes
docs/index.md Redesigned homepage featuring MCP Guard
docs/concepts/index.md Added MCP Security section
docs/getting-started/index.md Added "Protect MCP Tools" quickstart card
docs/how-to/index.md Added MCP Guard how-to section
docs/reference/index.md Added MCP Guard product section
docs/reference/grpc.md Added MCPService documentation
docs/reference/sdk-python/index.md Added MCP API import reference
mkdocs.yml Major nav restructuring with MCP paths

Navigation Structure

Overview
├── How CapiscIO Works (NEW)
└── ...

Concepts
├── MCP Security (NEW)
├── Badges & Trust
└── ...

Reference
├── SDK - Python
│   ├── API Overview
│   └── MCP Guard API (NEW)
└── ...

Build Verification

make build  # ✅ Successful

Note: Cross-repo links (to mcp-guard/, rfcs/) show as warnings locally but work in production via the monorepo plugin.

Related

- Add MCP Security concepts page (concepts/mcp-security.md)
- Add How CapiscIO Works overview page (overview/index.md)
- Add MCP Guard Python SDK reference (reference/sdk-python/mcp.md)
- Update homepage with MCP Guard featured product
- Update navigation with MCP Guard sections
- Add MCPService to gRPC reference
- Update getting-started, how-to, and reference indexes
The mkdocs.yml includes capiscio-mcp-python for MCP Guard reference docs,
but the CI workflow was missing the checkout step for this repo.
The monorepo plugin doesn't properly resolve relative RFC paths.
Use direct GitHub links for consistency with other RFC references.
@github-actions
Copy link

✅ Documentation Build Successful

The documentation build completed successfully and passed validation checks.

  • ✅ Build completed without errors
  • ✅ Critical files present (index.html, sitemap.xml, robots.txt)
  • ✅ Link validation completed

This PR will deploy to dev-docs.capisc.io when merged to main.

@beonde beonde merged commit 87ea82f into main Jan 18, 2026
4 checks passed
@beonde beonde deleted the docs/mcp-guard-integration branch January 18, 2026 10:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant