Pregúntale a tu negocio.

Nota Free permite 1 conector. Igual en claude.ai y Claude Desktop.

1. Abre Configuración: en la web (claude.ai) clic en tu ícono de perfil (abajo-izquierda) > Settings; en Claude Desktop pulsa Ctrl+, (o menú hamburguesa > File > Settings).
2. En la barra lateral entra a 'Connectors' (en planes Pro/Max está bajo 'Customize > Connectors').
3. Arriba a la derecha clic en 'Add' (o el botón '+') y elige 'Add custom connector'.
4. Pega la URL del servidor remoto: https://mcp.bi.comercia.io/t/tksmayoreo/mcp y clic en 'Add' (deja OAuth vacío en Advanced settings; el server lo descubre solo).
5. Se abre la ventana de login OAuth: inicia sesión en tu CRM Comercia y autoriza el acceso; al volver el conector queda 'Connected'.
6. En el chat, abre el menú '+' (Add files, connectors, and more) del cuadro de mensaje y activa el conector para usar sus herramientas/recursos.

// Flujo nativo: solo URL en la UI de Connectors (Streamable HTTP + OAuth), sin archivo.
// Alternativa para Claude Desktop (bridge stdio->HTTP) en claude_desktop_config.json:
{
  "mcpServers": {
    "comercia-bi": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.bi.comercia.io/t/tksmayoreo/mcp"]
    }
  }
}

Nota OAuth automático por DCR. Sin navegador (SSH): añade --no-browser.

1. Añade el servidor remoto por HTTP desde la terminal: claude mcp add --transport http comercia-bi https://mcp.bi.comercia.io/t/tksmayoreo/mcp (usa -s user para todos tus proyectos, o -s project para compartirlo vía .mcp.json).
2. Inicia Claude Code con el comando claude y ejecuta /mcp para ver el servidor comercia-bi y su estado (aparecerá marcado como que necesita autenticación).
3. Selecciona comercia-bi en el panel /mcp y elige Authenticate; se abre el navegador con el login OAuth 2.1. Completa el inicio de sesión y vuelve a /mcp para confirmar connected.
4. Alternativa desde shell: claude mcp login comercia-bi. En un servidor sin navegador (SSH/Linux) añade --no-browser: imprime la URL, la abres en tu máquina y pegas la URL de callback en el prompt.
5. El token se guarda de forma segura y se refresca solo. Para revocar acceso o reautenticar, usa Clear authentication / Re-authenticate en el menú /mcp (o claude mcp logout comercia-bi).

# Añadir el servidor MCP remoto (Streamable HTTP + OAuth 2.1)
claude mcp add --transport http comercia-bi https://mcp.bi.comercia.io/t/tksmayoreo/mcp

# Autenticar (o usa /mcp dentro de la sesión). En SSH sin navegador: --no-browser
claude mcp login comercia-bi

# Equivalente en .mcp.json (scope project, compartido en el repo):
# {
#   "mcpServers": {
#     "comercia-bi": {
#       "type": "http",
#       "url": "https://mcp.bi.comercia.io/t/tksmayoreo/mcp"
#     }
#   }
# }

Nota Requiere plan de pago y activar el Modo desarrollador (beta). Free no lo tiene.

1. En ChatGPT (web o app de escritorio) abre tu foto de perfil → Ajustes → Conectores (Apps y conectores). Entra en Avanzado y activa el Modo desarrollador (en Team/Enterprise el administrador del espacio de trabajo debe habilitarlo primero).
2. Vuelve a Ajustes → Conectores y pulsa Crear (nuevo conector).
3. Rellena: Nombre; URL del servidor MCP = https://mcp.bi.comercia.io/t/tksmayoreo/mcp; Autenticacion = OAuth. Marca la casilla "Confio en esta aplicacion" y pulsa Crear.
4. Se abre la ventana de OAuth: inicia sesion y aprueba el acceso. Al conectar, ChatGPT lista las herramientas del servidor.
5. En un chat, abre el menu + (Mas / Herramientas), activa el conector y escribe tu consulta. Las acciones de escritura piden confirmacion manual.

Nota El login OAuth necesita navegador local (falla en headless o SSH).

