ai-tools/private-proxy-mcp
Watch
2
0
Fork
You've already forked private-proxy-mcp
 0
Code Issues 2 Pull requests 1 Projects Releases 5 Packages 2 Wiki Activity Actions

Authentisierung und sichere Exposition des MCP-Endpunkts festlegen #11

New issue
Closed
opened 2026-07-17 09:05:50 +02:00 by frank · 2 comments
frank commented 2026-07-17 09:05:50 +02:00
Owner
Copy link

Teil von #1. Ergänzt den MCP-Streamable-HTTP-Server.

Ziel

Der MCP-Port 9334 ist nicht versehentlich ungeschützt aus dem Internet erreichbar; das MVP hat einen dokumentierten Sicherheitsmodus und einen klaren Pfad zu standardkonformer Remote-Autorisierung.

Scope

  • Sicherer Default: Bindung an 127.0.0.1.
  • Explizite Konfiguration erforderlich, um auf nicht-loopback zu binden.
  • Origin-Allowlist gemäß Streamable-HTTP-Anforderung.
  • Entscheidung dokumentieren:
    • lokaler/privater MVP-Betrieb ohne MCP-Autorisierung hinter einem vertrauenswürdigen Reverse Proxy, oder
    • standardkonforme OAuth-2.1-Resource-Server-Integration.
  • Keine selbst erfundene Bearer-Token-Lösung als angeblich MCP-standardkonforme OAuth-Implementierung.
  • Bei Remote-Exposition TLS erzwingen oder TLS-Terminierung am Reverse Proxy verbindlich dokumentieren.
  • Trust-Proxy-/Forwarded-Header nur für explizit konfigurierte Proxy-Adressen akzeptieren.
  • Optionaler Health-Endpunkt darf keine MCP-, Proxy- oder Secret-Daten offenlegen.
  • OAuth-Unterstützung kann als Folge-Issue umgesetzt werden, muss dann Protected Resource Metadata, Audience Validation und Verbot von Token-Passthrough einhalten.

Akzeptanzkriterien

  • Eine frische Installation exponiert Port 9334 nur auf Loopback.
  • Öffentliche Bindung ohne passende Sicherheitskonfiguration scheitert oder erzeugt eine unübersehbare Warnung gemäß dokumentierter Entscheidung.
  • Origin-Tests decken erlaubt, verboten und fehlend ab.
  • Das Wiki beschreibt unterstützte Deployment-Topologien und deren Vertrauensgrenzen.
  • Es ist ein separates Folge-Issue für OAuth angelegt, falls Remote-OAuth nicht Teil des MVP wird.

Referenzen

Teil von #1. Ergänzt den MCP-Streamable-HTTP-Server. ## Ziel Der MCP-Port 9334 ist nicht versehentlich ungeschützt aus dem Internet erreichbar; das MVP hat einen dokumentierten Sicherheitsmodus und einen klaren Pfad zu standardkonformer Remote-Autorisierung. ## Scope - Sicherer Default: Bindung an 127.0.0.1. - Explizite Konfiguration erforderlich, um auf nicht-loopback zu binden. - Origin-Allowlist gemäß Streamable-HTTP-Anforderung. - Entscheidung dokumentieren: - lokaler/privater MVP-Betrieb ohne MCP-Autorisierung hinter einem vertrauenswürdigen Reverse Proxy, oder - standardkonforme OAuth-2.1-Resource-Server-Integration. - Keine selbst erfundene Bearer-Token-Lösung als angeblich MCP-standardkonforme OAuth-Implementierung. - Bei Remote-Exposition TLS erzwingen oder TLS-Terminierung am Reverse Proxy verbindlich dokumentieren. - Trust-Proxy-/Forwarded-Header nur für explizit konfigurierte Proxy-Adressen akzeptieren. - Optionaler Health-Endpunkt darf keine MCP-, Proxy- oder Secret-Daten offenlegen. - OAuth-Unterstützung kann als Folge-Issue umgesetzt werden, muss dann Protected Resource Metadata, Audience Validation und Verbot von Token-Passthrough einhalten. ## Akzeptanzkriterien - Eine frische Installation exponiert Port 9334 nur auf Loopback. - Öffentliche Bindung ohne passende Sicherheitskonfiguration scheitert oder erzeugt eine unübersehbare Warnung gemäß dokumentierter Entscheidung. - Origin-Tests decken erlaubt, verboten und fehlend ab. - Das Wiki beschreibt unterstützte Deployment-Topologien und deren Vertrauensgrenzen. - Es ist ein separates Folge-Issue für OAuth angelegt, falls Remote-OAuth nicht Teil des MVP wird. ## Referenzen - MCP Transport Security Warning: https://modelcontextprotocol.io/specification/2025-11-25/basic/transports - MCP Authorization: https://modelcontextprotocol.io/specification/2025-11-25/basic/authorization - MCP Security Best Practices: https://modelcontextprotocol.io/docs/tutorials/security/security_best_practices
frank commented 2026-07-17 10:42:09 +02:00
Author
Owner
Copy link

