Draft
Conversation
…ateway - Rewrite index.mdx as outcome-driven landing page with dual-audience framing - Add 'When to Use', 'Who This Is For', deployment options, and use case sections - Fix naming: 'Permit MCP Gateway' as primary name, not 'Agent Security' - Rewrite overview.mdx with Security & Trust Model section - Add comparison table vs existing tools (API gateways, IAM platforms) - Add fast 5-minute activation path to Getting Started guide - Add expected results after each setup step - Add mini troubleshooting block for quick start Co-authored-by: Or Weis <[email protected]>
- Add executive summary to architecture page - Add practical investigation examples to audit logs page - Add rollout guidance section to host setup page - Fix 'Agent Security' → 'Permit MCP Gateway' naming across all pages - Rewrite advanced features with claims hygiene and maturity indicators - Soften unverified claims (anomaly detection, shadow detection, sub-ms decisions) - Add feature maturity summary table to advanced features Co-authored-by: Or Weis <[email protected]>
…nippet names Co-authored-by: Or Weis <[email protected]>
|
Cursor Agent can help with this pull request. Just |
✅ Deploy Preview for permitio-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
- Explain that Permit.io is the control plane and default data plane - Clarify every Host maps 1:1 to a Permit Environment - Document the full power of Permit policies available through the connection - Explain the two-dashboard model: app.permit.io vs app.agent.security - Add control plane / data plane diagram to architecture page - Expand permit-integration page with relationship overview table - Add 'Built on Permit.io' section to landing page - Update deployment options with SaaS subdomain and PDP details Co-authored-by: Or Weis <[email protected]>
- Describe agentic-native identity mechanism using the MCP protocol - Explain composite identity: delegating human + workflow context + fingerprint - Detail value for policy enforcement: hard-gated tool access, per-workflow policy, drift-triggered reactions, step-up consent - Detail value for auditing: persistent identity, declared vs observed intent, full identity chain, drift history - Detail value for prompt injection protection: baseline fingerprinting, multi-dimensional drift detection, session isolation - Link existing Agent Verification and Intent-Based Access Control sections to Agent Interrogation as their underlying mechanism - Update feature maturity summary table Co-authored-by: Or Weis <[email protected]>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Rewrites and restructures Permit MCP Gateway documentation to improve clarity, accelerate adoption for developers, and enhance credibility for security teams.
Changes
Landing Page (
index.mdx) — Complete Rewrite*.agent.security) and customer-controlledOverview Page (
overview.mdx) — Major RewriteGetting Started (
guide.mdx) — Fast Activation PathArchitecture Page — Executive Summary + Control Plane
Permit.io Integration Page — Connection Explanation
Audit Logs — Investigation Examples
Host Setup — Rollout Guidance
Advanced Features — Agent Interrogation + Claims Hygiene
Naming Consistency — All Files
permit-mcp-gateway