Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Las reseñas y las cuentas llegarán en una etapa posterior.
PopNx MCPServidores MCP para quienes usan IA · explicados con palabras sencillas

MCP Server Auth Template

de brunoviccoversión 0.7.0i★ –iSe ejecuta en tu computadora
Nombre en el registroio.github.brunovicco/mcp-server-auth-template

Instalar

Resumen

Descripción del creador (original en inglés)

OAuth 2.1/OIDC resource-server reference for secure MCP authorization

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

  • Conexión: Se ejecuta en tu computadora
  • Transporte: Streamable HTTP
  • Categoría: Otros
  • Debes completar: MCP_SERVER_RESOURCE_SERVER_URL, MCP_SERVER_AUTH_PROVIDER

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

  • Revisiones básicas: 1 de 1 superadas
  • Se ejecuta en tu computadora con los permisos de tu usuario (archivos, red, apps).
  • Debes completar tú: MCP_SERVER_RESOURCE_SERVER_URL, MCP_SERVER_AUTH_PROVIDER, MCP_SERVER_REQUIRED_SCOPES, MCP_SERVER_TRANSPORT_ALLOWED_HOSTS, MCP_SERVER_ENTRA_TENANT_ID, MCP_SERVER_ENTRA_AUDIENCE, MCP_SERVER_ENTRA_APPLICATION_ID_URI, MCP_SERVER_GENERIC_ISSUER_URL, MCP_SERVER_GENERIC_AUDIENCE, MCP_SERVER_GENERIC_JWKS_ALLOWED_ORIGINS

Necesitas

¿Qué app usas?

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en claude_desktop_config.json

{
  "mcpServers": {
    "auth-template": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_SERVER_RESOURCE_SERVER_URL",
        "-e",
        "MCP_SERVER_AUTH_PROVIDER",
        "-e",
        "MCP_SERVER_REQUIRED_SCOPES",
        "-e",
        "MCP_SERVER_TRANSPORT_ALLOWED_HOSTS",
        "-e",
        "MCP_SERVER_ENTRA_TENANT_ID",
        "-e",
        "MCP_SERVER_ENTRA_AUDIENCE",
        "-e",
        "MCP_SERVER_ENTRA_APPLICATION_ID_URI",
        "-e",
        "MCP_SERVER_GENERIC_ISSUER_URL",
        "-e",
        "MCP_SERVER_GENERIC_AUDIENCE",
        "-e",
        "MCP_SERVER_GENERIC_JWKS_ALLOWED_ORIGINS",
        "ghcr.io/brunovicco/mcp-server-auth-template:v0.7.0"
      ],
      "env": {
        "MCP_SERVER_RESOURCE_SERVER_URL": "your-value",
        "MCP_SERVER_AUTH_PROVIDER": "your-value",
        "MCP_SERVER_REQUIRED_SCOPES": "your-value",
        "MCP_SERVER_TRANSPORT_ALLOWED_HOSTS": "your-value",
        "MCP_SERVER_ENTRA_TENANT_ID": "your-value",
        "MCP_SERVER_ENTRA_AUDIENCE": "your-value",
        "MCP_SERVER_ENTRA_APPLICATION_ID_URI": "your-value",
        "MCP_SERVER_GENERIC_ISSUER_URL": "your-value",
        "MCP_SERVER_GENERIC_AUDIENCE": "your-value",
        "MCP_SERVER_GENERIC_JWKS_ALLOWED_ORIGINS": "your-value"
      }
    }
  }
}

Ejecuta esto en tu terminal

