AItomation MCP 릴레이

인바운드 AI 커넥터를 위한 사용자 호스팅 HTTPS 엣지입니다. 다른 앱들이 사용자가 소유한 주소의 이 프로세스를 호출합니다. 사용자 컴퓨터의 앱이 나중에 페어링되어 도구를 실행합니다. 이 프로세스는 자체적으로 도구를 실행하지 않습니다.

이 저장소는 커넥터 프로세스 전용입니다. 데스크톱 앱도 아니고 Team Space 팀 서버도 아닙니다.

이 도어는 사용자를 위해 호스팅하지 않습니다. 사용자가 제어하는 서버에 배치하세요. 데스크톱 앱 업데이트가 이 프로세스를 업데이트하지 않습니다. 데스크톱 v* 태그가 이 이미지를 게시하지 않습니다.

하나의 프로세스, 하나의 프로젝트

하나의 릴레이가 하나의 디바이스와 하나의 프로젝트에 연결됩니다.

• 공개 HTTPS 도어가 필요한 세 개의 프로젝트는 세 개의 프로세스가 필요합니다.

• 한 이름의 경로 접두사(/project-a/mcp)는 거부됩니다.

• 같은 머신의 Team Space 서버는 네 번째 프로세스입니다. 같은 머신은 괜찮습니다. 같은 프로세스는 안 됩니다.

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)는 여전히 한 줄 텍스트 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에 유지됩니다. Authorization URL은 /authorize입니다. Token URL은 /token입니다. scopes에 offline_access를 포함하세요. Gemini Enterprise는 최초 시작 시 발급된 기밀 클라이언트 ID를 사용합니다(시크릿은 data 디렉터리 아래에 한 번만 기록됨) 그리고 리다이렉트는 https://vertexaisearch.cloud.google.com/oauth-redirect입니다. Well-known JSON은 /.well-known/oauth-protected-resource 및 /.well-known/oauth-protected-resource/mcp에 있습니다. 해당 경로에는 HTML catch-all이 없습니다.

대안 (clone + 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-프로젝트 compose, HTTPS 프록시 스니펫: docs/SELF-HOST.md.

중지

SIGTERM 또는 SIGINT는 새 작업을 중지하고, 진행 중인 POST /mcp 전달이 끝날 때까지 기다린 후 종료합니다. 이 프로세스는 작업 중간에 스스로를 종료하지 않습니다.

진실의 원천

일상적인 편집은 AItomation 모노레포 packages/mcp-relay에서 이루어지며, 고객을 위해 여기에 게시됩니다. 공식 GHCR 쓰기는 이 저장소의 publish-image 워크플로입니다. 데스크톱 컷은 이 이미지를 게시하지 않습니다.

라이선스

MIT - LICENSE 참조.