🤖 forge agent started

  • Agent: codex
  • Model: gpt-5.6-sol
  • Mode: pr
  • Trigger: assignee=agent|+5 mapped

Authentisierung und sichere Exposition des MCP-Endpunkts festlegen — Teil von #1. Ergänzt den MCP-Streamable-HTTP-Server.

🤖 **forge agent started** - Agent: `codex` - Model: `gpt-5.6-sol` - Mode: `pr` - Trigger: `assignee=agent|+5 mapped` Authentisierung und sichere Exposition des MCP-Endpunkts festlegen — Teil von #1. Ergänzt den MCP-Streamable-HTTP-Server.
frank commented 2026-07-17 10:43:04 +02:00
Author
Owner
Copy link

❌ forge agent failed

agent branch has no commits ahead of main (empty PR); dirty work must be committed before finish
❌ **forge agent failed** ``` agent branch has no commits ahead of main (empty PR); dirty work must be committed before finish ```
frank closed this issue 2026-07-17 11:44:09 +02:00
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
agent/issue-39-websuche-capability-web-search-über-duc
agent/issue-14-architektur-konfiguration-und-betrieb-im
agent/issue-13-teststrategie-und-forgejo-actions-ci-auf
agent/issue-22-yt-dlp-medien-und-youtube-transcript-too
v1.2.0
v1.1.2
v1.1.1
v1.1.0
v1.0.0
Labels
Clear labels   
agent:done
Managed by forge agent

  
agent:ready
Managed by forge agent

  
agent:working
Managed by forge agent

  
area/browser
Browser-Automation und Browser-Sessions

  
area/cli
CLI und Konfiguration

  
area/http
HTTP-Request-Ausführung und Antwortverarbeitung

  
area/mcp
Model Context Protocol und MCP-Endpunkt

  
area/media
Medien-Downloads und Transkripte

  
area/observability
Logging und Health und Lifecycle

  
area/proxy
Private-Proxy-Prozess und Verbindung

  
area/security
Authentisierung und Sicherheitsrichtlinien

  
area/testing
Tests und Fuzzing und CI

  
area/tunnel
Reverse Connector und Tunnelprotokoll

  
priority/P0
MVP-kritisch oder blockiert den Kernpfad

  
priority/P1
Wichtig für ein belastbares MVP

  
priority/P2
Nachgelagertes Folgefeature

  
type/chore
Engineering und Wartungsaufgabe

  
type/design
Architektur- oder Protokollentscheidung vor Implementierung

  
type/docs
Dokumentation und Wiki

  
type/epic
Übergeordnetes Sammel- oder Lieferumfangs-Issue

  
type/feature
Neue oder erweiterte Produktfunktion

No labels
agent:done
agent:ready
agent:working
area/browser
area/cli
area/http
area/mcp
area/media
area/observability
area/proxy
area/security
area/testing
area/tunnel
priority/P0
priority/P1
priority/P2
type/chore
type/design
type/docs
type/epic
type/feature
Milestone
Clear milestone
No items
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
codex
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Blocks
#1 MVP: Private Proxy MCP – Basisfunktionen und Lieferumfang
ai-tools/private-proxy-mcp
#4 MCP Streamable-HTTP-Server auf Port 9334 implementieren
ai-tools/private-proxy-mcp
#14 Architektur, Konfiguration und Betrieb im Projekt-Wiki dokumentieren
ai-tools/private-proxy-mcp
#15 Folgefeature: Standardkonforme OAuth-2.1-Autorisierung für Remote-MCP
ai-tools/private-proxy-mcp
Depends on
#2 Go-Projekt und Cobra/Viper-CLI grundlegend aufsetzen
ai-tools/private-proxy-mcp
Reference
ai-tools/private-proxy-mcp#11
No description provided.