¿Desde qué cliente te conectas?
Elige tu app y sigue los pasos — la URL de abajo ya es la del área Página web. En todas, el login es con tu usuario del CRM.
- Abre Ajustes → Conectores y elige Agregar conector personalizado.
- Nombre:
Comercia+ el área · URL:https://mcp.comercia.io/pagina-web/tucuenta/mcp - Pulsa Conectar: inicia sesión en tu CRM y autoriza.
- En un chat, activa el conector desde el menú de herramientas del cuadro de mensaje.
Requiere plan Pro, Max, Team o Enterprise.
claude mcp add --transport http comercia-pagina-web https://mcp.comercia.io/pagina-web/tucuenta/mcp
Dentro de la sesión escribe /mcp y elige Authenticate — se abre el
navegador con el login de tu CRM.
- Ajustes → Conectores → Crear (con Developer mode si tu plan lo pide).
- URL:
https://mcp.comercia.io/pagina-web/tucuenta/mcp· Autenticación: OAuth. - Autoriza con tu usuario del CRM.
Cada conector que crees estrena su propio callback: si borras el conector y lo vuelves a crear, se registra de nuevo solo.
codex mcp add comercia-pagina-web --url https://mcp.comercia.io/pagina-web/tucuenta/mcp codex mcp login comercia-pagina-web
El login abre el navegador con el inicio de sesión de tu CRM; el token se
renueva solo.
Settings → Tools & MCP → New MCP Server, o en ~/.cursor/mcp.json:
{
"mcpServers": {
"comercia-pagina-web": { "url": "https://mcp.comercia.io/pagina-web/tucuenta/mcp" }
}
}Cursor detecta el OAuth y abre el login del CRM.
Comando MCP: Add Server… → HTTP, o en tu mcp.json:
{
"servers": {
"comercia-pagina-web": { "type": "http", "url": "https://mcp.comercia.io/pagina-web/tucuenta/mcp" }
}
}El IDE y el CLI comparten la config de ~/.gemini/config/mcp_config.json
(también puedes darlo de alta desde Manage MCP servers en el IDE):
{
"mcpServers": {
"comercia-pagina-web": { "serverUrl": "https://mcp.comercia.io/pagina-web/tucuenta/mcp" }
}
}Al conectar, Antigravity abre el navegador con el login de tu CRM y guarda el token.
kimi mcp add --transport http --auth oauth comercia-pagina-web https://mcp.comercia.io/pagina-web/tucuenta/mcp
Kimi abre el navegador para autorizar con tu usuario del CRM; si no lo hace,
corre kimi mcp auth comercia-….
Si tu app no trae soporte nativo de servidores MCP remotos, el puente
mcp-remote la conecta igual:
npx -y mcp-remote https://mcp.comercia.io/pagina-web/tucuenta/mcp
- Transporte: Streamable HTTP (stateless, respuestas JSON).
- Autorización: OAuth 2.1 — authorization_code + PKCE S256 obligatorio, registro dinámico (RFC 7591) y resource indicators (RFC 8707).
- Callbacks: loopback libre (
http://127.0.0.1,localhosto[::1], cualquier puerto y path — RFC 8252) y los callbacks HTTPS de clientes conocidos. ¿Callback propio en la nube? Pide el alta. - Discovery: ver los enlaces del pie de página.
¿Qué puede hacer tu asistente?
Seguridad
- Autorizas con tu usuario del CRM vía OAuth — tu asistente nunca ve tu contraseña.
- Acceso acotado al módulo de páginas (
pages:read,pages:write,design:write): nada de contactos, ventas ni usuarios. - Cada token queda amarrado a tu tienda: un token de una cuenta no sirve para otra.
- Modelo borrador → publicar, con aprobación humana para el código.
- Autorizas con tu usuario del CRM vía OAuth — tu asistente nunca ve tu contraseña.
- Acceso acotado a las plantillas de documentos (
plantillas:read,plantillas:write): nada de contactos, ventas ni usuarios. - Cada token queda amarrado a tu cuenta: un token de una cuenta no sirve para otra.
- Historial siempre: toda versión previa se conserva y se puede restaurar.
- Autorizas con tu usuario del CRM vía OAuth — tu asistente nunca ve tu contraseña.
- Solo lectura (
kb:read) de documentación de plataforma: sin ventas, sin clientes, sin saldos. - Cada token queda amarrado a tu cuenta: un token de una cuenta no sirve para otra.
- Autorizas con tu usuario del CRM vía OAuth — tu asistente nunca ve tu contraseña.
- Solo lectura (
bi:read) sobre el espejo de TU cuenta en el warehouse: el conector no puede escribir ni tocar el CRM. - Cada token queda amarrado a tu cuenta: un token de una cuenta no sirve para otra.