Búsqueda

Pregúntame lo que quieras

Conecta el servidor MCP de Salesforce a tu Entorno de trabajo

Conecta Salesforce MCP a ClickUp para que tus herramientas de IA puedan buscar, leer, crear y actualizar registros de Salesforce en lenguaje natural.

Esta guía cubre la configuración inicial de Salesforce que debe realizar un administrador de Salesforce, y luego cómo conectarse desde ClickUp usando OAuth 2.0 con PKCE. El proceso toma aproximadamente 20 minutos, más 30 minutos adicionales para que Salesforce active la aplicación.

Lo que necesitarás

  • Un Entorno de trabajo de ClickUp
  • Una organización de Salesforce (Enterprise Edition o superior, o Developer Edition) con permisos de administrador del sistema
  • El permiso Customize Application en Salesforce

Pasos en Salesforce

Antes de completar el proceso en ClickUp, debes seguir varios pasos de configuración en Salesforce.

Al terminar los pasos en Salesforce, llevarás tres cosas de vuelta a ClickUp:

  • La Clave del consumidor de tu aplicación cliente externa
  • Si estás conectando una organización de producción o de sandbox
  • Qué servidor MCP activaste

Paso 1: Habilitar el servicio MCP

Los servidores MCP alojados en Salesforce solo aparecen en la página de configuración de Salesforce una vez que el servicio MCP está activado para tu organización:

  1. En la página de configuración de Salesforce, escribe Servidores MCP en el cuadro de búsqueda rápida.
  2. Si Servidores MCP aparece bajo Catálogo de API, el servicio ya está activado. Pasa al Paso 2: Activar un servidor.
  3. Si no aparece, escribe Interfaz de usuario en el cuadro de búsqueda rápida, abre Interfaz de usuario y activa Habilitar servicio MCP. Luego guarda.

Captura de pantalla de la página de interfaz de usuario

Si no encuentras Servidores MCP, verifica que la edición de tu organización sea compatible con los servidores MCP alojados.

Paso 2: Activar un servidor

Los servidores MCP están desactivados por defecto. Un administrador debe activar cada uno antes de que cualquier cliente pueda conectarse:

  1. En la página de configuración de Salesforce, escribe Servidores MCP en el cuadro de búsqueda rápida.
  2. Haz clic en Servidores MCP bajo Catálogo de API.
  3. Activa el servidor que tu equipo necesita. ClickUp es compatible con estos:
    • Lecturas de SObject (recomendado): busca y recupera registros y relaciones
    • SObject completo: crea, lee, actualiza y elimina registros
    • Mutaciones de SObject: crea y actualiza registros, sin eliminaciones
    • Headless 360 (beta): acceso unificado a la plataforma de Salesforce

Captura de pantalla de la página de servidores MCP

Si omites este paso, ClickUp inicia sesión correctamente pero no encuentra herramientas. Vas a elegir este mismo servidor en ClickUp, así que anota cuál activaste.

Un servidor puede tardar hasta 2 minutos en activarse después de que lo enciendas.

Para la referencia completa, consulta la guía de Salesforce para activar servidores MCP.

Paso 3: Crear una aplicación cliente externa

Debes usar una aplicación cliente externa. Las aplicaciones conectadas no son compatibles con MCP y causan errores de autenticación.

Para crear una aplicación cliente externa:

  1. En la página de configuración de Salesforce, escribe Cliente externo en el cuadro de búsqueda rápida.
  2. Haz clic en Administrador de aplicaciones cliente externas.
  3. Haz clic en Nueva aplicación cliente externa.
  4. Completa la sección de Información básica. Dale a la aplicación un nombre como ClickUp MCP.
  5. Expande API (Habilitar configuración de OAuth) y marca Habilitar OAuth.

Captura de pantalla de la página del administrador de aplicaciones cliente externas

Deja este formulario abierto. Los pasos 4 al 6 te pedirán completar el resto.

Si ClickUp más adelante reporta un cliente no válido, la Clave del consumidor que pegaste no pertenece a esta aplicación, o la aplicación todavía no terminó de propagarse (Paso 8).

Para la referencia completa, consulta la guía de Salesforce para crear una aplicación cliente externa.

Paso 4: Configuración de seguridad de OAuth