claude mcp add auth-template --env MCP_SERVER_RESOURCE_SERVER_URL=your-value --env MCP_SERVER_AUTH_PROVIDER=your-value --env MCP_SERVER_REQUIRED_SCOPES=your-value --env MCP_SERVER_TRANSPORT_ALLOWED_HOSTS=your-value --env MCP_SERVER_ENTRA_TENANT_ID=your-value --env MCP_SERVER_ENTRA_AUDIENCE=your-value --env MCP_SERVER_ENTRA_APPLICATION_ID_URI=your-value --env MCP_SERVER_GENERIC_ISSUER_URL=your-value --env MCP_SERVER_GENERIC_AUDIENCE=your-value --env MCP_SERVER_GENERIC_JWKS_ALLOWED_ORIGINS=your-value -- docker run -i --rm -e MCP_SERVER_RESOURCE_SERVER_URL -e MCP_SERVER_AUTH_PROVIDER -e MCP_SERVER_REQUIRED_SCOPES -e MCP_SERVER_TRANSPORT_ALLOWED_HOSTS -e MCP_SERVER_ENTRA_TENANT_ID -e MCP_SERVER_ENTRA_AUDIENCE -e MCP_SERVER_ENTRA_APPLICATION_ID_URI -e MCP_SERVER_GENERIC_ISSUER_URL -e MCP_SERVER_GENERIC_AUDIENCE -e MCP_SERVER_GENERIC_JWKS_ALLOWED_ORIGINS ghcr.io/brunovicco/mcp-server-auth-template:v0.7.0

Completa los valores vacíos antes de ejecutarlo.

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

