AItomation MCP relay
AItomation MCP relay
インバウンドAIコネクタ向けのユーザー管理型HTTPSエッジ。他のアプリは、あなたが所有するアドレスでこのプロセスを呼び出します。お使いのコンピュータ上のアプリは、後でこのプロセスとペアリングしてツールを実行します。このプロセス自体がツールを実行することはありません。
このリポジトリはコネクタプロセスのみです。デスクトップアプリでも、Team Space チームサーバーでもありません。
このドアは当社ではホストしません。管理下のサーバーに配置してください。デスクトップアプリのアップデートでこのプロセスが更新されることはありません。デスクトップの v* タグがこのイメージを公開することもありません。
1プロセスにつき1プロジェクト
1つのリレーは、1つのデバイスと1つのプロジェクトにのみ通信します。
パブリックHTTPSドアが必要な3つのプロジェクトには、3つのプロセスが必要です。
1つの名前でのパスプレフィックス(
/project-a/mcp)は拒否されます。同じマシン上のTeam Spaceサーバーは4つ目のプロセスです。同じマシンは問題ありません。同じプロセスは不可です。
Related MCP server: VBridge
クイックスタート(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:latestデフォルトのリッスンポートは8790です。8787、8788、8789は使用しないでください。
GET / と GET /health は200を返します。ブラウザには短いステータスページが表示されます。curl や後続のペアプローブ(Accept: text/plain)でも、1行のテキスト AItomation MCP relay が返ります。
POST /mcp は、サインイントークンなしでは401と、well-known JSONを指す WWW-Authenticate ヘッダーを返します。アプリをペアリングしてOAuthを完了すると、そのPOSTはアプリに転送されます。ツールがこのプロセス上で実行されることはありません。ペアリングには /pair/hello、/pair/next、/pair/reply、/pair/unavailable を使用します。
公式イメージはマルチアーキテクチャ(linux/amd64 と linux/arm64)です。本番環境ではバージョンタグを固定することをお勧めします。
パブリックホスト上のパブリック証明書
このコネクタを呼び出すクラウドホスト(ChatGPT、Claude、Grok、Gemini Enterprise)には、パブリック認証局からの証明書が必要です。パブリックホストで自己署名証明書を使用しないでください。このプロセスの前にパブリック証明書を持つリバースプロキシを配置するか、その認証局から取得済みの MCP_RELAY_TLS_CERT_FILE と MCP_RELAY_TLS_KEY_FILE を渡してください。
環境
名前 | デフォルト | 備考 |
|
| Dockerは |
|
| 予約ポートは拒否されます。 |
|
| サービス管理下では絶対パスを使用してください。 |
| 未設定 | ペアシークレットはenvに保持し、argvには決して入れないでください。 |
| 未設定 | パブリックhttpsオリジン(オプションの |
| 未設定 | オプション。ペアリングしたプロジェクトのClaudeリクエストヘッダーキーのSHA-256 hex。 |
| 未設定 | オプション。パブリックホスト用のパブリックCA。 |
| 未設定 | 証明書ファイルと対で使用します。 |
このプロセスはTeam Spaceの環境名を読み取りません。
OAuthはポート8790に留まります。認可URLは /authorize です。トークンURLは /token です。スコープに offline_access を含めてください。Gemini Enterpriseは、初回起動時に発行される機密クライアントID(シークレットはデータディレクトリの下に一度だけ書き込まれます)とリダイレクト https://vertexaisearch.cloud.google.com/oauth-redirect を使用します。well-known JSON は /.well-known/oauth-protected-resource と /.well-known/oauth-protected-resource/mcp にあります。これらのパスにはHTMLのキャッチオールはありません。
代替(クローン + npm)
git clone https://github.com/stanislavmandrik621/aitomation-mcp-relay.git
cd aitomation-mcp-relay
npm ci
npm startnpm start は開発用です。実際のサービスでは、一度ビルド(npm run build)して、サービス管理下で node dist/server.js を実行してください。
ステップバイステップのサービスユニット、3プロジェクト構成、HTTPSプロキシスニペット: docs/SELF-HOST.md。
停止
SIGTERMまたはSIGINTは新しい作業を停止し、進行中の POST /mcp 転送が完了するのを待ってから終了します。プロセスはPOSTの途中で自分自身を終了させません。
情報源
日々の編集はAItomationモノレポの packages/mcp-relay にあり、顧客向けにここに公開されています。公式GHCR書き込みはこのリポジトリの publish-image ワークフローです。デスクトップカットはこの画像を公開しません。
ライセンス
MIT - 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