Gemini CLI - Conectar el MCP
Declara el servidor en settings.json con OAuth activado y autentícate con el comando /mcp auth.
En Gemini CLI, el servidor de NicoChat se declara en el archivo settings.json con transporte HTTP y OAuth habilitado. En la primera sesión, el comando /mcp auth abre el navegador para la autorización en NicoChat, y el token queda guardado localmente para las siguientes.
- URL del servidor:
https://mcp.nicochat.com/mcp. Es la única información que pide el cliente; no hay clave de API que copiar. - Cuenta de NicoChat con un workspace en plan pago o de prueba, y tú como propietario o administrador de él.
- Gemini CLI instalado y autenticado (
geminiabre en la terminal).
~/.gemini/settings.json (configuración del usuario) o .gemini/settings.json en la raíz del proyecto (solo ese proyecto). Agrega el bloque de abajo en mcpServers.gemini. Escribe /mcp para listar los servidores: NicoChat aparece pidiendo autenticación./mcp auth nicochat. El navegador abre la página de autorización de NicoChat. Inicia sesión, elige permisos y validez, y confirma./mcp muestra el servidor conectado y la lista de herramientas.{
"mcpServers": {
"nicochat": {
"httpUrl": "https://mcp.nicochat.com/mcp",
"oauth": {
"enabled": true
}
}
}
}También es posible registrarlo por línea de comandos, sin editar el archivo a mano:
gemini mcp add --transport http nicochat https://mcp.nicochat.com/mcpEn ese caso, verifica que el bloque generado haya quedado con oauth.enabled en true; sin eso Gemini CLI no inicia la 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 validez 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 marques aquí — para ampliar después, basta con reconectar.
Con la conexión hecha, pídele a Gemini 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.
- En el cliente: quita el bloque
nicochatdelsettings.json, o ejecutagemini mcp remove nicochat. El token local está en~/.gemini/mcp-oauth-tokens.jsony se puede borrar. - En NicoChat: en Configuración de la Cuenta, revoca la autorización. El efecto es inmediato, aunque el servidor siga registrado en el cliente.
oauth.enabled esté en true y que la clave usada sea httpUrl, no url. Después ejecuta /mcp auth nicochat.