Famulor

Famulor MCP

Conecta Claude, Codex, Cursor, VS Code y otros clientes MCP a la API completa de la plataforma Famulor, segura para inquilinos.

Endpoint MCP · Configuración de API y MCP · Documentación

Configuración

Agrega el servidor en tu cliente y luego inicia sesión en Famulor y aprueba los permisos de espacio de trabajo solicitados en el navegador. Claude y ChatGPT usan OAuth; no hay clave de API que pegar en su configuración de conectores.

URL del servidor: https://app.famulor.io/mcp es el endpoint canónico. https://mcp.famulor.io/mcp permanece en línea solo para clientes heredados.

claude mcp add --transport http famulor https://app.famulor.io/mcp

https://app.famulor.io/mcp

{
  "mcpServers": {
    "famulor": {
      "type": "http",
      "url": "https://app.famulor.io/mcp"
    }
  }
}

{
  "mcpServers": {
    "famulor": {
      "serverUrl": "https://app.famulor.io/mcp"
    }
  }
}

{
  "servers": {
    "famulor": {
      "type": "http",
      "url": "https://app.famulor.io/mcp"
    }
  }
}

{
  "mcpServers": {
    "famulor": {
      "url": "https://app.famulor.io/mcp"
    }
  }
}

mcpServers:
  - name: famulor
    type: streamable-http
    url: "https://app.famulor.io/mcp"

openclaw mcp add famulor --url https://app.famulor.io/mcp --transport streamable-http --auth oauth
openclaw mcp login famulor

{
  "mcp": {
    "servers": {
      "famulor": {
        "url": "https://app.famulor.io/mcp",
        "transport": "streamable-http",
        "auth": "oauth"
      }
    }
  }
}

hermes mcp add famulor --url https://app.famulor.io/mcp
hermes mcp login famulor

mcp_servers:
  famulor:
    url: "https://app.famulor.io/mcp"
    auth: oauth

{
  "mcpServers": {
    "famulor": {
      "command": "npx",
      "args": ["-y", "famulor-mcp"],
      "env": { "FAMULOR_API_KEY": "your-api-key" }
    }
  }
}

{
  "context_servers": {
    "famulor": {
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://app.famulor.io/mcp"
      ],
      "command": "npx"
    }
  }
}

Qué puedes hacer

Una vez conectado, tu asistente de IA descubre el catálogo público actual de herramientas directamente desde Famulor. El catálogo cubre, entre otras áreas:

Asistentes — crear, actualizar, eliminar agentes de voz de IA · listar voces, idiomas, modelos LLM/multimodales, proveedores TTS/STT · activar webhooks de entrada y de fin de conversación

Historial y llamadas — inspeccionar historial y transcripciones multicanal · hacer y gestionar llamadas

Campañas — crear campañas, gestionar reglas de reintento y ventanas de horas permitidas · iniciar, detener y eliminar

Audiencia — gestionar contactos, etiquetas, segmentos, supresión y membresía de campañas

Bases de conocimiento — crear bases de conocimiento · subir documentos extraídos de sitios web · actualizar / eliminar

Telefonía — números de teléfono, verificación de números, asignaciones y troncales SIP

Mensajería y correo electrónico — flujos de conversación por WhatsApp, Instagram, Messenger, Telegram, Slack, Teams, Discord, Google Chat, X, helpdesk y correo electrónico

WhatsApp — listar remitentes y plantillas · verificar la ventana de sesión de 24 h · enviar mensajes de plantilla o de formato libre

Automatizaciones y operaciones — flujos, rutinas, paneles, integraciones, webhooks, reservas, configuración del espacio de trabajo y administración de cuentas

Pregunta al asistente en lenguaje natural, por ejemplo: "Crea un asistente de ventas en alemán usando GPT-4.1-mini y la voz Susi", "Inicia la campaña #42 y agrega estos 50 clientes potenciales", "Muéstrame todas las llamadas de hoy donde no se alcanzó el objetivo."

Cómo funciona la autenticación

El endpoint canónico implementa descubrimiento OAuth de MCP, código de autorización con PKCE, registro dinámico de clientes y documentos de metadatos de ID de cliente. Tu cliente MCP abre Famulor en un navegador, donde inicias sesión, eliges un espacio de trabajo y apruebas los alcances solicitados. También se aceptan claves de API para clientes servidor a servidor, pero no son la ruta de conectores de Claude o ChatGPT.

Autoalojamiento

El servidor canónico de catálogo completo es parte de la aplicación Famulor y no está implementado por este paquete independiente heredado. El código en este repositorio se conserva para usuarios existentes de autoalojamiento y npm.

Desplegar en Vercel

git clone https://github.com/bekservice/Famulor-MCP.git
cd Famulor-MCP
vercel --prod

Configura estas variables de entorno en el proyecto de Vercel:

Luego apunta tu dominio al despliegue y ya estás en línea. Consulta DEPLOYMENT.md para la guía completa, incluido el modo stdio para usuarios avanzados.

Desarrollo local

npm install
echo "MCP_SECRET=$(openssl rand -hex 32)" > .env
npm run dev:http
# server on http://localhost:8787

# health
curl http://localhost:8787/health

# OAuth metadata
curl http://localhost:8787/.well-known/oauth-authorization-server

Licencia

MIT