{
  "mcpServers": {
    "auth-template": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_SERVER_RESOURCE_SERVER_URL",
        "-e",
        "MCP_SERVER_AUTH_PROVIDER",
        "-e",
        "MCP_SERVER_REQUIRED_SCOPES",
        "-e",
        "MCP_SERVER_TRANSPORT_ALLOWED_HOSTS",
        "-e",
        "MCP_SERVER_ENTRA_TENANT_ID",
        "-e",
        "MCP_SERVER_ENTRA_AUDIENCE",
        "-e",
        "MCP_SERVER_ENTRA_APPLICATION_ID_URI",
        "-e",
        "MCP_SERVER_GENERIC_ISSUER_URL",
        "-e",
        "MCP_SERVER_GENERIC_AUDIENCE",
        "-e",
        "MCP_SERVER_GENERIC_JWKS_ALLOWED_ORIGINS",
        "ghcr.io/brunovicco/mcp-server-auth-template:v0.7.0"
      ],
      "env": {
        "MCP_SERVER_RESOURCE_SERVER_URL": "your-value",
        "MCP_SERVER_AUTH_PROVIDER": "your-value",
        "MCP_SERVER_REQUIRED_SCOPES": "your-value",
        "MCP_SERVER_TRANSPORT_ALLOWED_HOSTS": "your-value",
        "MCP_SERVER_ENTRA_TENANT_ID": "your-value",
        "MCP_SERVER_ENTRA_AUDIENCE": "your-value",
        "MCP_SERVER_ENTRA_APPLICATION_ID_URI": "your-value",
        "MCP_SERVER_GENERIC_ISSUER_URL": "your-value",
        "MCP_SERVER_GENERIC_AUDIENCE": "your-value",
        "MCP_SERVER_GENERIC_JWKS_ALLOWED_ORIGINS": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

{
  "servers": {
    "auth-template": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_SERVER_RESOURCE_SERVER_URL",
        "-e",
        "MCP_SERVER_AUTH_PROVIDER",
        "-e",
        "MCP_SERVER_REQUIRED_SCOPES",
        "-e",
        "MCP_SERVER_TRANSPORT_ALLOWED_HOSTS",
        "-e",
        "MCP_SERVER_ENTRA_TENANT_ID",
        "-e",
        "MCP_SERVER_ENTRA_AUDIENCE",
        "-e",
        "MCP_SERVER_ENTRA_APPLICATION_ID_URI",
        "-e",
        "MCP_SERVER_GENERIC_ISSUER_URL",
        "-e",
        "MCP_SERVER_GENERIC_AUDIENCE",
        "-e",
        "MCP_SERVER_GENERIC_JWKS_ALLOWED_ORIGINS",
        "ghcr.io/brunovicco/mcp-server-auth-template:v0.7.0"
      ],
      "env": {
        "MCP_SERVER_RESOURCE_SERVER_URL": "your-value",
        "MCP_SERVER_AUTH_PROVIDER": "your-value",
        "MCP_SERVER_REQUIRED_SCOPES": "your-value",
        "MCP_SERVER_TRANSPORT_ALLOWED_HOSTS": "your-value",
        "MCP_SERVER_ENTRA_TENANT_ID": "your-value",
        "MCP_SERVER_ENTRA_AUDIENCE": "your-value",
        "MCP_SERVER_ENTRA_APPLICATION_ID_URI": "your-value",
        "MCP_SERVER_GENERIC_ISSUER_URL": "your-value",
        "MCP_SERVER_GENERIC_AUDIENCE": "your-value",
        "MCP_SERVER_GENERIC_JWKS_ALLOWED_ORIGINS": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Este se ejecuta en tu computadora, y ChatGPT solo puede conectarse a servidores en internet. Elige otra app.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Valores que debes completar

  • MCP_SERVER_RESOURCE_SERVER_URL obligatorio env
    Protected-resource URL advertised by this deployment
  • MCP_SERVER_AUTH_PROVIDER obligatorio env
    Authorization-server adapter to use
  • MCP_SERVER_REQUIRED_SCOPES env
    JSON array of baseline delegated OAuth scopes
  • MCP_SERVER_TRANSPORT_ALLOWED_HOSTS env
    Additional exact Host values accepted by the local container transport
  • MCP_SERVER_ENTRA_TENANT_ID env
    Required when MCP_SERVER_AUTH_PROVIDER=entra
  • MCP_SERVER_ENTRA_AUDIENCE env
    Required when MCP_SERVER_AUTH_PROVIDER=entra
  • MCP_SERVER_ENTRA_APPLICATION_ID_URI env
    Required when MCP_SERVER_AUTH_PROVIDER=entra
  • MCP_SERVER_GENERIC_ISSUER_URL env
    Required when MCP_SERVER_AUTH_PROVIDER=generic
  • MCP_SERVER_GENERIC_AUDIENCE env
    Required when MCP_SERVER_AUTH_PROVIDER=generic
  • MCP_SERVER_GENERIC_JWKS_ALLOWED_ORIGINS env
    Optional JSON array of explicitly trusted cross-origin JWKS origins

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 7 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub brunovicco, dueña del repo

  • … Aún sin revisar

    Sigue en mantenimiento

    Todavía no hemos leído este repo en GitHub

  • … Aún sin revisar

    Tiene licencia

    Todavía no hemos leído este repo en GitHub

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Comparado con otros en Otrosi

  • Más estrellas que el 0% de los otros 32655 servidores de esta categoría
  • Publicado en el registro más recientemente que el 47% de los otros 32655 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 100% de los otros 32655 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro MCP Server Auth Template?

Superó 1 de 1 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: MCP_SERVER_RESOURCE_SERVER_URL, MCP_SERVER_AUTH_PROVIDER

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez –, y la última versión (0.7.0) llegó al registro el mes pasado.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Docker en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Spec Driven Development, Remote Desktop Commander, SuperCollider

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Spec Driven Development

de formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Se ejecuta en tu computadora★ 440MITActualizado hace 14 meses
Instalar

Remote Desktop Commander

de desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Se ejecuta en la nube★ 211Actualizado anteayer
Instalar

Make sound with SuperCollider: synths, drums, chords, melodies and soundscapes over OSC.

Se ejecuta en tu computadoraActualizado hoy
Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

mcp-server-auth-template

*Leia em português*

A production-oriented OAuth 2.1 resource-server reference for remote MCP: Microsoft Entra ID and

generic OIDC, exact token/resource validation, fail-closed authorization, progressive scope

challenges, stateless MCP 2026-07-28, and metadata-only OpenTelemetry evidence.

Use this repository when the hard part is not "how do I expose an MCP tool?" but how do I expose it without weakening identity, authorization, transport, and observability boundaries. The server pairs with mcp-client-auth-template for an executable end-to-end reference using synthetic identities and no production credentials.

What this repository proves

The paired executable path validates real resource-server behavior rather than configuration claims:

  • ✅ RFC 9728 Protected Resource Metadata is published by the resource server
  • ✅ RFC 8707 resource binding becomes an exact JWT audience boundary
  • ✅ issuer, signature, expiry, algorithm/key compatibility and caller type fail closed
  • ✅ delegated scopes and Entra application roles remain distinct authorization concepts
  • ✅ 403 insufficient_scope is returned before dispatch for progressive authorization
  • ✅ wrong-audience tokens are rejected with 401, with an explicit token-resource policy that does not depend on MCP SDK defaults
  • ✅ tools/list is filtered per principal and carries only bounded private cache hints
  • ✅ protected tools stay hidden from anonymous catalog discovery
  • ✅ MCP 2026-07-28 stays stateless and does not mint Mcp-Session-Id
  • ✅ generic OIDC and Microsoft Entra ID share one application boundary without provider leakage
  • ✅ W3C trace context reaches the server while OAuth/MCP sensitive values stay out of telemetry
  • ✅ release artifacts, container evidence, SBOMs and provenance are validated by executable gates

For a requirement-by-requirement view of the paired OAuth/MCP behavior, including explicit evidence gaps and discussion topics for the MCP Authorization Interest Group / Tool Scopes Working Group, see the Authorization Implementer Report.

Architecture

flowchart LR

Client["MCP client"] -->|"OAuth 2.1 / OIDC"| AS["Authorization server Entra ID or generic OIDC"] Client -->|"MCP 2026-07-28 resource-bound bearer"| Admission["Transport admission"] Admission --> AuthN["Token verification"] AuthN --> AuthZ["Tool authorization"] AuthZ --> Tools["MCP tools"] Server["This resource server"] --- Admission

Server -->|"OIDC discovery + cached JWKS"| AS Server -.->|"W3C trace context + OTLP"| Collector["OpenTelemetry Collector"] Collector --> Tempo["Tempo"] Tempo --> Grafana["Grafana"]

The authorization server owns login, consent, client registration and token issuance. This repository owns the protected resource: transport admission, metadata publication, access-token verification, request-scoped principal construction, tool authorization and dispatch.

For layer boundaries and the detailed authorization sequence, see Architecture.

5-minute verification

The companion client owns the executable cross-repository reference flow. With both repositories cloned as siblings, verify this server directly from source:

cd ../mcp-client-auth-template

./scripts/run_reference_demo.sh \ --server-root ../mcp-server-auth-template

The flow starts the real server from this checkout plus a deterministic local OIDC provider and proves CIMD-first Authorization Code + PKCE, authenticated whoami, bounded scope step-up, wrong-audience rejection and stateless MCP behavior.

For the observable published-image proof:

cd ../mcp-client-auth-template

./scripts/run_observability_demo.sh --keep

The observable flow verifies one distributed trace across client and server, positive Collector receipt, Tempo retrieval, Grafana provisioning and telemetry privacy assertions.

See Verification guide for the exact evidence boundary.

Visual proof

The terminal proof below is captured from the source-level paired reference flow:

The trace screenshots are captured from a successful observable run and focus on mcp-server-auth-template spans:

Authentication profiles

ProfileIntended useKey behavior
Entra delegatedInteractive enterprise usersValidates scp, tenant/application identifiers, issuer, audience and subject
Entra applicationProvider-specific app-only deploymentsRequires explicit idtyp=app; keeps roles separate from delegated scopes
Generic OIDC delegatedStandards-based interactive clientsValidates issuer/audience/signature/expiry and OAuth scopes
Generic OIDC client credentialsUnattended services in the deterministic pair profileAccepts pre-registered machine tokens and progressive OAuth scopes

Set MCP_SERVER_AUTH_PROVIDER=entra or generic to switch adapters. The example whoami tool returns the verified caller identity; health requires the additional mcp:tools:health scope and demonstrates a pre-dispatch 403 insufficient_scope challenge.

Quick start

Prerequisites: Python 3.13 or 3.14 and uv.

git clone https://github.com/brunovicco/mcp-server-auth-template.git

cd mcp-server-auth-template cp .env.example .env uv sync --frozen --all-groups uv run uvicorn mcp_server_auth_template.entrypoints.mcp_server:create_app --factory --reload

Configure either the Entra or generic-OIDC block in .env, then point an MCP client at http://localhost:8000/mcp.

EndpointPurposeAuthentication
/mcpMCP Streamable HTTPBearer token
/.well-known/oauth-protected-resourceAuthorization-server discovery metadataPublic
/livezProcess livenessPublic, minimal response
/readyzMCP lifespan readinessPublic, minimal response

For production-style execution:

uv run python -m mcp_server_auth_template.entrypoints.serve

See Production operations before exposing the service outside loopback.

Official MCP Registry

The server is published in the Official MCP Registry as:

io.github.brunovicco/mcp-server-auth-template@0.7.0

server.json describes the public GHCR image as an OCI package using the real streamable-http transport; it does not claim a hosted remotes endpoint. Publication is gated by the secure release pipeline and a dedicated Registry workflow that validates the immutable image, ownership metadata, and persisted Registry responses before publication.

See Official MCP Registry and the Authorization Implementer Report.

Security properties

The implementation is deliberately fail closed:

  • exact issuer and audience validation, bounded clock checks, algorithm/key compatibility and cached JWKS refresh;
  • an explicit validate_token_resource=False policy: provider audiences (Entra API client ID, api:// identifiers) are enforced by the token verifier, never by SDK URL string equality (ADR-0027);
  • principal-dependent discovery results are never shareable across authorization contexts (ADR-0028);
  • hardened discovery/JWKS egress against unsafe schemes, redirects, compression, oversized bodies, private/reserved destinations, mixed DNS answers and DNS rebinding;
  • Host, Origin, header, envelope, body-size and concurrency admission before authentication and tool dispatch;
  • delegated and application identities remain distinct; extension negotiation never grants authorization by itself;
  • bearer tokens and decoded claims remain request-local and are never logged or persisted;
  • tracing excludes credentials, arbitrary headers and URLs, MCP arguments/results, bodies, baggage and exception text.

This is a transparent reference implementation, not a security certification. Read Privacy and data handling and the architecture decisions under docs/adr/ before adapting the boundary.

MCP 2026-07-28

Baseline: MCP specification 2026-07-28 and MCP Python SDK >=2.2,<3.

The paired templates exercise the modern stateless profile as executable behavior:

  • server/discover and per-request _meta carry protocol version, client identity and capabilities without the legacy initialize / initialized handshake;
  • modern requests use MCP-Protocol-Version, Mcp-Method and Mcp-Name;
  • responses do not mint Mcp-Session-Id;
  • Protected Resource Metadata drives authorization-server discovery;
  • RFC 8707 resource binds the access token audience exactly;
  • server/discover and tools/list carry SEP-2549 cache hints (ttlMs=30000, cacheScope=private);
  • runtime 403 insufficient_scope preserves prior grants and permits only one bounded replay of the undispatched operation;
  • machine-to-machine access is opt-in through io.modelcontextprotocol/oauth-client-credentials.

See Compatibility and the companion client's cross-repository E2E evidence.

Observability

a2a-otel-kit continues W3C trace context at the MCP ASGI boundary. Export remains network-silent unless A2A_OTEL_ENABLED=true and a complete OTLP traces endpoint are configured. Spans are metadata-only and sit inside hardened HTTP admission but outside authentication and tool dispatch.

See LLM and application observability.

Engineering evidence

  • deterministic quality gate covering lint, format, strict Mypy, architecture, tests/coverage, Bandit, dependency audit, supply-chain controls, governance and vendored contract validation;
  • SHA-pinned GitHub Actions with read-only permissions by default and isolated release authorities;
  • CycloneDX source/runtime inventories, complete vulnerability evidence and fail-closed exception policy;
  • allowlisted byte-reproducible Python release artifacts with SHA-256 manifests and GitHub build provenance;
  • policy-approved GHCR publication with immutable digest, provenance and SBOM attestations;
  • Python 3.13/3.14 against MCP SDK 2.2.0 and latest compatible 2.x, with MCP SDK deprecation warnings promoted to test failures so MCP 3 breakage surfaces early;
  • offline JWT fixtures using local keys and synthetic identities;
  • ADRs documenting security, protocol, operations, compatibility, observability and supply-chain decisions.

Demo vs production

Reference evidenceProduction adoption
Synthetic local OIDC in companion demoEnterprise authorization server with reviewed registration and consent

| Loopback/local reference networking | TLS-protected servic

Solo se muestra el principio; lee el resto en el repo

Pregunta a PopNx