NicoChatNicoChatDocumentaçãoBuscar na documentação…
Entrar
MCP de NicoChat/Claude Code - Conectar el MCP

Claude Code - Conectar el MCP

Un comando en la terminal registra el servidor; la autorización ocurre en el navegador en la primera sesión.

2026-09-08

En Claude Code, el servidor de NicoChat se agrega con un único comando y se autoriza desde la propia terminal. Después de eso, cualquier sesión de Claude Code en ese ámbito tiene las herramientas de NicoChat disponibles, y puedes combinar la operación de la cuenta con el trabajo en código: por ejemplo, leer un flujo del canal y generar su documentación en tu repositorio.

Antes de empezar

  • URL del servidor: https://mcp.nicochat.com/mcp. Es la única información que pide el cliente; no existe clave de API para copiar.
  • Cuenta de NicoChat con workspace en plan pago o de prueba, y tú como propietario o administrador de ella.
  • Claude Code instalado y autenticado (claude abre en la terminal).

Paso a paso

1
Registra el servidor
En la terminal, ejecuta el comando de abajo. El transporte es HTTP y el nombre nicochat es como el servidor va a aparecer en las herramientas.
2
Autoriza
Abre Claude Code y escribe /mcp. Selecciona nicochat y elige autenticar: el navegador abre la página de autorización de NicoChat. Inicia sesión, elige permisos y vigencia y confirma.
3
Confirma
De vuelta en la terminal, /mcp muestra el servidor como conectado y lista las herramientas disponibles, que aparecen con el prefijo mcp__nicochat__.
bash
claude mcp add --transport http nicochat https://mcp.nicochat.com/mcp

Ámbito de la configuración

Por defecto el servidor queda en el ámbito local, válido solo para el proyecto actual. Para tenerlo en todos los proyectos, agrega --scope user. Para compartirlo con el equipo a través del repositorio, usa --scope project: eso guarda un archivo .mcp.json en la raíz, y cada persona hace su propia autorización.

bash
claude mcp add --transport http --scope user nicochat https://mcp.nicochat.com/mcp

La pantalla de autorización

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 vigencia de la conexión: 1, 7, 30 o 90 días, o sin expiración. Las herramientas que ve el asistente dependen de lo que hayas marcado 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 Claude Code 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 en un flujo queda como borrador hasta que lo publiques en NicoChat.

Aprobación de herramientas
Claude Code pide confirmación antes de cada herramienta de escritura la primera vez. Para operaciones de lectura repetitivas, puedes aprobar "siempre en este proyecto" cuando te pregunte.

Desconectar o revocar

  • En el cliente: ejecuta claude mcp remove nicochat. Si lo registraste en más de un ámbito, indica --scope.
  • 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

Fue registrado antes en otro ámbito. Ejecuta claude mcp list para ver dónde está, y claude mcp remove nicochat en el ámbito correcto antes de agregarlo de nuevo.
Cierra y abre la sesión de Claude Code. Si persiste, elimina y agrega el servidor: el token guardado localmente se descarta y la autorización se rehace.
Copia el enlace que muestra el cliente 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. Verifica el plan y tu rol en el workspace en el panel de NicoChat.
La vigencia elegida en la autorización venció. Reconecta y, si prefieres, elige "sin expiración".