AItomation MCP relay
AItomation MCP relay
Benutzergehostete HTTPS-Schnittstelle für eingehende KI-Konnektoren. Andere Apps rufen diesen Prozess über eine Adresse auf, die Ihnen gehört. Die App auf Ihrem Computer koppelt sich später mit ihm und führt die Tools aus. Dieser Prozess führt selbst nie Tools aus.
Dieses Repository ist nur der Konnektor-Prozess. Es ist weder die Desktop-App noch der Team-Space-Teamserver.
Wir hosten diese Tür nicht für Sie. Platzieren Sie sie auf einem Server, den Sie kontrollieren. Ein Desktop-App-Update aktualisiert diesen Prozess nicht. Ein Desktop-v*-Tag veröffentlicht dieses Image nicht.
Ein Prozess, ein Projekt
Ein Relay spricht mit einem Gerät und einem Projekt.
Drei Projekte, die eine öffentliche HTTPS-Tür benötigen, brauchen drei Prozesse.
Pfadpräfixe auf einem Namen (
/project-a/mcp) werden abgelehnt.Der Team-Space-Server auf derselben Maschine ist ein vierter Prozess. Dieselbe Maschine ist in Ordnung. Derselbe Prozess nicht.
Related MCP server: VBridge
Schnellstart (Docker)
docker pull ghcr.io/stanislavmandrik621/aitomation-mcp-relay:latest
docker run --rm -p 8790:8790 \
-e MCP_RELAY_HOST=0.0.0.0 \
-e MCP_RELAY_PORT=8790 \
-e MCP_RELAY_DATA_DIR=/data \
-v mcp-relay-data:/data \
ghcr.io/stanislavmandrik621/aitomation-mcp-relay:latestStandard-Listenport ist 8790. Verwenden Sie nicht 8787, 8788 oder 8789.
GET / und GET /health antworten mit 200. Ein Browser zeigt eine kurze Statusseite. curl und eine spätere Pair-Sonde (Accept: text/plain) erhalten weiterhin den einzeiligen Text AItomation MCP relay.
POST /mcp ohne Anmeldetoken gibt 401 plus einen WWW-Authenticate-Header zurück, der auf das bekannte JSON verweist. Nachdem Sie die App gekoppelt und OAuth abgeschlossen haben, wird dieser POST an die App weitergeleitet. Tools laufen nie auf diesem Prozess. Das Pairing verwendet /pair/hello, /pair/next, /pair/reply und /pair/unavailable.
Offizielle Images sind Multi-Arch (linux/amd64 und linux/arm64). Bevorzugen Sie in Produktion das Pinnen einer Versions-Tag.
Öffentliches Zertifikat auf einem öffentlichen Host
Cloud-Hosts, die diesen Konnektor aufrufen (ChatGPT, Claude, Grok, Gemini Enterprise), benötigen ein Zertifikat von einer öffentlichen Zertifizierungsstelle. Verwenden Sie kein selbst erstelltes Zertifikat auf einem öffentlichen Host. Platzieren Sie einen Reverse-Proxy mit einem öffentlichen Zertifikat vor diesem Prozess oder übergeben Sie MCP_RELAY_TLS_CERT_FILE und MCP_RELAY_TLS_KEY_FILE, die bereits von dieser Zertifizierungsstelle stammen.
Umgebung
Name | Standard | Hinweise |
|
| Docker setzt |
|
| Reservierte Ports werden abgelehnt. |
|
| Verwenden Sie einen absoluten Pfad unter einem Dienstmanager. |
| nicht gesetzt | Das Pair-Secret bleibt in der Umgebung, nie in argv. |
| nicht gesetzt | Öffentlicher HTTPS-Ursprung (optional |
| nicht gesetzt | Optionaler SHA-256-Hex des Claude-Request-Header-Schlüssels für das gekoppelte Projekt. |
| nicht gesetzt | Optional. Öffentliche Zertifizierungsstelle für einen öffentlichen Host. |
| nicht gesetzt | Paar mit der Zertifikatsdatei. |
Dieser Prozess liest keine Team-Space-Umgebungsnamen.
OAuth bleibt auf Port 8790. Autorisierungs-URL ist /authorize. Token-URL ist /token. Fügen Sie offline_access in die Scopes ein. Gemini Enterprise verwendet die vertrauliche Client-ID, die beim ersten Start geprägt wird (Secret wird einmal unter dem Datenverzeichnis geschrieben) und die Weiterleitung https://vertexaisearch.cloud.google.com/oauth-redirect. Bekanntes JSON befindet sich unter /.well-known/oauth-protected-resource und /.well-known/oauth-protected-resource/mcp. Es gibt kein HTML-Catch-all auf diesen Pfaden.
Alternative (Klon + npm)
git clone https://github.com/stanislavmandrik621/aitomation-mcp-relay.git
cd aitomation-mcp-relay
npm ci
npm startnpm start ist für die Entwicklung. Für einen echten Dienst bauen Sie einmal (npm run build) und führen node dist/server.js unter einem Dienstmanager aus.
Schritt-für-Schritt-Diensteinheit, Drei-Projekt-Compose und HTTPS-Proxy-Ausschnitte: docs/SELF-HOST.md.
Stopp
SIGTERM oder SIGINT stoppt neue Arbeit, wartet auf laufende POST /mcp-Weiterleitungen und beendet dann. Der Prozess beendet sich nicht mitten im POST.
Quelle der Wahrheit
Tägliche Änderungen leben im AItomation-Monorepo packages/mcp-relay und werden hier für Kunden veröffentlicht. Offizieller GHCR-Write ist der publish-image-Workflow dieses Repos. Der Desktop-Schnitt veröffentlicht dieses Image nicht.
Lizenz
MIT – siehe LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Zero-setup MCP gateway securely connecting AI to your tools with authentication and workflows
Connect AI clients to your Dactic work context through a hosted MCP service.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Connect any AI agent to 1,000+ apps and 27,000+ actions through one remote MCP server (OAuth).
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceEnables local programs to push text and images to AI assistants via HTTP and retrieve AI-generated responses, acting as a local data bridge between your code and MCP-capable AI tools.-
- AlicenseNot gradedqualityCmaintenanceEnables authorized remote MCP clients to securely reach local Mac or Windows tools over OAuth, including shell commands, file read/write, background jobs, screenshots, UI control, and clipboard access. It can also expose configured Desktop MCP servers and optional Claude Code task delegation.MIT
- AlicenseNot gradedqualityAmaintenanceEnables web-based AI chat clients to securely operate a local computer through an OAuth-gated MCP endpoint, exposing governed tools for files, shell, search, Git, SQLite, browser automation, DevTools, background tasks, localhost services, clipboard, notifications, ports, Postman, and AIObox windows.MIT
- AlicenseNot gradedqualityCmaintenanceExposes explicitly approved local Windows stdio and loopback HTTP MCP backends through a single OAuth-protected remote HTTPS MCP endpoint, letting a mobile AI client invoke whitelisted tools with namespacing, PKCE-based authorization, and per-tool permissions.MIT