Ejecutarlo en local con `gig mcp`

El servidor local lo arranca tu asistente de IA en tu propio equipo. Inicia sesión en Gigantics con un correo y una contraseña, y habla con el asistente a través de su entrada y salida estándar (stdio). También dispones de gig admin, un comando que ejecuta las mismas operaciones desde la terminal.

Si prefieres no instalar nada, usa en su lugar el endpoint remoto.

Antes de empezar

El programa gig debe estar instalado en el equipo donde se ejecuta el asistente y ser accesible desde él (en tu PATH, o usa su ruta completa).
Necesitas un usuario de Gigantics con correo y contraseña. Las instancias que solo permiten el inicio de sesión por LDAP o SAML no se pueden usar así: usa el endpoint remoto, que no necesita contraseña.
Lo que puede hacer el asistente depende de los roles de ese usuario. Las herramientas de toda la instancia (usuarios, Ajustes Globales, licencias, auditoría) necesitan el rol Root. Consulta Roles.
Tus credenciales solo se envían por https://, o por http:// sin cifrar a localhost. Para una red privada de confianza, define GIG_ALLOW_INSECURE_HTTP=1.

Paso 1: Iniciar sesión una vez

Ejecuta:

gig admin login --url https://gig.example.com --email admin@example.com

Gigantics te pide la contraseña (no se muestra mientras escribes), la comprueba y guarda la dirección, el correo y la contraseña en ~/.gig/admin.json. El fichero solo puede leerlo tu usuario (modo 600), y Gigantics se niega a usarlo si otros usuarios pueden leerlo.

Para eliminar las credenciales guardadas:

gig admin logout

Para ver con qué cuenta has iniciado sesión y si es Root:

gig admin whoami

Si prefieres no guardar una contraseña en un fichero, omite este paso y entrega las credenciales al asistente mediante variables de entorno, como en el paso 2.

Paso 2: Añadir el servidor a tu asistente

Claude Code

claude mcp add gigantics -- gig mcp --url https://gig.example.com

Si no guardaste las credenciales en el paso 1, pásalas como variables de entorno:

claude mcp add gigantics \
  -e GIG_EMAIL=admin@example.com -e GIG_PASSWORD=... \
  -- gig mcp --url https://gig.example.com

Claude Desktop, Cursor y otros clientes MCP

Añade el servidor a la configuración MCP de tu cliente (en Claude Desktop: Settings → Developer → Edit Config):

{
  "mcpServers": {
    "gigantics": {
      "command": "gig",
      "args": ["mcp", "--url", "https://gig.example.com"],
      "env": {
        "GIG_EMAIL": "admin@example.com",
        "GIG_PASSWORD": "..."
      }
    }
  }
}

Quita el bloque env si iniciaste sesión con gig admin login. Reinicia el cliente después de cambiar su configuración. Si el cliente no encuentra gig, escribe su ruta completa en command.

Paso 3: Probarlo

Pregunta a tu asistente:

"Comprueba el estado de mi instancia de Gigantics."

Si responde con la versión y los métodos de inicio de sesión de la instancia, estás conectado.

Opciones

gig mcp acepta estas opciones:

Opción	Descripción
`--url`, `-u`	La dirección del servidor de Gigantics. Por defecto: `GIG_URL`, o `http://localhost:5000`
`--email`, `-e`	La cuenta con la que iniciar sesión. Por defecto: `GIG_EMAIL`
`--org`, `-o`	La organización por defecto (su moniker), `GIG_ORG`
`--project`, `-p`	El proyecto por defecto (su moniker), `GIG_PROJECT`
`--confirm-mode`	`human` (por defecto) o `agent`. Consulta Aprobaciones y seguridad
`--verbose`	Escribe cada llamada a una herramienta en la salida de error, para diagnosticar problemas
`--list-tools`	Imprime la lista de herramientas como JSON y termina. Añade `--available` para listar solo lo que tu cuenta puede llamar
`--version`	Imprime la versión del servidor MCP

La contraseña no se puede dar como opción, de modo que nunca aparece en la lista de procesos: usa gig admin login o GIG_PASSWORD.

Variables de entorno

Variable	Descripción
`GIG_URL`, `GIG_EMAIL`, `GIG_PASSWORD`	La instancia y la cuenta. Tienen prioridad sobre `~/.gig/admin.json`
`GIG_ORG`, `GIG_PROJECT`	La organización y el proyecto por defecto
`GIG_MCP_CONFIRM_MODE`	`human` o `agent`, igual que `--confirm-mode`
`GIG_ALLOW_INSECURE_HTTP`	`1` permite enviar las credenciales por `http://` sin cifrar a una red privada de confianza

Trabajar en un proyecto

La mayoría de las herramientas trabajan sobre un proyecto. El asistente determina la organización y el proyecto en este orden:

lo que dijiste en la petición ("en el proyecto Ventas..."),
el valor por defecto de la conversación, que se fija cuando eliges un proyecto,
el valor por defecto con el que arrancaste el servidor, --org y --project.

Si no se aplica ninguno, el asistente te pregunta a qué proyecto te refieres. No necesitas conocer ids: acepta el nombre exacto de cualquier cosa (un proyecto, un datasource, un job...) y, si un nombre es parcial o ambiguo, te lista los candidatos y te pregunta en lugar de adivinar.

Herramientas de mantenimiento

Las migraciones, el estado del servidor y el reinicio del servidor ejecutan el comando gig junto al servidor MCP. Solo están disponibles cuando:

el usuario es Root, y
el servidor se ejecuta en la misma máquina que la instancia y usa una dirección localhost.

En caso contrario, el asistente te indica que las ejecutes en el equipo de la instancia.

Administrar desde la terminal: gig admin

gig admin ejecuta las mismas operaciones sin un asistente, lo que es útil para scripts y para aprobar tú mismo un cambio destructivo con --yes:

gig admin instance health
gig admin job list --project ventas --statuses failed

Consulta Comando Admin para ver los comandos, las opciones y los códigos de salida.

Solución de problemas

Qué ves	Causa	Solución
Sign in failed	Credenciales incorrectas, o la instancia usa LDAP o SAML	Compruébalas con `gig admin whoami`. Para instancias LDAP y SAML usa el endpoint remoto
Refusing to send credentials ... over plain http	La dirección es `http://` y no `localhost`	Usa la dirección `https://` de la instancia
Refusing to read credentials file	Otros usuarios pueden leer `~/.gig/admin.json`	Ejecuta `chmod 600 ~/.gig/admin.json`
Access denied / `FORBIDDEN`	La cuenta no tiene el rol que necesita la operación	Pide el rol a un usuario Root. El asistente no buscará otra forma de saltárselo
Local only en una herramienta de mantenimiento	La dirección no es `localhost`, o el usuario no es Root	Ejecútala en el equipo de la instancia, o hazlo desde la interfaz de Gigantics
El asistente no ve el servidor	El cliente no puede arrancar `gig`	Usa la ruta completa de `gig` en `command` y reinicia el cliente