Desplegar AnythingMCP en Heroku

Requisitos Previos

• Una cuenta de Heroku con un método de pago verificado
• Heroku CLI instalado
• Git y Docker instalados localmente

Crear una Aplicación en Heroku

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp
heroku create your-app-name

Añadir Heroku Postgres

heroku addons:create heroku-postgresql:essential-0

Heroku establece DATABASE_URL automáticamente. Verifica con:

heroku config:get DATABASE_URL

Nota: Heroku tiene un sistema de archivos efímero. Todos los datos persistentes deben almacenarse en Postgres.

Establecer Variables de Entorno

Genera secretos y configura la aplicación:

heroku config:set \
  JWT_SECRET=$(openssl rand -hex 32) \
  ENCRYPTION_KEY=$(openssl rand -hex 16) \
  NEXTAUTH_SECRET=$(openssl rand -hex 32) \
  NODE_ENV=production \
  PORT=4000 \
  MCP_AUTH_MODE=oauth2

Establece las URLs para que coincidan con tu dominio de Heroku:

heroku config:set \
  CORS_ORIGIN=https://your-app-name.herokuapp.com \
  SERVER_URL=https://your-app-name.herokuapp.com \
  FRONTEND_URL=https://your-app-name.herokuapp.com \
  NEXT_PUBLIC_API_URL=https://your-app-name.herokuapp.com

Desplegar con Stack de Contenedor

Establece el stack a contenedor:

heroku stack:set container

Crea heroku.yml en la raíz del proyecto:

build:
  docker:
    web: Dockerfile

Despliega:

git add heroku.yml
git commit -m "añadir heroku.yml para despliegue de contenedor"
git push heroku main

Monitorea la construcción:

heroku logs --tail

Dominio Personalizado y SSL

Heroku proporciona SSL automático en *.herokuapp.com. Para un dominio personalizado:

heroku domains:add mcp.example.com

Crea un registro CNAME en tu proveedor de DNS:

Actualiza las URLs:

heroku config:set \
  CORS_ORIGIN=https://mcp.example.com \
  SERVER_URL=https://mcp.example.com \
  FRONTEND_URL=https://mcp.example.com \
  NEXT_PUBLIC_API_URL=https://mcp.example.com

Verificar y Próximos Pasos

curl https://your-app-name.herokuapp.com/health
heroku open

El primer usuario en registrarse se convierte en administrador.

Tu endpoint MCP: https://your-app-name.herokuapp.com/mcp

Comandos útiles:

heroku logs --tail   # Transmitir logs
heroku ps            # Estado del dyno
heroku config        # Variables de entorno
heroku restart       # Reiniciar la aplicación