1. Instala o actualiza Gemini CLI (npm install -g @google/gemini-cli); Gemini Code Assist en VS Code comparte el mismo archivo ~/.gemini/settings.json.
2. Registra el servidor remoto: en terminal ejecuta gemini mcp add --transport http comercia-bi https://mcp.bi.comercia.io/t/tksmayoreo/mcp (esto escribe el bloque mcpServers en ~/.gemini/settings.json).
3. Abre la sesión con gemini y ejecuta el comando /mcp auth comercia-bi: se abre el navegador para el login OAuth (redirect a http://localhost:<puerto>/oauth/callback).
4. Autoriza en el navegador; el token queda guardado en ~/.gemini/mcp-oauth-tokens.json y la conexion se reintenta automaticamente.
5. Verifica con /mcp list en Gemini CLI (o corre 'Developer: Reload Window' en VS Code para Code Assist) que el servidor aparece conectado con sus tools.

// Comando (escribe en ~/.gemini/settings.json):
//   gemini mcp add --transport http comercia-bi https://mcp.bi.comercia.io/t/tksmayoreo/mcp
// o edita ~/.gemini/settings.json a mano:
{
  "mcpServers": {
    "comercia-bi": {
      "httpUrl": "https://mcp.bi.comercia.io/t/tksmayoreo/mcp",
      "authProviderType": "dynamic_discovery"
    }
  }
}

Nota Requiere Cursor 1.0 o superior (app de escritorio).

1. Abre Cursor y entra en Settings > Cursor Settings (Cmd/Ctrl + Shift + J); en la barra lateral elige 'Tools & Integrations'.
2. En la sección 'MCP Tools' haz clic en 'New MCP Server': se abre el archivo mcp.json (global en ~/.cursor/mcp.json, o del proyecto en .cursor/mcp.json).
3. Dentro de 'mcpServers' agrega una entrada con solo la clave 'url' apuntando al servidor remoto (ver snippet) y guarda; Cursor recarga la lista sola.
4. De vuelta en 'Tools & Integrations', el servidor aparece con un boton 'Needs Login' / 'Connect': haz clic y se abre el navegador con el login OAuth.
5. Inicia sesion, revisa los permisos y pulsa 'Authorize'; al volver a Cursor el servidor queda en verde con sus tools listadas.
6. Activa el toggle del servidor (o de tools individuales) y ya puedes invocarlo desde el chat/Agent.

{
  "mcpServers": {
    "comercia-bi": {
      "url": "https://mcp.bi.comercia.io/t/tksmayoreo/mcp"
    }
  }
}

Nota Requiere VS Code 1.102+ y sesión de Copilot. Usa la clave 'servers' (no 'mcpServers').

1. Actualiza a VS Code 1.102 o superior e inicia sesion en Copilot (icono de cuenta / Copilot en la barra); el soporte MCP es GA desde 1.102.
2. Abre la Paleta de comandos (Ctrl+Shift+P) y ejecuta 'MCP: Add Server'; elige el transporte 'HTTP (HTTP or Server-Sent Events)'.
3. Pega la URL https://mcp.bi.comercia.io/t/tksmayoreo/mcp, asigna un ID (ej. 'comercia-bi') y elige 'Workspace' (crea .vscode/mcp.json) o 'Global' (config de usuario).
4. Al iniciar el servidor VS Code detecta que requiere OAuth: aparece el aviso 'Allow' para autorizar; pulsalo y completa el login en el navegador (flujo OAuth 2.1).
5. Verifica/gestiona el acceso en el menu Accounts → 'Manage Trusted MCP Servers'.
6. Abre el Chat, cambia al modo 'Agent', pulsa el icono 'Tools' y activa las herramientas del servidor comercia-bi.

// .vscode/mcp.json (workspace) o config de usuario via 'MCP: Open User Configuration'
{
  "servers": {
    "comercia-bi": {
      "type": "http",
      "url": "https://mcp.bi.comercia.io/t/tksmayoreo/mcp"
    }
  }
}

Nota Extensión saoudrizwan.claude-dev. Transporte 'Streamable HTTP'.

1. En VS Code, abre el panel de Cline (icono en la barra lateral) y haz clic en el icono 'MCP Servers' (servidores apilados) de la barra superior del panel.
2. Entra a la pestaña 'Remote Servers'.
3. En 'Server Name' escribe un nombre unico (ej. comercia-bi) y en 'Server URL' pega https://mcp.bi.comercia.io/t/tksmayoreo/mcp.
4. En 'Transport Type' elige 'Streamable HTTP' y pulsa 'Add Server'.
5. Cline abrira el navegador para el login OAuth: inicia sesion y autoriza; al volver, el servidor queda conectado (indicador verde) y sus tools disponibles.
6. Para editar a mano, usa la pestana 'Configure' > boton 'Configure MCP Servers', que abre el archivo cline_mcp_settings.json.

{
  "mcpServers": {
    "comercia-bi": {
      "type": "streamableHttp",
      "url": "https://mcp.bi.comercia.io/t/tksmayoreo/mcp"
    }
  }
}

Nota Editor de Codeium. Usa 'serverUrl'; déjalo sin 'headers' para que dispare el OAuth.

1. En el panel Cascade, haz clic en el ícono de plugins/MCP (arriba a la derecha) y abre "Manage plugins" (Gestionar plugins).
2. Pulsa "View raw config" para abrir el archivo de configuración ~/.codeium/windsurf/mcp_config.json (en Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json).
3. Dentro del objeto mcpServers agrega una entrada con el campo serverUrl apuntando a la URL del servidor; deja sin headers para que Cascade use el login OAuth.
4. Guarda el archivo y en Cascade pulsa "Refresh" (recargar) para que detecte el nuevo servidor.
5. Windsurf abrirá el navegador para el flujo OAuth 2.1; autoriza el acceso y vuelve al editor, donde el servidor aparecerá conectado con sus herramientas.

{
  "mcpServers": {
    "comercia-bi": {
      "serverUrl": "https://mcp.bi.comercia.io/t/tksmayoreo/mcp"
    }
  }
}

Nota Soporte remoto reciente (beta). Va bajo 'context_servers'.

1. Actualiza Zed a una version reciente (el soporte de MCP remoto por URL con OAuth es nuevo): menu Zed → Check for Updates.
2. Abre Settings → AI → MCP Servers (o el Agent Panel → boton Settings). Pulsa 'Add Server' y elige 'Add Remote Server'.
3. Escribe un nombre (ej. comercia-bi) y en URL pega https://mcp.bi.comercia.io/t/tksmayoreo/mcp; deja el header Authorization VACIO para forzar el login OAuth.
4. Zed detecta el 401 y abre el navegador con el flujo OAuth (Authorization Code + PKCE). Autoriza; al volver, la sesion se guarda en el llavero del sistema (callback loopback 127.0.0.1:27523).
5. Verifica el indicador verde del servidor en MCP Servers; sus herramientas ya aparecen disponibles en el Agent Panel.
6. Alternativa por archivo: edita settings.json (Cmd/Ctrl+, → 'Open Settings') y agrega el servidor bajo 'context_servers' con solo 'url' (sin Authorization = OAuth).

{
  "context_servers": {
    "comercia-bi": {
      "url": "https://mcp.bi.comercia.io/t/tksmayoreo/mcp"
    }
  }
}

Nota Solo en Kimi CLI (terminal), no en la app/web de kimi.com.

1. Instala/actualiza Kimi CLI (el agente de terminal de Moonshot AI, en transicion a "Kimi Code CLI") y verifica que responde: kimi --version.
2. Registra el servidor remoto con transporte HTTP y OAuth: kimi mcp add --transport http --auth oauth comercia-bi https://mcp.bi.comercia.io/t/tksmayoreo/mcp
3. Autoriza con OAuth: kimi mcp auth comercia-bi — se abre el navegador, inicias sesion y autorizas; el token queda guardado.
4. Verifica: kimi mcp list y kimi mcp test comercia-bi; ya dentro de una sesion usa el comando /mcp para ver las tools cargadas.
5. Alternativa por archivo: edita ~/.kimi/mcp.json, agrega el server bajo mcpServers con su url, y ejecuta kimi mcp auth comercia-bi para el login OAuth.

# Opcion A - CLI (recomendada, dispara el login OAuth):
kimi mcp add --transport http --auth oauth comercia-bi https://mcp.bi.comercia.io/t/tksmayoreo/mcp
kimi mcp auth comercia-bi

# Opcion B - archivo ~/.kimi/mcp.json (luego: kimi mcp auth comercia-bi):
{
  "mcpServers": {
    "comercia-bi": {
      "url": "https://mcp.bi.comercia.io/t/tksmayoreo/mcp"
    }
  }
}