En el mismo formulario, bajo Seguridad:

  1. Marca estas opciones:
    • Require Proof Key for Code Exchange (PKCE) extension for Supported Authorization Flows
    • Enable Refresh Token Rotation
    • Issue JSON Web Token (JWT)-based access tokens for named users
    • Limit Idle Refresh Token Time-to-Live (TTL) to 30 Days
  • Deja estas sin marcar:
    • Require secret for Web Server Flow
    • Require secret for Refresh Token Flow
    • Enforce Refresh Token IP Allowlist

Captura de pantalla de la sección de seguridad

ClickUp usa PKCE como cliente público, por lo que no necesita el secreto del consumidor. Si exiges un secreto aquí, la conexión falla.

Paso 5: Agregar la URL de devolución de llamada

En el campo URL de devolución de llamada, ingresa la URL de devolución de llamada de ClickUp:

https://search.clickup-prod.com/connect/salesforcemcp

La URL de devolución de llamada debe coincidir exactamente, sin barra diagonal al final. ClickUp muestra el mismo valor en su configuración guiada para que puedas comparar.

Paso 6: Agregar alcances de OAuth

Para agregar alcances de OAuth:

  1. Bajo Alcances de OAuth seleccionados, agrega:
    • mcp_api: accede a los servidores MCP alojados en Salesforce
    • refresh_token, offline_access: realiza solicitudes en cualquier momento
  2. Haz clic en Crear.

Captura de pantalla de la sección de API

Si configuraste esto durante la beta de Salesforce MCP, los alcances anteriores (api, sfap_api, einstein_gpt_api) ya no funcionan. Usa mcp_api y refresh_token. Consulta la guía de transición de beta a disponibilidad general de Salesforce.

Paso 7: Asignar un conjunto de permisos

Por defecto, cualquier persona de tu organización puede conectarse a la aplicación. Para limitar el acceso a personas específicas, usa un conjunto de permisos. Este paso es opcional.

El conjunto de permisos solo controla quién puede conectarse. Los permisos existentes de cada persona en objetos, campos y uso compartido de Salesforce siguen aplicando en cada llamada a herramienta.

Para asignar un conjunto de permisos:

  1. Crea un conjunto de permisos para los usuarios de ClickUp MCP, como Usuario de ClickUp MCP. No necesita permisos adicionales.
  2. Asígnalo a todas las personas que se conectarán desde ClickUp.
  3. En Administrador de aplicaciones cliente externas, abre tu aplicación y haz clic en Políticas.
  4. Bajo Políticas de OAuth, establece Usuarios permitidos en Los usuarios aprobados por el administrador están preautorizados.

Captura de pantalla de la sección de políticas de OAuth

  1. Bajo Políticas de la aplicación, mueve tu conjunto de permisos a Conjuntos de permisos seleccionados. Deja Perfiles seleccionados vacío.

Captura de pantalla de la pestaña de políticas

  1. Haz clic en Guardar.

Si seleccionas Los usuarios aprobados por el administrador están preautorizados y no eliges un conjunto de permisos, nadie podrá conectarse.

Deja Alcances personalizados de OAuth vacío. ClickUp solo necesita los alcances del Paso 6.

Paso 8: Esperar a que la aplicación se propague

Una nueva aplicación cliente externa puede tardar hasta 30 minutos en estar disponible, similar a la propagación de DNS. Si ClickUp falla poco después de la configuración, espera e intenta de nuevo.

Mientras esperas, copia tu clave del consumidor:

  1. En Administrador de aplicaciones cliente externas, abre la aplicación que creaste.
  2. Haz clic en Configuración.
  3. Haz clic en Clave y secreto del consumidor bajo Configuración de OAuth.
  4. Copia la Clave del consumidor. Comienza con 3MVG9.

Captura de pantalla de la página de configuración de OAuth

Conectarse en ClickUp

El OAuth de Salesforce usa tu sesión activa del navegador. Antes de comenzar, prepara tu navegador:

  1. Cierra sesión en todas las demás organizaciones de Salesforce en tu navegador predeterminado.
  2. Inicia sesión en la organización que tiene tu aplicación cliente externa y mantén el navegador abierto.

Esto evita que el inicio de sesión llegue a la organización incorrecta. Consulta la guía de Salesforce para iniciar sesión en tu organización.

