# 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
```bash
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:
```bash
# 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:
```json
{
"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
```bash
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:
```json
{
"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
| Campo | Tipo | Requerido | Descripción |
|-------|------|-----------|-------------|
| `url` | string | ✅ | URL del webhook destino (o configurar WEBHOOK_URL) |
| `titulo` | string | ✅ | Título de la tarea/evento |
| `texto` | string | ✅ | Descripción o resumen |
| `autor` | string | ❌ | Default: "Claude Code" |
| `fuente` | string | ❌ | Default: "MCP Webhook Server" |
| `campos_extra` | object | ❌ | Campos personalizados clave-valor |
| `headers` | object | ❌ | Headers HTTP adicionales |
### Ejemplo de respuesta enviada al webhook
```json
{
"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`:
```json
{
"hooks": {
"Stop": [{
"type": "command",
"command": "WEBHOOK_URL=https://tu-url.com python e:/dev/proyectos/bitfinApp/MCP/scripts/notify_webhook.py"
}]
}
}
```
