Conectar el servidor MCP de Omnifox a Claude Desktop, Cursor o Continue
Configuración paso a paso del servidor MCP de Omnifox en los clientes de escritorio más usados, con los archivos y las rutas reales de cada uno.
Mira este paso en el video · Probar el servidor MCP con el Inspector
El servidor MCP de Omnifox corre en tu equipo mediante npx, así que no hay nada que instalar a mano: basta con declararlo en el archivo de configuración de tu cliente de IA y reiniciarlo.
Antes de empezar
- Plan con Acceso a API (desde Crece).
- Node.js 18.17 o superior instalado (
node -vpara comprobarlo). - Una clave de API creada en Configuración → Desarrollo → API Keys. Cópiala en el momento de crearla: solo se muestra una vez.
Claude Desktop
- Abre el archivo
claude_desktop_config.json:- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
- Agrega el bloque
omnifoxdentro demcpServers:
{
"mcpServers": {
"omnifox": {
"command": "npx",
"args": ["-y", "@omnifox/mcp-server"],
"env": {
"OMNIFOX_API_KEY": "tu-token-aqui"
}
}
}
}
- Guarda el archivo y cierra y vuelve a abrir Claude Desktop por completo.
Cursor
- En la raíz de tu proyecto crea o edita
.cursor/mcp.json. - Usa exactamente el mismo bloque
mcpServersdel ejemplo anterior. - Reinicia Cursor.
Continue
- Edita
~/.continue/config.json. - Agrega el servidor bajo
experimental.modelContextProtocolServers:
{
"experimental": {
"modelContextProtocolServers": [
{
"transport": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@omnifox/mcp-server"],
"env": { "OMNIFOX_API_KEY": "tu-token-aqui" }
}
}
]
}
}
- Reinicia Continue.
Verificación
Pídele a tu asistente algo simple que obligue a usar una herramienta, por ejemplo: "lista los canales conectados en Omnifox". Si responde con tus canales reales, la conexión funciona. La primera llamada puede tardar unos segundos porque npx descarga el paquete.
Si algo no funciona
- El cliente no muestra las herramientas: casi siempre falta reiniciar la aplicación por completo, no solo cerrar la ventana.
OMNIFOX_API_KEY is required: el bloqueenvestá mal escrito o el token quedó vacío.- Todas las llamadas dan 401: el token expiró, fue revocado o se copió con espacios al inicio o al final.
- Todas dan 402 o
PLAN_API_ACCESS_REQUIRED: tu plan no incluye Acceso a API. npxno existe: falta Node.js, o el cliente arranca con un PATH que no lo ve; usa la ruta absoluta denpxencommand.
Consejos
- No guardes el token en un archivo que subas a un repositorio:
.cursor/mcp.jsonsuele quedar versionado. - Si trabajas con más de un espacio de trabajo, declara un servidor por espacio con nombres distintos (
omnifox-ventas,omnifox-soporte) y una clave para cada uno.
Artículos relacionados
Artículos relacionados
-
Cómo conectar integraciones y apps externas
Conecta Omnifox con tus herramientas favoritas desde el catálogo de integraciones en pocos pasos.
-
Guía completa de integraciones y API
Integraciones y API a fondo, en 30 capítulos: claves API, llamadas reales, webhooks firmados, n8n, MCP y SDK, todo funcionando de verdad.
-
Integrar Omnifox con Azur, Siigo, Alegra, QuickBooks u otro sistema contable o ERP
Omnifox no tiene hoy un conector nativo con sistemas contables o ERP. Te explicamos cómo conectarlos igual con workflows, el nodo HTTP, n8n, Make, Zapier o la API, con ejemplos.
-
Generar y usar API keys y webhooks
Crea claves de API para acceder a Omnifox por código y configura webhooks para recibir eventos en tiempo real.
-
Introducción a las integraciones (webhook / OAuth / API key)
Conecta Omnifox con tus otras herramientas: qué está disponible hoy, qué llega pronto y cuándo usar un webhook, una conexión OAuth o una clave de API.