Conectar un asistente de IA

Teramot funciona como conector para asistentes de IA: una vez conectado, tu asistente puede explorar tus tablas, ejecutar consultas y armar tablas de resultados y dashboards en tu nombre, con tus propios permisos.

Todo lo que necesitás está en la página Conectar IA de la app de Teramot. Abrila desde Administración → Conectar IA en la barra lateral, o desde Configuración → Conectar IA → Abrir Conectar IA.

Dónde: Administración → Conectar IA en la barra lateral. Cada asistente es una tarjeta en la parte superior de la página: hacé clic en ella para abrir sus pasos. Configuración avanzada es el último panel de la página; hacé clic para mostrar la URL del servidor y el Client ID. Configuración está en el menú de tu avatar (tus iniciales), arriba a la derecha del encabezado.

Opción	Valor
URL del servidor	`https://mcp.teramot.com/mcp`
Client ID	Se muestra en la página Conectar IA, en Configuración avanzada. La mayoría de los clientes nunca lo piden.

La conexión pertenece a tu cuenta, no a un espacio de trabajo: la misma conexión llega a todos los espacios de trabajo y proyectos de los que sos miembro. Lo que el asistente puede hacer en cada uno lo limita tu rol ahí — mirá Permisos.

Hay dos formas de iniciar sesión:

Conexión rápida (OAuth) — Claude, Claude Code, ChatGPT, GitHub Copilot, Gemini y Microsoft 365 Copilot. Iniciás sesión con tu cuenta de Teramot en una ventana del navegador; no hay clave que administrar.
Clave de acceso — Cursor, v0, Antigravity y cualquier otro cliente que solo acepte un encabezado estático. Mirá Autenticación.

Los pasos de abajo son los mismos que muestra la página Conectar IA. Donde aparece <client-id>, usá el Client ID de esa página. Los pasos de Claude Desktop también funcionan en claude.ai.

Abrí Claude Desktop en tu computadora.
Hacé clic en el ícono de configuración y andá a Settings → Connectors.
Hacé clic en “Add custom connector”.
En Team o Enterprise solo un owner puede agregarlo, desde Organization settings → Connectors: “Add” → “Custom” → “Web”. El resto arranca en el paso 5.
Ponele el nombre “Teramot”, pegá la URL del servidor y terminá con “Add”.
Campo Valor
URL del servidor https://mcp.teramot.com/mcp
Dejá las opciones de autenticación como las detecta Claude: el servidor publica sus propios datos de OAuth. Solo si tu versión te pide credenciales OAuth (en “Advanced settings”, o “Use your own OAuth client”), pegá el Client ID de abajo y dejá el Client Secret vacío.
Campo Valor
Client ID (solo si te lo pide) <client-id>
Hacé clic en “Connect” en el conector Teramot e iniciá sesión con tu cuenta de Teramot en el navegador que se abre.
Volvé a Claude Desktop y preguntale sobre tus datos de Teramot.

Campo	Valor
Client ID (solo si te lo pide)	`<client-id>`

Abrí tu terminal.

Ejecutá este comando:

claude mcp add --transport http --client-id <client-id> --callback-port 8090 teramot https://mcp.teramot.com/mcp

Se abrirá el navegador automáticamente. Completá la autenticación OAuth y cerrá la ventana.
Volvé a la terminal. Ya podés usar claude para hacer preguntas sobre tus datos.
```
claude "¿cuántos usuarios activos tuve este mes?"
```

Abrí chatgpt.com en el navegador e iniciá sesión.
Activá el modo desarrollador: Settings → Apps → Developer mode, y confirmá.
En un chat, abrí el menú de aplicaciones (＋) → ChatGPT Plugins y hacé clic en “Create”.
Pegá la URL del servidor.
Campo Valor
URL del servidor https://mcp.teramot.com/mcp
Hacé clic en “Connect” y completá la autenticación OAuth en la ventana que se abre.
Pedile a ChatGPT que consulte tus datos de Teramot en cualquier conversación.

Abrí VS Code (1.116 o posterior) e iniciá sesión con la cuenta de GitHub que tiene Copilot.
Abrí un chat y cambialo a Agent mode.

Creá .vscode/mcp.json en tu espacio de trabajo y pegá esta configuración.

