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: Obsidian MCP Server

クイックスタート（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 を渡してください。

環境

このプロセスは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 start

npm 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 を参照してください。