MCP Webhook Server

Servidor MCP (Model Context Protocol) para enviar datos a webhooks via HTTP POST.
Escrito en Python con FastMCP. Diseñado para ejecutarse en Claude Code — accesible local y remotamente.

🚀 Inicio Rápido

cd MCP
pip install -r requirements.txt

🖥️ Modo Local (Claude Desktop o uso personal)

Esta sección está pensada para la comunidad Open Source que desee utilizar este servidor de forma local en su propia máquina.

1. Clonar el repositorio y configurar dependencias

Para usar la herramienta directamente en tu computadora a través de Claude Desktop (la aplicación gráfica) o en una instancia local de Claude Code, primero debes descargar el código fuente y preparar el entorno de Python.

Abre tu terminal y ejecuta:

# Clonar el proyecto
git clone https://github.com/siendomiguel/MCP-Connection.git
cd MCP-Connection/MCP

# (Opcional pero recomendado) Crear un entorno virtual
python -m venv venv
# En Windows: venv\Scripts\activate
# En Mac/Linux: source venv/bin/activate

# Instalar dependencias
pip install -r requirements.txt

2. Configurar en Claude Desktop

Para que el servidor sepa a dónde enviar los datos por defecto, debes configurar la variable de entorno WEBHOOK_URL directamente en la configuración de la aplicación.

Abre el archivo de configuración de Claude Desktop:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

Agrega el siguiente bloque de configuración. Notarás que bajo env tú decides hacia qué webhook se mandarán los datos:

{
  "mcpServers": {
    "webhook-sender": {
      "command": "python",
      "args": ["/ruta/absoluta/a/tu/proyecto/MCP/main.py"],
      "env": {
        "WEBHOOK_URL": "https://hook.us1.make.com/tu-webhook-secreto"
      }
    }
  }
}

Importante: Recuerda cambiar /ruta/absoluta/a/tu/proyecto/MCP/main.py por la ruta real donde clonaste este repositorio y asignar el WEBHOOK_URL válido de N8N, Make.com, Zapier, etc.

Reinicia Claude Desktop y la herramienta send_webhook estará disponible.

🌐 Modo HTTP (Remoto) — Acceso por equipo

Para compartir con compañeros de equipo en cualquier parte del mundo. Como usa FastMCP, funciona nativamente con Server-Sent Events (SSE).

1. Ejecutar el servidor localmente

MCP_TRANSPORT=sse python main.py

(Se levantará por defecto en el puerto 8000).

2. Desplegar (Railway)

Este proyecto ya incluye railway.json y Dockerfile. Solo tienes que conectar tu repositorio a Railway y se detectará automáticamente. Railway asignará el PORT y el Dockerfile ejecutará el servidor en modo SSE.

3. Configurar en el equipo

Para Claude Code: Cada miembro del equipo agrega esto a su .mcp.json para conectarse a la nube:

{
  "mcpServers": {
    "webhook-sender": {
      "type": "url",
      "url": "https://tu-url-de-railway.up.railway.app/sse"
    }
  }
}

⚠️ Importante para Claude Desktop:
A diferencia de Claude Code, la aplicación gráfica Claude Desktop NO soporta conexiones remotas a URLs por el momento (causa que la app muestre el error "Claude Desktop failed to Launch"). Si necesitas usar tu herramienta webhook-sender dentro de Claude Desktop, tendrás que configurarla como un comando local usando python como especificamos en la sección "Modo Local".

📡 Herramienta: send_webhook

Parámetros

Ejemplo de respuesta enviada al webhook

{
  "webhook_url": "https://...",
  "titulo": "Tarea Completada",
  "texto": "Se actualizó la base de datos.",
  "fecha": "20/02/2026",
  "hora": "18:54:00",
  "autor": "Claude Code",
  "fuente": "MCP Webhook Server",
  "timestamp": "2026-02-20T23:54:00.000000"
}

🪝 Hook Automático (Opcional)

Para enviar webhook automáticamente al terminar cada tarea, agrega a ~/.claude/settings.json:

{
  "hooks": {
    "Stop": [{
      "type": "command",
      "command": "WEBHOOK_URL=https://tu-url.com python e:/dev/proyectos/bitfinApp/MCP/scripts/notify_webhook.py"
    }]
  }
}