{
  "servers": {
    "teramot": {
      "type": "http",
      "url": "https://mcp.teramot.com/mcp",
      "oauth": {
        "clientId": "<client-id>"
      }
    }
  }
}

Recargá la ventana cuando VS Code te lo pida.
En las herramientas de Agent mode, iniciá sesión en “teramot” y completá OAuth en el navegador.
Preguntale a Copilot por tus datos de Teramot.

Abrí gemini.google.com en el navegador e iniciá sesión.
Andá a Settings → Connectors y hacé clic en “Add MCP Server”.
Ponele un nombre y pegá la URL del servidor.
Campo Valor
URL del servidor https://mcp.teramot.com/mcp
Client ID <client-id>
En la pestaña “Auth”, completá los campos de OAuth con estos valores.
Campo Valor
Authorization URL https://mcp.teramot.com/authorize
Token URL https://mcp.teramot.com/token
Client ID <client-id>
Client Secret not-required
Scopes openid email access offline_access
El formulario exige un Client Secret, pero el servidor usa un cliente OAuth público — cualquier valor funciona; se descarta antes de llegar al proveedor de identidad.
Hacé clic en “Add” e iniciá sesión con tu cuenta de Teramot en la ventana que se abre.
Pedile a Gemini que consulte tus datos de Teramot en cualquier conversación.

Campo	Valor
Authorization URL	`https://mcp.teramot.com/authorize`
Token URL	`https://mcp.teramot.com/token`
Client ID	`<client-id>`
Client Secret	`not-required`
Scopes	`openid email access offline_access`

Abrí el Developer Portal de Teams (dev.teams.microsoft.com) y andá a Tools → OAuth client registration → “New OAuth client registration”.

Ponele el nombre “Teramot” y completá los campos con estos valores.

Campo	Valor
Base URL	`https://mcp.teramot.com`
Client ID	`<client-id>`
Client Secret	`not-required`
Authorization URL	`https://mcp.teramot.com/authorize`
Token URL	`https://mcp.teramot.com/token`
Refresh URL	`https://mcp.teramot.com/token`
Scopes	`openid email access offline_access`

El portal exige un Client Secret, pero el servidor usa un cliente OAuth público — cualquier valor funciona; se descarta antes de llegar al proveedor de identidad.

Guardá el registro y copiá el “OAuth client registration ID” que muestra el portal.

En Microsoft 365 Copilot, agregá un conector MCP llamado “Teramot” y completá sus campos con estos valores.

Campo	Valor
URL del servidor	`https://mcp.teramot.com/mcp`
URL del sitio web	`https://www.teramot.com`
URL de la directiva de privacidad	`https://docs.teramot.com/compliance/Transparency/privacy-policy`
URL de términos de uso	`https://docs.teramot.com/compliance/Transparency/terms-of-service`

Usá “Teramot” como nombre del desarrollador y OAuth 2.0 como tipo de autenticación. En “Id. de referencia”, pegá el ID del registro del paso 3.

Hacé clic en “Autorizar” e iniciá sesión con tu cuenta de Teramot en la ventana que se abre.
Preguntale a Copilot por tus datos de Teramot en cualquier conversación.

Generá una clave de acceso para este cliente.
En la página Conectar IA, ingresá un nombre (Nombre — ej. cursor-trabajo) y hacé clic en Generar clave. Guardá esta clave. No se puede volver a mostrar.
Abrí la configuración MCP de tu cliente.
En Cursor: Settings → MCP. En v0: Settings → Integrations. En Antigravity: menú principal → MCP Servers.

Agregá esta configuración al archivo JSON.

{
  "mcpServers": {
    "teramot": {
      "url": "https://mcp.teramot.com/mcp",
      "headers": {
        "Authorization": "Bearer TU_CLAVE_ACÁ"
      }
    }
  }
}

Guardá el archivo y reiniciá el cliente para que tome los cambios.
El cliente ya puede acceder a tus datos de Teramot.

Comprobar que funciona

Pedile a tu asistente “listá mis espacios de trabajo de Teramot”. Debería responder con los espacios de trabajo que ves en la app. Si te pregunta qué espacio de trabajo o proyecto usar, decíselo — mirá Elegir o cambiar el espacio de trabajo y el proyecto.

Si el inicio de sesión falla, mirá Solución de problemas.

Introducción Autenticación