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 explica la configuración única de Salesforce que debe realizar un administrador de Salesforce y cómo conectarse desde ClickUp mediante OAuth 2.0 con PKCE. El proceso debería llevar unos 20 minutos, más 30 minutos adicionales para que Salesforce active la aplicación.

Qué 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 Personalizar aplicación en Salesforce

Pasos en Salesforce

Antes de completar el proceso en ClickUp, hay que realizar varios pasos de configuración en Salesforce.

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

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

Paso 1: Activar 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 Búsqueda rápida.
2. Si Servidores MCP aparece bajo Catálogo de API, el servicio ya está activado. Ve al Paso 2: Activar un servidor.
3. Si no aparece, escribe Interfaz de usuario en el cuadro Búsqueda rápida, abre Interfaz de usuario y activa Habilitar servicio MCP. Después guarda.

Si no encuentras Servidores MCP, comprueba que la edición de tu organización admite servidores MCP alojados.

Paso 2: Activar un servidor

Los servidores MCP están desactivados de forma predeterminada. Un administrador tiene que 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 Búsqueda rápida.
2. Haz clic en Servidores MCP bajo Catálogo de API.
3. Activa el servidor que necesita tu equipo. ClickUp admite 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 Salesforce completa

Si omites este paso, ClickUp inicia sesión correctamente pero no encuentra ninguna herramienta. Tendrás que seleccionar este mismo servidor en ClickUp, así que anota cuál has activado.

Un servidor puede tardar hasta 2 minutos en activarse después de encenderlo.

Para consultar la referencia completa, visita la guía de Salesforce sobre activación de servidores MCP.

Paso 3: Crear una aplicación de cliente externo

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

Para crear una aplicación de cliente externo:

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

Mantén este formulario abierto. En los pasos 4 a 6 tendrás que rellenar el resto.

Si ClickUp indica posteriormente que el cliente no es válido, la Clave de consumidor que has pegado no pertenece a esta aplicación, o la aplicación aún no ha terminado de propagarse (Paso 8).

Para consultar la referencia completa, visita la guía de Salesforce sobre creación de una aplicación de cliente externo.

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

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

Paso 5: Añadir la URL de devolución de llamada

En el campo URL de devolución de llamada, introduce 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 compararla.

Paso 6: Añadir ámbitos de OAuth

Para añadir ámbitos de OAuth:

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

Si realizaste esta configuración durante la beta de Salesforce MCP, los ámbitos 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

De forma predeterminada, cualquier persona de tu organización puede conectarse a la aplicación. Para limitar el acceso a personas concretas, 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 sobre objetos, campos y uso compartido de Salesforce siguen aplicándose a todas las llamadas de 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 el Gestor de aplicaciones de cliente externo, 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.

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

6. Haz clic en Guardar.

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

Deja Ámbitos personalizados de OAuth vacío. ClickUp solo necesita los ámbitos del Paso 6.

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

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

Mientras esperas, copia tu clave de consumidor:

1. En el Gestor de aplicaciones de cliente externo, abre la aplicación que has creado.
2. Haz clic en Configuración.
3. Haz clic en Clave de consumidor y secreto bajo Configuración de OAuth.
4. Copia la Clave de consumidor. Empieza por 3MVG9.

Conectar en ClickUp

El OAuth de Salesforce usa tu sesión activa del navegador. Antes de empezar, prepara el 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 de cliente externo y mantén el navegador abierto.

Así evitas que el inicio de sesión acabe en la organización incorrecta. Consulta la guía de Salesforce sobre cómo iniciar sesión en tu organización.

Una vez listo el navegador, puedes conectarte en ClickUp:

1. Abre el App Center.
2. Busca y selecciona Salesforce.
3. Selecciona una pestaña para elegir el tipo de conexión:
   • Conexión personal: solo tú puedes usar las herramientas de Salesforce en ClickUp. Tu identidad y permisos de Salesforce se usan en cada llamada de herramienta.
   • Conexió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 de cliente externo, pero cada persona tiene su propia autorización.
4. Haz clic en Conectar para abrir la configuración guiada.
5. Bajo ¿A qué organización te estás conectando?, elige Producción / Developer Edition o Sandbox / organización Scratch.
6. Bajo ¿Qué servidor has activado?, elige el servidor que activaste en el Paso 2.
7. Comprueba que la URL de devolución de llamada que aparece en ClickUp coincide con la de tu aplicación de cliente externo.
8. Pega tu Clave de 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.

Limitaciones

Limitaciones conocidas y problemas habituales con Salesforce MCP:

• Retraso de propagación: una nueva aplicación de cliente externo 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 de cliente externo.
• Servidor no activado: el inicio de sesión funciona, pero no se carga ninguna herramienta si el servidor que seleccionaste 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 autorizarse por su cuenta.
• 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, aún no están disponibles en ClickUp.
• Varias organizaciones en un mismo navegador: si has iniciado sesión en más de una organización, el inicio de sesión puede acabar en la incorrecta. Cierra sesión en las demás primero.
• Límites de API y facturación: las llamadas de herramientas MCP cuentan para los límites de solicitudes de API de tu organización, y Salesforce puede facturar el uso de MCP mediante Flex Credits. Comprueba el Uso de API en la página de configuración de Salesforce.
• Organizaciones Scratch: no puedes crear aplicaciones de cliente externo 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 de la beta: los ámbitos de la beta antigua y las URL que contienen v1-beta.2 ya no funcionan. La configuración guiada de ClickUp usa automáticamente el formato de URL de disponibilidad general.

Desconectar 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 icono de puntos suspensivos ....
4. Selecciona Desconectar.
5. Para confirmar, haz clic en Desconectar.

Para revocar completamente el acceso desde Salesforce:

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

Al desconectarte en ClickUp se revoca tu token de OAuth, pero la aplicación de cliente externo permanece en Salesforce, de modo que puedes reconectarte fácilmente.

Refuerzo de la seguridad para producción (opcional)

• Restringir por dirección IP: añade rangos de IP permitidos en Políticas de OAuth y marca Enforce Refresh Token IP Allowlist bajo Seguridad. Antes comprueba que los rangos de IP de tu cliente MCP se encuentran 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 cerrar una sesión de Salesforce también se cierre la sesión MCP correspondiente.
• Mínimo privilegio: usa preferentemente Lecturas de SObject, salvo que tu equipo necesite modificar registros.