---
id: 9560
title: Create Comprehensive Guide for MCP Server Authorization
state: CLOSED
labels:
  - documentation
  - developer-experience
  - ai
assignees:
  - tobiu
createdAt: '2026-03-26T13:39:25Z'
updatedAt: '2026-03-26T14:07:24Z'
githubUrl: 'https://github.com/neomjs/neo/issues/9560'
author: tobiu
commentsCount: 0
parentIssue: null
subIssues: []
subIssuesCompleted: 0
subIssuesTotal: 0
blockedBy: []
blocking: []
closedAt: '2026-03-26T14:06:31Z'
---
# Create Comprehensive Guide for MCP Server Authorization

Create a new guide in `learn/guides/ai/McpAuthorization.md` detailing the security architecture of the Neo.mjs AI infrastructure.

**Content:**
- Overview of the MCP authorization model (OAuth 2.1).
- Step-by-step configuration for `knowledge-base` and `memory-core` using OIDC.
- Keycloak integration examples.
- Discussion of the unique security considerations for the Neural Link.
- Troubleshooting common auth errors (audience/scope mismatches).

## Timeline

- 2026-03-26T13:39:27Z @tobiu added the `documentation` label
- 2026-03-26T13:39:27Z @tobiu added the `developer-experience` label
- 2026-03-26T13:39:27Z @tobiu added the `ai` label
- 2026-03-26T14:06:10Z @tobiu referenced in commit `6cb5ba4` - "Implement OIDC/OAuth 2.1, CORS, and env mapping for MCP servers (#9558, #9560)"
- 2026-03-26T14:06:31Z @tobiu closed this issue
- 2026-03-26T14:07:24Z @tobiu assigned to @tobiu

