Declara el servidor en mcp_config.json y autoriza desde el panel de MCP de Cascade.
2026-09-08
En Windsurf, los servidores MCP son usados por Cascade. NicoChat entra en mcp_config.json como servidor remoto por URL; después de actualizar la lista, Windsurf muestra el botón de inicio de sesión y abre el navegador para la autorización en NicoChat.
Antes de comenzar
URL del servidor: https://mcp.nicochat.com/mcp. Es la única información que el cliente pide; no existe clave de API para copiar.
Cuenta NicoChat con un workspace en plan pago o de prueba, y tú como propietario o administrador de ella.
Windsurf actualizado. Plan con Cascade habilitado.
Paso a paso
1
Abre la configuración de MCP
En Cascade, haz clic en el ícono de MCPs (o ve a Windsurf Settings › Cascade › MCP Servers) y elige Add custom server. Windsurf abre el archivo ~/.codeium/windsurf/mcp_config.json.
2
Declara el servidor
Pega el bloque de abajo y guarda.
3
Actualiza la lista
De vuelta en el panel de MCP, haz clic en Refresh. NicoChat aparece pidiendo inicio de sesión.
4
Autoriza
Haz clic en Login: el navegador abre la autorización de NicoChat. Inicia sesión, elige permisos y validez y confirma. El servidor pasa a listar las herramientas.
5
Úsalo en Cascade
Pídele algo a NicoChat en una conversación de Cascade. Pide confirmación antes de cada herramienta de escritura.
Sea cual sea el cliente, la autorización ocurre en el navegador, en la página de NicoChat. Inicias sesión, eliges los permisos (lectura y análisis siempre se concede; configuración, contactos, integraciones y campañas son opcionales) y la validez de la conexión: 1, 7, 30 o 90 días, o sin expiración. Las herramientas que el asistente ve dependen de lo que marcaste aquí — para ampliar después, basta con reconectar.
Empieza solo con lectura
En la primera conexión, concede solo lectura y análisis y pide un diagnóstico de tus canales. Cuando te sientas cómodo con lo que hace el asistente, reconecta concediendo configuración o contactos.
Primeras solicitudes para probar
Con la conexión hecha, pídele a Cascade en lenguaje natural. Algunos ejemplos que usan solo lectura:
"Lista mis workspaces y los canales de cada uno."
"¿Cuántos contactos entraron en el canal de WhatsApp en los últimos 7 días y cuál es el tiempo promedio de primera respuesta?"
"Resume la estructura del canal X: flujos, disparadores, agentes de IA y tableros kanban."
"¿Qué palabras clave están configuradas en el canal X y a dónde lleva cada una?"
Si concediste configuración, el asistente también crea flujos, disparadores, tags y agentes de IA. Todo lo que crea dentro de un flujo queda como borrador hasta que lo publiques en NicoChat.
Límite de herramientas
Windsurf limita el total de herramientas activas entre todos los servidores. Si tienes otros servidores, apaga los que no estés usando, o conéctate a NicoChat solo con los permisos que necesitas.
Desconectar o revocar
En el cliente: elimina el bloque nicochat del mcp_config.json y haz clic en Refresh, o apaga el servidor en el panel de MCP.
En NicoChat: en Configuración de la Cuenta, revoca la autorización. El efecto es inmediato, aunque el servidor siga registrado en el cliente.
Problemas comunes
Verifica que el JSON sea válido y que la clave usada sea serverUrl. Haz clic en Refresh después de corregir.
Actualiza Windsurf. En versiones antiguas, los servidores remotos con OAuth no eran soportados.
Copia el enlace que el cliente muestra y ábrelo manualmente. Si no muestra ningún enlace, elimina el servidor y agrégalo de nuevo: el registro del cliente en NicoChat se rehace en el primer acceso.
Es lo esperado cuando solo se concedió el permiso de lectura. Desconecta y conecta de nuevo marcando los permisos de escritura que necesitas.
El servidor solo opera en workspaces en plan pago o de prueba en los que eres propietario o administrador. Revisa el plan y tu rol en el workspace en el panel de NicoChat.
La validez elegida en la autorización venció. Reconecta y, si prefieres, elige "sin expiración".
