AItomation MCP relay

Borde HTTPS alojado por el usuario para conectores entrantes de IA. Otras aplicaciones llaman a este proceso en una dirección que posees. La aplicación de tu ordenador se empareja con él más tarde y ejecuta las herramientas. Este proceso nunca ejecuta herramientas por sí mismo.

Este repositorio es solo el proceso conector. No es la aplicación de escritorio ni el servidor de equipo de Team Space. Nosotros no alojamos esta puerta por ti. Colócala en un servidor que controles. Una actualización de la aplicación de escritorio no actualiza este proceso. Una etiqueta v* de escritorio no publica esta imagen.

Un proceso, un proyecto

Un relay se comunica con un dispositivo y un proyecto.

• Tres proyectos que necesitan una puerta HTTPS pública necesitan tres procesos.

• No se admiten prefijos de ruta en un mismo nombre (/project-a/mcp).

• El servidor de Team Space en la misma máquina es un cuarto proceso. La misma máquina está bien. El mismo proceso no.

Related MCP server: omp A2A Bridge

Inicio rápido (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

El puerto de escucha predeterminado es 8790. No uses 8787, 8788 ni 8789.

GET / y GET /health responden 200. Un navegador muestra una breve página de estado. curl y una sonda de emparejamiento posterior (Accept: text/plain) siguen obteniendo el texto de una línea AItomation MCP relay.

POST /mcp sin un token de inicio de sesión devuelve 401 y una cabecera WWW-Authenticate que apunta al JSON well-known. Después de emparejar la aplicación y completar OAuth, ese POST se reenvía a la aplicación. Las herramientas nunca se ejecutan en este proceso. El emparejamiento usa /pair/hello, /pair/next, /pair/reply y /pair/unavailable.

Las imágenes oficiales son multi-arquitectura (linux/amd64 y linux/arm64). Prefiere fijar una etiqueta de versión en producción.

Certificado público en un host público

Los hosts en la nube que llaman a este conector (ChatGPT, Claude, Grok, Gemini Enterprise) necesitan un certificado de una autoridad de certificación pública. No uses un certificado autofirmado en un host público. Pon un proxy inverso con un certificado público delante de este proceso, o pasa MCP_RELAY_TLS_CERT_FILE y MCP_RELAY_TLS_KEY_FILE que ya provengan de esa autoridad.

Entorno

Este proceso no lee los nombres de variables de entorno de Team Space.

OAuth permanece en el puerto 8790. La URL de autorización es /authorize. La URL del token es /token. Incluye offline_access en los ámbitos. Gemini Enterprise usa el identificador de cliente confidencial generado en el primer arranque (el secreto se escribe una vez en el directorio de datos) y la redirección https://vertexaisearch.cloud.google.com/oauth-redirect. El JSON well-known está en /.well-known/oauth-protected-resource y /.well-known/oauth-protected-resource/mcp. No hay un comodín HTML en esas rutas.

Alternativa (clonar + npm)

git clone https://github.com/stanislavmandrik621/aitomation-mcp-relay.git
cd aitomation-mcp-relay
npm ci
npm start

npm start es para desarrollo. Para un servicio real, compila una vez (npm run build) y ejecuta node dist/server.js bajo un gestor de servicios.

Fragmentos paso a paso para una unidad de servicio, un compose de tres proyectos y un proxy HTTPS: docs/SELF-HOST.md.

Detener

SIGTERM o SIGINT detiene el trabajo nuevo, espera a que terminen los reenvíos POST /mcp en curso y luego sale. El proceso no se mata a sí mismo a medias de un POST.

Fuente de la verdad

Las ediciones del día a día viven en el monorepo de AItomation packages/mcp-relay y se publican aquí para los clientes. El push oficial a GHCR es el flujo de trabajo publish-image de este repositorio. La versión de escritorio no publica esta imagen.

Licencia

MIT - consulta LICENSE.