Una vez que tu navegador esté listo, conéctate en ClickUp:

  1. Abre el App Center.
  2. Busca y selecciona Salesforce.
  3. Selecciona una pestaña para elegir el tipo de conexión:
    • Integración personal: solo tú puedes usar las herramientas de Salesforce en ClickUp. Tu identidad y permisos de Salesforce se usan en cada llamada a herramienta.
    • Integración del entorno de trabajo: cualquier miembro del Entorno de trabajo puede usar las herramientas de Salesforce, pero cada persona inicia sesión con sus propias credenciales de Salesforce y, si restringiste el acceso en el Paso 7, necesita ese conjunto de permisos. Todos comparten la misma aplicación cliente externa, pero cada persona tiene su propia autorización.
  4. Haz clic en Conectar para abrir la configuración guiada.
  5. Bajo ¿Qué organización estás conectando?, elige Producción / Developer Edition o Sandbox / organización Scratch.
  6. Bajo ¿Qué servidor activaste?, elige el servidor que activaste en el Paso 2.
  7. Verifica que la URL de devolución de llamada que aparece en ClickUp coincida con la de tu aplicación cliente externa.
  8. Pega tu Clave del consumidor del Paso 8.
  9. Haz clic en Siguiente.
  10. Aprueba el acceso cuando Salesforce lo solicite.
  11. Espera a que ClickUp valide la conexión y cargue tus herramientas.

Captura de pantalla de la página de configuración de conexión en el App Center de ClickUp

Limitaciones

Limitaciones conocidas y problemas comunes con Salesforce MCP:

  • Demora de propagación: una nueva aplicación cliente externa puede tardar hasta 30 minutos en funcionar. Si el primer intento falla, espera e inténtalo de nuevo.
  • Las aplicaciones conectadas no funcionan: debes usar una aplicación cliente externa.
  • Servidor no activado: el inicio de sesión funciona, pero no se cargan herramientas si el servidor que elegiste en ClickUp no está activo en Salesforce.
  • Acceso restringido: si limitaste el acceso con un conjunto de permisos en el Paso 7, las personas que no lo tengan no podrán conectarse. Asígnaselo, o cambia Usuarios permitidos de nuevo a Todos los usuarios pueden autoautorizarse.
  • Solo cuatro servidores en ClickUp: la configuración guiada admite Lecturas de SObject, SObject completo, Mutaciones de SObject y Headless 360 (beta). Otros servidores MCP de Salesforce, como SObject Deletes o Data Cloud SQL, todavía no están disponibles en ClickUp.
  • Varias organizaciones en un mismo navegador: si tienes sesión iniciada en más de una organización, el inicio de sesión puede llegar a la incorrecta. Cierra sesión en las demás primero.
  • Límites de API y facturación: las llamadas a herramientas MCP cuentan contra los límites de solicitudes de API de tu organización, y Salesforce puede cobrar el uso de MCP mediante Flex Credits. Revisa Uso de API en la página de configuración de Salesforce.
  • Organizaciones Scratch: no puedes crear aplicaciones cliente externas en organizaciones Scratch desde la página de configuración de Salesforce. Crea la aplicación en una organización Dev Hub, empaquétala e instálala en la organización Scratch.
  • Configuraciones beta: los alcances beta anteriores y las URLs que contienen v1-beta.2 ya no funcionan. La configuración guiada de ClickUp usa automáticamente el formato de URL de disponibilidad general.

Desconectarse o revocar el acceso

Para desconectarte desde ClickUp:

  1. En el App Center, busca y selecciona la aplicación.
  2. Selecciona la pestaña Personal o Entorno de trabajo.
  3. Junto a Conectado, haz clic en el ícono de puntos suspensivos ....
  4. Selecciona Desconectar.
  5. Para confirmar, haz clic en Desconectar.

Para revocar el acceso completamente desde Salesforce:

  1. En la página de configuración de Salesforce, abre Administrador de aplicaciones cliente externas.
  2. Abre tu aplicación ClickUp MCP.
  3. Haz clic en Políticas de OAuth.
  4. Revoca el acceso o elimina la aplicación cliente externa.

Desconectarte en ClickUp revoca tu token de OAuth, pero deja la aplicación cliente externa en Salesforce para que puedas volver a conectarte fácilmente.

Refuerzo de seguridad para producción (opcional)

  • Restringir por dirección IP: agrega rangos de IP permitidos en Políticas de OAuth y marca Enforce Refresh Token IP Allowlist bajo Seguridad. Verifica primero que los rangos de IP de tu cliente MCP estén dentro de los límites de la lista de permitidos de Salesforce.
  • Cierre de sesión único: actívalo en Configuración de sesión para que al terminar una sesión de Salesforce también se cierre la sesión MCP correspondiente.
  • Privilegio mínimo: prefiere Lecturas de SObject a menos que tu equipo necesite modificar registros.