Clientell Salesforce MCP

npx add-mcp 'https://mcp.clientell.ai/mcp'

Alcance

Doce conectores, todos de lectura en vivo. Salesforce, Slack, Jira, GitHub, Gmail, Google Calendar, Google Drive, Notion, Microsoft Teams, SharePoint, Outlook Mail y Outlook Calendar están disponibles hoy. Cada uno lee el sistema de origen cuando lo solicitas, a través de tu propia autorización. Consulta la referencia de conectores.

Conecta tu espacio de trabajo y registra el servidor tú mismo. La guía de configuración usa Claude Code, donde Clientell está construido y verificado de extremo a extremo. Cualquier cliente MCP Streamable HTTP también funciona, incluidos Cursor, VS Code, ChatGPT y Gemini, y la guía incluye fragmentos de configuración para los más comunes.

Contenido · 19 secciones

Conoce tu organización. Verifica el cambio. Mantén el control.

Pregunta a tu cliente de IA qué depende de un campo, inspecciona un registro en vivo cuando sea necesario y mantén las decisiones entre conversaciones. El servidor MCP alojado conecta estas tres partes. No hay servidor local que instalar.

metadatos índice lecturas en vivo, solo lectura en tu propia conexión despliegues aprobados Tu cliente de IA Claude Code, Cursor, VS Code Clientell MCP responde tus preguntas Context Graph el mapa de metadatos de tu organización Tu sf CLI se ejecuta en tu máquina Organización de Salesforce tus registros viven aquí

Hacer una pregunta

1. Tu cliente de IA Claude Code, Cursor, VS Code
2. Clientell MCP responde tus preguntas
3. Context Graph el mapa de metadatos de tu organización
4. índice de metadatos
5. Organización de Salesforce tus registros viven aquí

Leer registros en vivo

1. Tu cliente de IA Claude Code, Cursor, VS Code
2. Clientell MCP solo lectura, nada se almacena
3. a través del servicio de autenticación de Clientell, en tu propia conexión
4. Organización de Salesforce tus registros viven aquí

Desplegar un cambio

1. Tu cliente de IA Claude Code, Cursor, VS Code
2. Tu sf CLI se ejecuta en tu máquina
3. despliegues aprobados
4. Organización de Salesforce tus registros viven aquí

Tu cliente de IA pregunta a Clientell. Clientell responde desde el Context Graph y lee registros en vivo en tu propia conexión de Salesforce. Los cambios aprobados se despliegan a través de tu propio sf CLI.

1 · El grafo

Traza dependencias antes de cambiar metadatos.

Objetos, campos, flujos, Apex, reglas de validación, perfiles y conjuntos de permisos, además de las referencias entre ellos. Pregunta qué referencia un campo antes de cambiarlo. Reconstruye el grafo en una sola llamada cuando quieras. No contiene contenido de registros.

2 · La sesión en vivo

Consulta registros en vivo con tus propios permisos.

Las búsquedas se ejecutan cuando preguntas, a través del servicio de autenticación de Clientell en tu propia conexión de Salesforce. Los registros vuelven directamente a tu cliente y nunca se escriben en el grafo.

3 · Memoria

Conserva el contexto que elijas guardar.

Tú o el modelo escriben entradas explícitamente. Las correcciones, versiones y expiración basada en tiempo mantienen ese contexto inspeccionable. Nada se guarda automáticamente de tu actividad. Consulta Memoria.

1 Redacta el cambio edita como metadatos 2 Verifica el radio de impacto qué toca 3 Tu aprobación tú dices sí 4 Despliega mediante tu sf CLI en tu máquina 5 Verifica confirma que llegó deploy_guard cuando Clientell prepara el despliegue para Perfiles, Conjuntos de Permisos y Reglas de Compartición: rechaza cargas útiles inseguras de reemplazo sin fusión

1. Redacta el cambio edita como metadatos
2. Verifica el radio de impacto qué toca
3. Tu aprobación tú dices sí
4. Despliega mediante tu sf CLI en tu máquina deploy_guard Cuando Clientell prepara un despliegue de Perfil, Conjunto de Permisos o Reglas de Compartición, rechaza cargas útiles inseguras de reemplazo sin fusión.
5. Verifica confirma que llegó

Cada cambio se redacta, se verifica qué toca y se despliega solo después de tu aprobación. Cuando Clientell prepara un despliegue de Perfil, Conjunto de Permisos o Reglas de Compartición, deploy_guard rechaza cargas útiles que borrarían silenciosamente entradas existentes.

Llama a los doce conectores directamente a través de MCP desde tu cliente. No se requiere un agente separado de Clientell.

Contexto profundo de la organización, con límites claros.

Mira sobre qué puede actuar tu cliente, dónde permanecen los datos y qué salvaguardas se aplican antes de que un cambio llegue a Salesforce.

Indexado almacenado en el Context Graph nombres IDs relaciones solo estructura Lectura en vivo se obtiene solo cuando preguntas datos de registros tu conexión → tu organización como tú, nunca almacenado Nunca almacenado no lo conserva Clientell contenido de registros cuerpos de mensajes permanece en tu organización

1. Indexado almacenado en el Context Graph
   • nombres
     • IDs
     • relaciones solo estructura
2. Lectura en vivo se obtiene solo cuando preguntas
   • datos de registros a través de tu propia conexión de Salesforce, nunca almacenado
3. Nunca almacenado no lo conserva Clientell
   • contenido de registros
     • cuerpos de mensajes permanece en tu organización

El grafo contiene estructura. Los datos de registros se leen en vivo y nunca se almacenan.

Qué hace

• Mapea los metadatos y dependencias de Salesforce para que puedas ver qué afectaría un cambio antes de realizarlo.
• Lee registros en vivo de Salesforce bajo demanda, solo lectura, a través del servicio de autenticación de Clientell en tu propia conexión y permisos de Salesforce. Los registros pasan a tu cliente y no se almacenan.
• Redacta cambios y verifica su radio de impacto. Después de tu aprobación, tu cliente de IA despliega a través de tu propia sesión de Salesforce CLI. Cuando Clientell prepara un despliegue, deploy_guard lo verifica y rechaza cargas útiles inseguras de reemplazo sin fusión para Perfiles, Conjuntos de Permisos y Reglas de Compartición.
• Lee doce conectores en vivo al momento de la pregunta, a través de tu propia autorización, por lo que las respuestas de los conectores están actualizadas por diseño.
• Sella cada respuesta del grafo con su hora de last_graph_build, y combina respuestas de Flow, Apex y reglas de validación con una verificación en vivo lista para ejecutar.
• Proporciona herramientas a clientes compatibles con MCP a través de Streamable HTTP con autenticación bearer.
• Aísla cada espacio de trabajo de los demás. Dentro de un espacio de trabajo, todos ven el mismo mapa de la organización, porque las consultas al grafo no aplican los permisos individuales a nivel de registro o campo de cada persona. Tú decides quién está en el espacio de trabajo.
• Mantiene el contexto de trabajo escrito explícitamente con correcciones, versiones y expiración.

Decisiones de diseño deliberadas

• Mantiene el contenido de registros de Salesforce y los cuerpos de mensajes fuera del índice. Los conectores los leen en vivo cuando preguntas.
• Deja los despliegues contigo. Los cambios se ejecutan a través de tu propia sesión local de sf CLI, que Clientell nunca ve. Las lecturas de registros en vivo se ejecutan solo como la persona que conectó la organización, por lo que un compañero no puede leer a través de tu conexión.
• Prueba que una fusión de registros duplicados sea segura antes de eliminar algo. merge_duplicate_records verifica cada ID de registro contra la organización y redacta el plan de fusión; la fusión en sí se ejecuta a través de tu propia sesión de sf.
• Te pone a cargo de la política de confirmación para escrituras de conectores. Las acciones de Slack, Jira y GitHub se ejecutan a través de los controles de aprobación de herramientas de tu propio cliente de IA.
• Reconstruye el grafo de Salesforce bajo demanda, en una sola llamada, cuando quieras, y te dice qué tan fresco está cada respuesta. Reemplazar, no fusionar tu despliegue · 1 entrada organización en vivo, después del despliegue Perfil Sales_Rep Cuenta · editar Cuenta · editar conservado Oportunidad · editar Caso · leer Cliente potencial · leer 3 entradas existentes eliminadas silenciosamente deploy_guard rechaza esta carga útil La ruta segura 1 Lee la definición en vivo Sales_Rep exactamente como está ahora 2 Fusiona tu cambio Cuenta · editar se une a las otras 3 3 Escribe la definición completa las 4 entradas, nada se pierde deploy_guard lo deja pasar

Reemplazar, no fusionar

1. Tu despliegue: Perfil Sales_Rep lleva 1 entrada: Cuenta · editar
2. reemplaza la definición completa
3. Organización en vivo, después del despliegue
   • Cuenta · editar, conservado
     • Oportunidad · editar eliminado
     • Caso · leer eliminado
     • Cliente potencial · leer eliminado
4. deploy_guard rechaza esta carga útil se aplica a Perfil, PermissionSet y SharingRules

La ruta segura

1. 1. Lee la definición en vivo Sales_Rep exactamente como está ahora
2. 2. Fusiona tu cambio Cuenta · editar se une a las otras 3
3. 3. Escribe la definición completa las 4 entradas, nada se pierde
4. deploy_guard lo deja pasar las 4 entradas, nada se pierde

Ejemplo ilustrativo. Cuando Clientell prepara un despliegue, deploy_guard rechaza cargas útiles que eliminarían silenciosamente permisos o reglas de uso compartido existentes.

Ve el radio de impacto antes de hacer un cambio.

El Context Graph mapea los componentes de tu organización y sus referencias. Pregunta qué depende de Account.Custom_Segment__c antes de eliminarlo. Obtén los flujos y permisos afectados desde el grafo, no de una serie de llamadas API en vivo.

lo lee lo verifica o lo muestra se ejecuta sobre él Account.Industry campo de lista de selección Flujos Set_Account_Tier Clases Apex AccountService.cls Reglas de validación Industry_Required Diseños de página Account Layout Informes Pipeline by Industry Informes Accounts by Industry

• Account.Industry campo de lista de selección

Anillo 1: se ejecuta sobre él

• Flujos Set_Account_Tier
• Clases Apex AccountService.cls

Anillo 2: lo verifica o lo muestra

• Reglas de validación Industry_Required
• Diseños de página Account Layout

Anillo 3: lo lee

• Informes Pipeline by Industry
• Informes Accounts by Industry

Ejemplo ilustrativo. Antes de cambiar un campo, ve todo lo que toca.

El índice

Ve las dependencias sin copiar registros de clientes.

Pregunta qué flujo toca un campo o qué perfil alcanza un objeto. El índice contiene nombres, identificadores y relaciones, no el contenido de registros de Salesforce ni cuerpos de mensajes. Cuando necesitas las palabras reales, los conectores las leen en vivo desde el sistema de origen, como tú.

El grafo de Salesforce

Consulta un grafo de Salesforce de solo lectura.

Las consultas usan la ruta de ejecución de solo lectura de la base de datos. Una consulta al grafo no puede escribir en el índice, por lo que puedes inspeccionar dependencias sin cambiar el mapa en el que confías.

Tu organización

Despliega con tus propias credenciales de Salesforce.

Clientell parchea y audita un cambio propuesto. Después de que lo apruebes, tu cliente de IA ejecuta el despliegue a través de tu propia sesión de sf CLI, con tus permisos. Clientell nunca ve esa sesión.

Lo que indexa el grafo

Objetos, campos, flujos, Apex, reglas de validación, perfiles y conjuntos de permisos, con sus referencias. Pregunta qué flujo escribe en un campo, qué perfiles pueden editarlo, o qué rompería una eliminación. El grafo responde preguntas estructurales sin leer registros de clientes.

pertenece a escribe referencia verifica lee otorga acceso a otorga acceso a Campos Account.Industry Objetos estándar + personalizados Flujos disparados por registro Apex clases, disparadores Reglas de validación verificaciones al guardar Informes y paneles Perfiles acceso base Conjuntos de permisos acceso adicional

Qué enlaza con qué

• Campos pertenecen a Objetos
• Flujos escriben Campos
• Apex referencia Campos
• Reglas de validación verifican Campos
• Informes leen Campos
• Perfiles otorgan acceso a Objetos y Campos
• Conjuntos de permisos otorgan acceso a Objetos y Campos

El Context Graph mapea la estructura de tu organización y cada enlace entre sus partes.

Cómo llegan los cambios a Salesforce

Clientell parchea el cambio propuesto y audita su impacto contra el grafo. Cuando Clientell prepara un despliegue, deploy_guard lo verifica y rechaza cargas útiles inseguras de reemplazar-no-fusionar para Perfiles, Conjuntos de permisos y Reglas de uso compartido. Una vez que lo apruebas, tu cliente de IA ejecuta el despliegue a través de tu propia sesión de sf, con tus credenciales y permisos. Las fusiones de registros duplicados reciben el mismo cuidado: merge_duplicate_records verifica cada ID de registro contra la organización y redacta un plan de fusión que puede demostrar seguro, de modo que la fusión se verifica antes de eliminar cualquier cosa. La fusión luego se ejecuta a través de tu propia sesión de sf.

1 Preguntas en inglés sencillo “¿Qué usa Industry?” 2 Clientell recorre el grafo sigue cada enlace 3 Responde con fuentes y su tiempo de construcción grafo construido hace 2 h 4 Verificación en vivo opcional de una línea se ejecuta vía tu CLI sf

1. Preguntas en inglés sencillo “¿Qué usa Industry?”
2. Clientell recorre el grafo sigue cada enlace
3. Respuesta con fuentes y su tiempo de construcción grafo construido hace 2 h
4. Verificación en vivo opcional de una línea se ejecuta mediante tu CLI de sf

Ejemplo ilustrativo. Las respuestas provienen del grafo, por lo que son rápidas y muestran exactamente de dónde provienen.

Sepa siempre qué tan fresca es una respuesta.

Cada respuesta del grafo lleva su marca de tiempo last_graph_build. Reconstruya el grafo de Salesforce cuando quiera con una sola llamada y confirme cualquier respuesta sobre Flows, Apex o reglas de validación contra la organización en vivo con un solo comando.

Llame a clientell_set_active_org sin argumentos para reconstruir el grafo después de cambiar metadatos. Las respuestas sobre Flows, clases de Apex, reglas de validación y otros componentes incluyen un comando sf listo para ejecutar que verifica si cambiaron en la organización en vivo desde la última compilación. Los conectores leen el sistema de origen al momento de la pregunta, por lo que sus respuestas están actualizadas por diseño. Las búsquedas de registros en vivo de Salesforce se ejecutan cuando usted pregunta, a través del servicio de autenticación de Clientell en su propia conexión y permisos de Salesforce. Los registros pasan a su cliente y no se almacenan.

construido 09:00 Grafo construido a partir de los metadatos de su organización respuesta · construido 09:00 Cada respuesta sellada con su tiempo de construcción comparado con la organización en vivo Verificación en vivo antes de actuar un comando, contra su organización construido 14:30 Reconstrucción bajo demanda cuando quiera reconstrucción: un tiempo de construcción nuevo

Sepa siempre qué tan fresca es una respuesta

1. Grafo construido a partir de los metadatos de su organizaciónconstruido 09:00
2. Cada respuesta sellada con su tiempo de construcciónrespuesta · construido 09:00
3. Verificación en vivo antes de actuar un comando, contra su organizacióncomparado con la organización en vivo
4. Reconstrucción bajo demanda cuando quieraconstruido 14:30 reconstrucción: un tiempo de construcción nuevo, de vuelta al inicio

Ejemplo ilustrativo con tiempos de muestra. Cada respuesta lleva su tiempo de construcción y un comando la verifica contra su organización en vivo.

Qué significa esto en la práctica

¿Acaba de agregar un campo? Verifique el tiempo de last_graph_build de la respuesta. Si el campo es más nuevo, reconstruya y pregunte de nuevo, o ejecute la verificación en vivo que vino con la respuesta antes de actuar sobre ella.

Su espacio de trabajo está aislado. Su CLI sigue siendo suya.

Verifique quién puede consultar el grafo, cómo se aprueban las escrituras y qué credenciales almacena Clientell antes de conectar una organización de producción.

Su espacio de trabajo todos en él ven el mismo mapa AK JL MR SP un mapa de organización compartido Otro espacio de trabajo su propio mapa de organización Otro espacio de trabajo su propio mapa de organización sellado

Su espacio de trabajo

• AK
• JL
• MR
• SP

todos ven el mismo mapa

Un mapa de organización compartido un mapa para todo el espacio de trabajo

nada cruza

Otro espacio de trabajo su propio mapa de organización

Otro espacio de trabajo su propio mapa de organización

Cada espacio de trabajo está sellado de los demás. Dentro de uno, todos comparten el mismo mapa de organización, por lo que usted decide quién está en el espacio de trabajo.

Ámbitos del grafo y aislamiento

Los ámbitos de grafo privado, de organización y compartido usan destinos separados. El aislamiento del espacio de trabajo evita el acceso entre espacios de trabajo. Dentro de un espacio de trabajo, todos ven el mismo mapa de organización, por lo que usted decide quién está en el espacio de trabajo. Las consultas al grafo no aplican los permisos individuales de nivel de registro o de campo de Salesforce de cada persona. Agregue a las personas que deberían compartir esa vista de la organización.

Cómo leer esto

Un compañero de equipo puede preguntar sobre la estructura de un campo en el grafo compartido incluso si Salesforce le ocultaría ese campo. La membresía del espacio de trabajo es su punto de control, así que concédala de la misma manera en que concedería acceso a los metadatos de la organización.

Acciones de escritura

Slack, Jira y GitHub pueden realizar acciones: enviar un mensaje, comentar o mover un problema. Estas acciones se ejecutan a través de los controles de aprobación de herramientas de su propio cliente de IA, por lo que usted establece la política de confirmación allí. Los despliegues de Salesforce siguen un camino diferente: Clientell parchea y audita el cambio, rechaza cargas útiles inseguras de reemplazar-en-lugar-de-fusionar que se le pida preparar, y su cliente de IA usa su propia sesión de sf para desplegar después de que usted apruebe.

Almacenamiento de credenciales

Las credenciales almacenadas usan cifrado AES-256-GCM con un nonce nuevo en cada escritura. La conexión de Salesforce que usted autoriza se almacena de esta manera y sirve sus lecturas en vivo solo para usted, nunca para un compañero de equipo. Su sesión de CLI de Salesforce, que ejecuta los despliegues, permanece en su máquina y nunca es visible para Clientell.

Use el cliente MCP en el que trabaja.

Clientell expone herramientas e instrucciones a través de Streamable HTTP MCP con autenticación de portador. Está construido y verificado de extremo a extremo en Claude Code, y funciona con cualquier cliente Streamable HTTP MCP, incluidos Cursor, VS Code, ChatGPT y Gemini.

VerificadoClaude Code

Construido y verificado de extremo a extremo contra este servidor. Siga la guía de configuración para los comandos exactos de Claude Code.

CompatibleChatGPT, Copilot, Cursor, Gemini, VSCode, LibreChat, OpenCode, Windsurf

Estos clientes hablan el mismo Streamable HTTP MCP. Registre el servidor con la sintaxis de agregar servidor de cada cliente; la guía de configuración tiene fragmentos de configuración para los más comunes.

Esta no es una lista de permitidos. Cualquier cliente que admita Streamable HTTP MCP con autenticación de portador puede registrar el servidor. Claude Code es el cliente contra el que Clientell construye y verifica de extremo a extremo.

Conecte Salesforce y haga su primera pregunta.

Autorice Salesforce, construya su primer Context Graph y luego registre Clientell en su cliente MCP. Los comandos trabajados a continuación son para Claude Code.

1 Conecte Salesforce inicie sesión en su organización 2 Construya el grafo mapea sus metadatos 3 Agregue a su cliente de IA Claude Code, Cursor, VS Code 4 Haga su primera pregunta “¿Qué usa Industry?”

1. Conecte Salesforce inicie sesión en su organización
2. Construya el grafo mapea sus metadatos
3. Agregue a su cliente de IA Claude Code, Cursor, VS Code
4. Haga su primera pregunta “¿Qué usa Industry?”

De la conexión a la primera respuesta en cuatro pasos.

Antes de comenzar

Claude Code, instalado y con sesión iniciada

claude --version

Espere: una cadena de versión.

Si falta: instálelo desde la guía de inicio rápido de Anthropic. No alojamos nuestro propio instalador.

La CLI de Salesforce

sf --version

Espere: una línea que comience con @salesforce/cli/.

Si falta: instálelo desde Salesforce. sf no es necesario para registrar el servidor alojado ni para hacer preguntas al grafo, y las búsquedas de registros en vivo pasan por su conexión de Clientell Salesforce en su lugar. Manténgala autenticada para verificaciones en vivo y despliegues de Salesforce aprobados, que se ejecutan a través de su propia sesión de CLI.

Una organización a la que esté autenticado

sf org list

Espere: al menos una organización, no marcada como (expired).

Si falta o expiró: ejecute sf org login web. Una sesión expirada todavía aparece en la lista y aún falla al momento de la consulta.

Verificación 4

Un espacio de trabajo de Clientell

Dónde: la página de configuración de MCP. Inicie sesión, autorice Salesforce, espere el primer índice y copie el token de acceso para la Etapa 3.

Nota: el token es una credencial de portador limitada a su espacio de trabajo de Clientell. No es una credencial de Salesforce y no se puede usar para acceder a Salesforce.

Verificación 5

El paquete administrado de Clientell AI, instalado en su organización

Instale: organización de producción o sandbox. La instalación en sí toma unos dos minutos.

Quién: Instalar un paquete administrado es una acción de administrador de Salesforce. Si usted no es administrador de la organización que quiere indexar, pida a uno que lo instale antes del paso de OAuth. Hágalo temprano si necesita la aprobación de otro equipo. Si falta: Salesforce devuelve external_app_not_installed durante OAuth. Instala el paquete en la organización a la que te estás conectando y vuelve a intentarlo. Consulta Solución de problemas.

No está en esta lista

Node.js es un requisito previo de Claude Code, no un requisito previo del servidor Clientell. El servidor MCP está alojado; no se requiere ningún proceso de servidor local.

Etapa 1

Conecta tus sistemas

Inicia sesión y autoriza los sistemas que necesites mediante OAuth. Comienza con Salesforce: sus metadatos forman el grafo. Cada conector adicional que autorices añade lecturas en vivo del trabajo que lo rodea.

Autoriza solo lo que necesites. Un conector que no hayas autorizado no expone herramientas. Slack, Jira y GitHub también pueden realizar acciones, así que revisa la configuración de aprobación de herramientas de tu cliente, descrita en Seguridad y aislamiento.

Etapa 2

Deja que se construya el primer índice

La primera compilación indexa la estructura de tu organización antes de que las consultas de grafo estén disponibles. Las organizaciones grandes tardan más que las organizaciones de desarrollo. Después, reconstruye bajo demanda cuando quieras.

Después de registrar el servidor, solicita clientell_onboarding_status para verificar el progreso de la compilación. Verifícalo si falta un objeto conocido en una respuesta de grafo.

Etapa 3

Registra el servidor con tu cliente

Reemplaza <YOUR_TOKEN> con el token de tu espacio de trabajo, mantén la palabra Bearer y el espacio después de ella, y luego pega todo en tu terminal.

claude mcp add-json clientell '{
  "type": "http",
  "url": "https://mcp.clientell.ai/mcp",
  "headers": { "Authorization": "Bearer <YOUR_TOKEN>" },
  "timeout": 180000
}' --scope user

Lo que deberías ver: Servidor MCP HTTP añadido clientell a la configuración de usuario

La entrada se guarda. Verifica la conexión a continuación. Claude Code no prueba la URL ni el token al guardar esta entrada. Un nombre de host incorrecto o un token caducado fallan al conectar. Verifica que funcionó es donde lo descubres.

Línea por línea, pasa el cursor o usa tabulación para resaltar cada pieza arriba

claude mcp add-json

El comando propio de Claude Code para registrar un servidor MCP desde un bloque JSON. Nada de lo nuestro se ejecuta aquí; estás editando la configuración de Claude Code.

clientell

El nombre que verás en /mcp y en los nombres de las herramientas. Es tuyo para elegir; usamos clientell en toda esta página, y todos los demás comandos aquí asumen que hiciste lo mismo.

'{ … }'

La entrada del servidor, entre comillas simples para que tu shell la pase sin modificaciones. Cuatro claves: las tres primeras son obligatorias, y timeout tiene un valor predeterminado, por lo que se recomienda en lugar de ser obligatoria.

"type": "http"

Indica que este es un servidor remoto al que se accede por HTTP. Si lo omites, Claude Code lee la entrada como un comando local para ejecutar, no encuentra ninguno y omite el servidor silenciosamente; no aparecerá en claude mcp list en absoluto.

"url": ".../mcp"

El único endpoint en el que responde el servidor. El /mcp al final es parte de la dirección, no decoración. Si lo eliminas, obtienes un error de "no encontrado" que solo informa el nombre de host, lo que dificulta ver la causa.

"headers"

Tu token de acceso, enviado en cada solicitud. Claude Code no lo recorta; un espacio o salto de línea accidental al copiar se envía como parte del token y el servidor lo rechaza.

"timeout": 180000

Tres minutos, en milisegundos, como límite máximo para una sola llamada de herramienta. El valor predeterminado corta una solicitud después de 60 segundos, y una primera consulta contra un grafo de organización en frío puede tardar más que eso. Los valores por debajo de 1000 se ignoran por completo.

--scope user

Hace que el servidor esté disponible en todos los proyectos. Sin esto, Claude Code usa su ámbito predeterminado, que vincula el servidor al directorio en el que te encuentres; inicia Claude en cualquier otro lugar y se te dirá que no hay servidores MCP configurados. El ámbito se fija al añadir el servidor; cambiarlo implica eliminarlo y volver a añadirlo.

¿Prefieres banderas en lugar de JSON?

Mismo servidor, bandera por bandera. Esta forma es más fácil de leer, pero no tiene bandera --timeout, por lo que no puede establecer el tiempo de espera; tienes que añadirlo después manualmente.

claude mcp add --transport http clientell https://mcp.clientell.ai/mcp \
  --header "Authorization: Bearer <YOUR_TOKEN>" \
  --scope user

Luego abre ~/.claude.json, encuentra la entrada clientell bajo el nivel superior mcpServers, y añade "timeout": 180000. Si prefieres no editar ese archivo manualmente, usa la forma JSON anterior; por eso es la ruta principal.

Otros clientes

Registra el mismo endpoint alojado en la configuración de tu cliente. Cualquier cliente MCP Streamable HTTP funciona; estos fragmentos cubren los comunes, y la ruta trabajada de Claude Code anterior es la que Clientell verifica de extremo a extremo. Consulta Clientes compatibles y revisa la documentación actual de tu cliente si su formato de configuración ha cambiado.

Claude DesktopCompatible · no verificado por nosotros

Config ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "clientell": {
      "type": "http",
      "url": "https://mcp.clientell.ai/mcp",
      "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
    }
  }
}

Reinicia Claude Desktop después de editar. Lee este archivo solo al iniciar.

Consulta la sintaxis actual de conectores personalizados de Claude Desktop si este bloque no carga.

CodexCompatible · no verificado por nosotros

Config ~/.codex/config.toml

[mcp_servers.clientell]
url = "https://mcp.clientell.ai/mcp"
http_headers = { Authorization = "Bearer <YOUR_TOKEN>" }

Codex lee servidores MCP remotos desde su configuración TOML. Consulta su propia documentación para los nombres de clave en tu versión; han cambiado entre versiones.

CursorCompatible · no verificado por nosotros

Config ~/.cursor/mcp.json

{
  "mcpServers": {
    "clientell": {
      "url": "https://mcp.clientell.ai/mcp",
      "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
    }
  }
}

Un .cursor/mcp.json local del proyecto también funciona, y limita el servidor a ese repositorio en lugar de a toda tu cuenta.

VS CodeCompatible · no verificado por nosotros

Config .vscode/mcp.json

{
  "servers": {
    "clientell": {
      "type": "http",
      "url": "https://mcp.clientell.ai/mcp",
      "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
    }
  }
}

Consejo: VS Code usa servers como clave de nivel superior, no mcpServers. Si el servidor no aparece, verifica esa clave primero.

Confirma que tu cliente puede alcanzar el grafo.

Verifica la conexión antes de preguntar sobre tu organización. Registrar guarda la entrada; la primera conexión prueba el endpoint y el token.

La verificación rápida

Verifica solo Clientell para un estado rápido.

claude mcp get clientell

Lo que deberías ver: Estado: ✔ conectado Ámbito: Configuración de usuario (disponible en todos tus proyectos) Tipo: http URL: https://mcp.clientell.ai/mcp

Si algo está mal, las versiones recientes de Claude Code imprimen una línea Issue: con el estado HTTP y el texto de error propio del servidor. Esa línea es lo más útil de esta página cuando estás atascado; llévala a Solución de problemas.

La verificación completa

Verifica cada servidor MCP configurado. Esto puede tardar de 30 a 60 segundos, o más si otro servidor no responde.

claude mcp list

Lo que deberías ver: clientell: https://mcp.clientell.ai/mcp (HTTP) - ✔ Conectado

Y cuando no funciona, la misma línea termina de manera diferente: clientell: https://mcp.clientell.ai/mcp (HTTP) - ✘ Error al conectar — <reason>

Cada estado que esto puede informar

✔ Conectado

Listo para usar.

! Conectado · falló la obtención de herramientas

La conexión se abrió pero la lista de herramientas no regresó. Ejecuta claude mcp get clientell para obtener el detalle.

! Requiere autenticación

El servidor es accesible y solicita una credencial que no recibió.

✘ Error al conectar

Sin respuesta utilizable. Una razón generalmente sigue al guion.

✘ Error de conexión

El intento lanzó una excepción. Claude Code no añade detalle a este.

⏸ Aprobación pendiente

Un servidor con ámbito de proyecto esperando aprobación. No verás esto si usaste --scope user.

en caché · se conecta en el primer uso

No es un error. Claude Code recordó la lista de herramientas de una sesión anterior y se conectará cuando preguntes algo por primera vez.

En consolas antiguas de Windows, las marcas se muestran como √ y × en lugar de ✔ y ✘. Mismos significados.

Dentro de una sesión

Inicia Claude Code y escribe /mcp. Verás clientell listado con sus herramientas.

Comportamiento de reconexión que vale la pena conocer

Un error 5xx o una conexión caída se reintenta automáticamente con retroceso, por lo que las fallas transitorias a menudo se resuelven solas. Los errores de autenticación y de no encontrado nunca se reintentan; esos necesitan un cambio de configuración, por lo que fallan al instante y permanecen fallidos.

Comienza con un campo que necesitas cambiar.

Haz a tu cliente de IA una pregunta en lenguaje natural sobre tu organización. Él elige las herramientas relevantes y responde desde el grafo.

• ¿Qué escribe en Opportunity.Amount?Encuentra flujos, Apex, reglas de validación y procesos que tocan este campo antes de editarlo.
• ¿Qué se rompe si elimino Account.Custom_Segment__c?Verifica referencias y componentes afectados antes de eliminar el campo.
• Muéstrame cada flujo en Case que se dispara después de guardar.Compara la automatización posterior al guardado en un objeto.
• ¿Qué perfiles pueden editar Contact.Email?Inspecciona el acceso a campos en perfiles y conjuntos de permisos. Qué hizo eso realmente

Estas preguntas leen nombres de metadatos, identificadores y relaciones, no registros de clientes. Si procedes con un cambio, Clientell lo parchea y audita, y tu cliente de IA ejecuta el despliegue aprobado a través de tu propia sesión de sf.

Una primera pregunta contra un grafo en frío puede tardar un tiempo. Si pasa de unos dos minutos, Claude Code lo mueve a una tarea en segundo plano y te lo indica. Las respuestas se dimensionan para ajustarse al contexto de tu cliente de IA, y una respuesta dimensionada lo indica e informa el recuento completo. Haz una pregunta más específica o navega por páginas para obtener más.

Elige la organización antes de confiar en la respuesta.

¿Trabajas entre producción y sandboxes? Establece la organización activa para que las respuestas de dependencias provengan del índice que pretendías.

Dos verificaciones mantienen explícita la selección de organización:

• Si no se le dijo en qué organización estás trabajando, lo indica en su respuesta en lugar de elegir una por ti.
• Si la organización que seleccionaste y la organización a la que pertenece tu token resuelven a índices diferentes, rechaza la solicitud en lugar de elegir entre ellas.

Establece la organización para la sesión con clientell_set_active_org. Ocurre en la conversación, no en un archivo de configuración; le pides al cliente que cambie de organización y él llama a la herramienta. Para ver a qué estás autenticado localmente:

sf org list

Contexto de Salesforce, más el trabajo que lo rodea.

Salesforce proporciona el mapa de metadatos. Once conectores más leen el trabajo que lo rodea, en vivo, al momento de la pregunta: Slack, Jira, GitHub, Gmail, Google Calendar, Google Drive, Notion, Microsoft Teams, SharePoint, Outlook Mail y Outlook Calendar. Cada uno lee como tú, a través de tu propia concesión. Salesforce lectura Slack lectura + escritura Jira lectura + escritura GitHub lectura + escritura Gmail lectura Google Calendar lectura Google Drive lectura Notion lectura Microsoft Teams lectura SharePoint lectura Outlook Mail lectura Outlook Calendar lectura

En el centro

Salesforce lectura

Conectados alrededor

• Slack lectura + escritura
• Jira lectura + escritura
• GitHub lectura + escritura
• Gmail lectura
• Google Calendar lectura
• Google Drive lectura
• Notion lectura
• Microsoft Teams lectura
• SharePoint lectura
• Outlook Mail lectura
• Outlook Calendar lectura

Doce conectores, todos leen en vivo cuando lo pides.

Conector	Acceso	Estado	Qué puedes pedir	Notas
Salesforce	Lectura	En vivo	El grafo de la organización: objetos, campos, flujos, Apex, reglas de validación, perfiles y conjuntos de permisos, además de las referencias entre ellos. Lecturas en vivo de registros, Tooling API, describe y límites cuando lo pides.	El grafo no contiene contenidos de registros. Clientell parchea y audita los cambios, deploy_guard rechaza cargas inseguras de tipo reemplazar-no-combinar en los despliegues que prepara, y tu cliente de IA despliega a través de tu propia sesión de sf después de que lo apruebes.
Slack	Lectura + escritura	En vivo	Historial de canales, búsqueda de mensajes y listas de canales, leídos en vivo como tú. Envía un mensaje o añade una reacción.	Las escrituras pasan por los controles de aprobación de herramientas de tu cliente de IA, así que tú defines la política de confirmación. Consulta la nota debajo de la tabla.
Jira	Lectura + escritura	En vivo	Consulta y búsqueda de incidencias, por texto o JQL, leídas en vivo. Comenta una incidencia o muévela a otro estado del flujo de trabajo.	Las escrituras pasan por los controles de aprobación de herramientas de tu cliente de IA.
GitHub	Lectura + escritura	En vivo	Busca repositorios, incidencias y PRs, abre un PR o incidencia, y lista los PRs que te esperan. Comenta en un PR o incidencia.	Los comentarios se publican a través de la Clientell GitHub App, así que instálala primero en la organización del repositorio. Las escrituras pasan por los controles de aprobación de herramientas de tu cliente de IA.
Gmail	Lectura	En vivo	Busca y abre mensajes y borradores, leídos en vivo.
Google Calendar	Lectura	En vivo	Tu agenda, búsqueda de eventos y eventos individuales, leídos en vivo.
Google Drive	Lectura	En vivo	Búsqueda de archivos, metadatos de archivos y texto de archivos, leídos en vivo.
Notion	Lectura	En vivo	Búsqueda, contenido de páginas y filas de bases de datos, leídos en vivo.
Microsoft Teams	Lectura	En vivo	Búsqueda de mensajes, historial de canales y mensajes individuales, leídos en vivo.
SharePoint	Lectura	En vivo	Búsqueda de archivos, metadatos de archivos y texto de archivos, leídos en vivo.
Outlook Mail	Lectura	En vivo	Busca y abre mensajes y borradores, leídos en vivo.
Outlook Calendar	Lectura	En vivo	Tu agenda, búsqueda de eventos y eventos individuales, leídos en vivo.

En vivo

Disponible hoy. Lee el sistema de origen en el momento de la pregunta, a través de tu propia concesión, así que las respuestas son actuales por diseño.

Lectura

Lee el sistema de origen cuando lo pides. No expone ninguna acción que cambie nada allí.

Lectura + escritura

También realiza acciones en el sistema de origen, como publicar un mensaje o un comentario. La configuración de aprobación de herramientas de tu cliente de IA decide cuándo te pregunta primero.

Tú defines la política de confirmación para las escrituras de los conectores

Slack, Jira y GitHub pueden realizar acciones: enviar un mensaje o reacción de Slack, comentar o transicionar una incidencia de Jira, comentar en un PR o incidencia de GitHub. Estas acciones pasan por los controles de aprobación de herramientas de tu propio cliente de IA, así que tú decides si cada una pregunta primero (consulta Claude Code, Cursor o la documentación de tu cliente).

Para los despliegues de Salesforce, Clientell parchea y audita el cambio. Después de que lo apruebes, tu cliente de IA ejecuta el despliegue a través de tu propia sesión de sf. Cuando Clientell prepara el despliegue, el guardián de despliegue rechaza cargas inseguras de tipo reemplazar-no-combinar para Perfiles, Conjuntos de Permisos y Reglas de Compartición.

Herramientas de conectores

• list_connector_capabilitiesLista tus proveedores conectados, su estado, y las acciones y argumentos que use_connector acepta para cada uno.
• use_connectorEjecuta una lectura o acción en vivo en un proveedor conectado a través de tu propia cuenta. Salesforce, cuando aparece, es de solo lectura: consulta, describe y límites.

Llama a los doce conectores directamente a través de MCP desde tu cliente. No se requiere una superficie de agente separada.

Encuentra dependencias, planifica cambios, verifica el impacto.

Estas nueve herramientas responden preguntas sobre la organización, redactan cambios y aportan contexto. El servidor parchea y audita los cambios propuestos; después de la aprobación, tu cliente de IA despliega a través de tu propia sesión de sf. La herramienta de fusión de registros duplicados demuestra que una fusión es segura antes de que se elimine nada. /mcp también lista las herramientas de configuración a continuación y las herramientas de conectores activas.

Trabajo de Salesforce · 9 Configuración · 11 01 Encuentra dependencias qué toca qué, y por qué search_salesforce_metadata search_team_context find_person_in_salesforce_and_work 02 Verifica el impacto informes de impacto, auditoría y acceso generate_salesforce_org_report 03 Planifica cambios orientación, borradores, planes de fusión e informes get_salesforce_best_practices search_salesforce_docs build_or_fix_salesforce_flow merge_duplicate_records manage_salesforce_reports_dashboards 04 Conecta y selecciona organizaciones, integraciones, estado del índice clientell_onboarding_status clientell_connect_salesforce clientell_set_active_org clientell_add_integration 05 Cuenta facturación, plan, tus datos clientell_billing_status clientell_upgrade clientell_delete_my_data 06 Memoria y playbooks contexto guardado, vínculos de identidad, playbooks clientell_remember clientell_confirm_person_link clientell_push_work_records run_clientell_playbook

Trabajo de Salesforce · 9

01 · Encuentra dependencias

• search_salesforce_metadata
• search_team_context
• find_person_in_salesforce_and_work

02 · Verifica el impacto

• generate_salesforce_org_report

03 · Planifica cambios

• get_salesforce_best_practices
• search_salesforce_docs
• build_or_fix_salesforce_flow
• merge_duplicate_records
• manage_salesforce_reports_dashboards

Configuración · 11

04 · Conecta y selecciona

• clientell_onboarding_status
• clientell_connect_salesforce
• clientell_set_active_org
• clientell_add_integration

05 · Cuenta

• clientell_billing_status
• clientell_upgrade
• clientell_delete_my_data

06 · Memoria y playbooks

• clientell_remember
• clientell_confirm_person_link
• clientell_push_work_records
• run_clientell_playbook

Las herramientas de Salesforce y de configuración, agrupadas por la tarea que realizan. Las dos herramientas de conectores se listan en Conectores.

• search_salesforce_metadataRastrea objetos, campos, flujos, reglas y permisos. Ve de qué depende un componente antes de cambiarlo, con secciones de auditoría seleccionadas cuando sea necesario.
• get_salesforce_best_practicesObtén orientación validada antes de crear un Flow, escribir una regla de validación o cargar datos.
• build_or_fix_salesforce_flowRedacta un Flow a partir de una solicitud en lenguaje natural o diagnostica un error en tiempo de ejecución y propón una solución. Clientell aplica parches y audita el cambio; los despliegues aprobados se ejecutan a través de la sesión sf de tu propio cliente de IA.
• search_salesforce_docsEncuentra la documentación relevante de Salesforce y cita la guía de origen.
• generate_salesforce_org_reportGenera un informe de impacto, auditoría o acceso que puedas inspeccionar y compartir.
• search_team_contextBusca en el correo electrónico, Slack, Jira, reuniones y documentos de tu equipo las personas y decisiones detrás de un cambio en Salesforce, además del contexto guardado con clientell_remember.
• find_person_in_salesforce_and_workEncuentra a una persona en Salesforce y en el contexto de correo electrónico, Slack y Jira de tu equipo, y di con una confianza explícita si los registros son el mismo humano. Solo una coincidencia exacta de correo electrónico vincula automáticamente; cualquier cosa más débil vuelve como una pregunta para ti.
• merge_duplicate_recordsEncuentra Cuentas, Contactos o Prospectos duplicados, verifica cada ID de registro contra la organización y redacta un plan de fusión que pueda demostrar que es seguro antes de eliminar cualquier cosa. La fusión se ejecuta a través de tu propia sesión sf.
• manage_salesforce_reports_dashboardsCrea, actualiza, ejecuta o elimina Informes y Paneles nativos de Salesforce, incluidos los informes combinados. Verifica cada informe contra las columnas reales del tipo de informe y devuelve el comando sf exacto. Tú lo ejecutas. Plomería

Usa estas herramientas /mcp para conectar y seleccionar una organización, agregar integraciones, gestionar facturación y memoria, confirmar vínculos de identidad, ejecutar playbooks y eliminar datos del espacio de trabajo.

• clientell_onboarding_statusVerifica los sistemas conectados y si se ha creado el índice de tu espacio de trabajo.
• clientell_connect_salesforceConecta una organización de Salesforce desde tu terminal cuando aún no hay ninguna conectada. Devuelve un enlace que abres en el navegador, y luego una segunda llamada confirma la conexión.
• clientell_set_active_orgEstablece con qué organización de Salesforce trabaja la sesión. Consulta Elegir la organización correcta.
• clientell_add_integrationConecta Slack, Gmail o Jira a tu espacio de trabajo. Devuelve un enlace de autorización, y luego una segunda llamada confirma la conexión.
• clientell_billing_statusInforma el estado de facturación de tu espacio de trabajo.
• clientell_upgradeInicia una suscripción MCP ($249/mes) o Platform ($500/mes) a través de Stripe Checkout, o abre el portal de facturación si ya estás suscrito. No se cobra nada hasta que completes el pago.
• clientell_delete_my_dataElimina los datos que se guardan para ti. Consulta Desinstalación y eliminación de datos.
• clientell_rememberGuarda contexto de trabajo explícitamente. No se almacena nada automáticamente de tu actividad.
• clientell_confirm_person_linkRegistra tu respuesta cuando find_person_in_salesforce_and_work pregunta si dos registros son la misma persona, para que no se vuelva a preguntar. Un vínculo incorrecto se puede deshacer.
• clientell_push_work_recordsPuente de demostración, no una sincronización en vivo: indexa registros de Gmail, Jira o proyectos SFDX locales que tu cliente de IA ya haya leído. Solo se aceptan campos de índice, nunca cuerpos de mensajes ni contenido de archivos.
• run_clientell_playbookEjecuta un playbook de Clientell con nombre, como standup o plan_data_load, para clientes que no pueden mostrar los prompts MCP de este servidor.

Conecta a una persona entre sistemas de trabajo.

Vincula un Usuario de Salesforce, un miembro de Slack y una cuenta de Jira cuando sus identificadores comparten una señal. Usa esa asociación para seguir el trabajo relacionado entre sistemas conectados.

Salesforce User 005Hs00000A1bC2 Slack Member U04F2K9QZ Jira Account 5b10ac8d82e05b22 Email Address dana@acme.com DR one person Dana Reyes

Dana Reyes una persona

vinculada a

• Salesforce User 005Hs00000A1bC2
• Slack Member U04F2K9QZ
• Jira Account 5b10ac8d82e05b22
• Email Address dana@acme.com

Clientell vincula a la misma persona entre las herramientas que usa tu equipo.

Usa las asociaciones como contexto, no como control de acceso

La cobertura depende de las señales que expone cada sistema conectado. Las identidades sin señal compartida pueden permanecer separadas. Las asociaciones no son completas ni verificadas en cuanto a precisión para cada persona en cada organización.

Verifica la identidad en el sistema de origen antes de tomar una decisión de acceso. Una asociación es contexto, no prueba de identidad.

Conserva las decisiones que vale la pena mantener.

Registra por qué hiciste un cambio y luego encuentra ese contexto en una conversación posterior. Tú o el modelo deben llamar explícitamente a clientell_remember para guardar una entrada.

01 Remember a fact is saved 02 Correct new version, old one kept 03 Expire stops being used v1 · saved APAC leads go to Priya valid until 31 Dec 2026 v1 · kept in history APAC leads go to Priya v2 · current APAC leads go to Sam valid until 31 Dec 2026 v2 · expired APAC leads go to Sam passed 31 Dec 2026 no longer returned to the model

1. 01 · Remember v1 · saved APAC leads go to Priya valid until 31 Dec 2026
2. 02 · Correct v2 · current APAC leads go to Sam valid until 31 Dec 2026 v1 · kept in history APAC leads go to Priya
3. 03 · Expire v2 · expired APAC leads go to Sam passed 31 Dec 2026. No longer returned to the model.

La memoria conserva lo que eliges, mantiene su historial y expira según lo programado.

Tú controlas lo que se guarda

La memoria no aprende tu flujo de trabajo automáticamente ni infiere entradas de tu actividad. Cada escritura es explícita. Las versiones anteriores siguen siendo inspeccionables, pero el versionado no restaura un estado anterior ni revierte un cambio.

Encuentra el error. Da el siguiente paso.

Comienza verificando si el endpoint responde. Luego compara el estado o error a continuación con una solución específica.

curl -I https://mcp.clientell.ai/mcp

Cómo leer el código de respuesta 404 o 405 el servidor está activo — los endpoints MCP responden a POST, no a HEAD 401 o 403 el servidor está activo y quiere un token válido sin respuesta URL incorrecta, DNS o algo en tu red

En Windows PowerShell, usa curl.exe, el curl simple es un alias de otra cosa y acepta argumentos diferentes.

✘ Failed to connect — HTTP 401 Qué significa

El token falta, expiró o no es uno que este servidor acepte.

Solución

La causa más común es invisible: un espacio al principio o al final del token pegado. Claude Code lo nota y advierte Leading or trailing whitespace in: headers.Authorization pero no lo recorta, y envía el valor exactamente como está escrito. Elimina el servidor, vuelve a copiar el token con cuidado y agrégalo de nuevo.

De lo contrario, obtén un token nuevo de tu espacio de trabajo y vuelve a agregarlo. Un token rechazado es definitivo; Claude Code informa la conexión como fallida en lugar de recurrir a un inicio de sesión en el navegador.

Claude Code advierte sobre espacios en blanco en headers.Authorization

Tu token tiene un espacio, tabulación o nueva línea en un extremo. Esto ocurre al copiar desde una página web y es una de las formas más comunes en que falla esta instalación.

Elimina y vuelve a agregar el servidor con un pegado limpio. Claude Code nombra el campo pero nunca muestra el valor, por lo que no puedes corregirlo leyendo la advertencia.

claude mcp remove clientell -s user

MCP endpoint not found cuando seleccionas el servidor en /mcp Qué significa

La URL en tu configuración no apunta al endpoint. El mensaje informa solo el nombre de host, nunca la ruta, lo que oculta la causa real.

Solución

Verifica que tu URL termine en /mcp. La dirección completa es https://mcp.clientell.ai/mcp. Omitir ese sufijo es la razón habitual de este mensaje.

! Connected · tools fetch failed Qué significa

La conexión se abrió, pero la solicitud de la lista de herramientas no regresó. El servidor es accesible; algo falló después de eso.

Solución

Ejecuta claude mcp get clientell y lee la línea Issue:, que contiene el estado HTTP y el texto de error del servidor. Lee esa salida y redacta cualquier información sensible antes de compartirla con alguien, aquí o en otro lugar.

✘ Failed to connect — HTTP 421, o cada solicitud falla de manera idénticaNuestro problema para solucionar Qué significa

El servidor rechazó la solicitud debido a un problema de configuración del nombre de host de nuestro lado.

Solución

Contáctanos con el código de estado y el nombre de host del endpoint. Arreglaremos la configuración del servidor.

✘ Failed to connect — ConnectionRefused Qué significa

Nada está escuchando en esa dirección.

Solución

Verifica el nombre de host en la configuración de tu cliente. Si alojas el servidor tú mismo, verifica que esté escuchando en la dirección configurada.

Agregaste el servidor, pero claude mcp list no lo muestra Qué significa

La entrada tiene un url pero no un "type", por lo que Claude Code lo leyó como un comando local para ejecutar, no encontró ninguno y lo omitió sin informar nada.

Solución

Agrega "type": "http" a la entrada, o elimina el servidor y vuelve a agregarlo con el comando JSON en la Etapa 3, que lo incluye.

No MCP servers configured en un proyecto donde sabes que lo agregaste Qué significa

El servidor se agregó en el ámbito predeterminado, que lo vincula al único directorio en el que estabas cuando ejecutaste el comando.

Solución

Elimínalo y vuelve a agregarlo con --scope user. El ámbito se fija cuando se agrega el servidor; volver a ejecutar add sin eliminarlo primero fallará.

MCP server clientell already exists in user config, justo después de que lo eliminaste La eliminación no se aplicó. claude mcp get imprime el alcance como una oración ("User config (available in all your projects)"), pero remove -s solo acepta la forma corta.

Pasa la forma corta exactamente:

claude mcp remove clientell -s user

Todo expira después de unos 60 segundos Qué significa

El límite predeterminado por solicitud de Claude Code. Una primera consulta contra un gráfico de organización en frío puede superarlo.

Solución

Establece un timeout por servidor; el comando JSON en la Etapa 3 lo hace por ti con "timeout": 180000. Los valores por debajo de 1000 se ignoran, por lo que un número pequeño es lo mismo que ningún número.

La respuesta parece corta, o un recuento parece demasiado bajo Qué significa

Las respuestas se dimensionan para ajustarse al contexto de tu cliente de IA. Cuando el servidor dimensiona un resultado, lo indica y reporta el recuento real de filas junto con las filas que devolvió. Claude Code también recorta la salida de herramientas muy grande por su cuenta, sin un marcador.

Solución

Haz una pregunta más específica o navega por páginas para obtener más. Si el resultado indica que se redujo el tamaño, usa el recuento reportado, no el número de filas que puedes ver.

Un informe generado termina a mitad de frase Qué significa

El documento es más grande que el tamaño que cabe en el contexto de tu cliente. El resultado incluye una nota que indica cuántos caracteres se omitieron.

Solución

Vuelve a ejecutarlo con un alcance más reducido, como un objeto o un perfil a la vez. Comparte el informe una vez que llegue completo, con su estructura de cierre intacta.

Una respuesta omite algo que sabes que existe en la organización Qué significa

Con mayor frecuencia, el gráfico se construyó por última vez antes de que se creara ese componente. Cada respuesta del gráfico incluye su hora de last_graph_build, para que puedas comparar.

Solución

Reconstruye con clientell_set_active_org (sin argumentos) y vuelve a preguntar, o ejecuta la verificación en vivo que vino con la respuesta. Consulta clientell_onboarding_status si no estás seguro de si la primera construcción ha terminado. Ver Freshness.

El índice de la organización no existe, o la solicitud se rechaza porque dos organizaciones no coinciden Qué significa

O bien aún no se ha construido un índice para esa organización, o la organización en la que trabajas y la organización a la que pertenece tu token apuntan a índices diferentes. En el segundo caso, el servidor rechaza en lugar de elegir uno.

Solución

Ambos errores indican qué se buscó. Establece la organización explícitamente con clientell_set_active_org y consulta Picking the right org. Si nunca se ha construido un índice para esa organización, envíanos el texto del error.

Un conector está autorizado pero sus herramientas no devuelven nada Qué significa

Los conectores leen el sistema de origen en vivo, como tú, por lo que devuelven solo lo que tu propia cuenta en ese sistema puede ver. Dos causas probables: una consulta que no coincide con nada, o una autorización que ha expirado.

Solución

Prueba la misma búsqueda en el sistema de origen con tu propia cuenta. Si encuentra resultados allí, vuelve a conectar el conector desde tu espacio de trabajo y vuelve a preguntar. Consulta Connectors para ver qué lee cada uno.

La conexión a Salesforce falla con external_app_not_installed Qué significa

El paquete administrado Clientell AI no está instalado en la organización a la que te estás conectando. Salesforce reporta esto como OAUTH_EC_APP_NOT_FOUND: la aplicación que se está autorizando no existe en esa organización, por lo que la pantalla de consentimiento no tiene nada que otorgar.

Solución

Instala el paquete en la organización a la que te estás conectando, production o sandbox, y luego ejecuta la conexión nuevamente. Tarda unos dos minutos y nada de lo que hiciste antes necesita rehacerse.

Instalar un paquete administrado es una acción de administrador, por lo que si no eres administrador en esa organización, este es el paso que necesita a otra persona. Es la razón más común por la que falla una primera conexión, por eso es Check 5 en los requisitos previos y no solo aquí.

Verifica qué organización estás conectando antes de concluir que la instalación falló. El paquete se instala por organización, por lo que una sandbox puede no tenerlo mientras que producción sí lo tiene, y el error se ve idéntico en ambos casos.

La conexión a Salesforce falla con oauth_session_mismatch Qué significa

Para una conexión iniciada desde la terminal, la cuenta de Clientell con la que iniciaste sesión en tu navegador no coincide con la cuenta que inició la conexión. La conexión no puede continuar con una cuenta diferente.

Solución

Inicia sesión en Clientell en este navegador con la cuenta que usa tu agente de codificación. Luego pide a tu agente de codificación un nuevo enlace de conexión y ábrelo en este mismo perfil de navegador.

Iniciar sesión por sí solo no revive el intento anterior. El registro de conexión es de un solo uso, por lo que aún necesitas un nuevo enlace desde tu terminal después de corregir la cuenta.

La conexión a Salesforce falla con connect_expired Qué significa

El enlace de conexión generado por la terminal ha expirado o ya se usó. Los enlaces de conexión son de un solo uso, y una conexión pendiente expira después de 30 minutos.

Solución

Vuelve a tu terminal y pide a tu agente de codificación que conecte Salesforce nuevamente. Abre el nuevo enlace en este mismo navegador y completa el paso de Salesforce sin dejarlo abierto demasiado tiempo.

No reutilices el enlace anterior ni inicies una conexión separada desde el navegador. Una conexión nueva solo desde el navegador no puede completar el protocolo de enlace que tu terminal está esperando.

La conexión a Salesforce falla con authorization_expired Qué significa

El inicio de sesión en Salesforce tardó demasiado. El enlace de conexión se abrió a tiempo, pero el paso de autorización de Salesforce superó su ventana de diez minutos.

Solución

Pide a tu agente de codificación un nuevo enlace de conexión. Ten listos tu contraseña de Salesforce y tu dispositivo MFA primero, luego completa el inicio de sesión en Salesforce dentro de diez minutos sin pausas.

Reinicia desde el nuevo enlace generado por la terminal, no desde una conexión separada solo del navegador. El intento anterior no se puede reanudar después de que expire la ventana de autorización.

sf org list muestra tu organización como expirada, o los comandos sf comienzan a fallar

Tu sesión de Salesforce caducó. Esa sesión vive en tu máquina y nunca la vemos, por lo que no podemos renovarla por ti.

sf org login web

claude plugin marketplace add devuelve un 404 Qué significa

Clientell se registra como un servidor MCP HTTP, no como un mercado de plugins de Claude.

Solución

Usa la configuración de esta página. Es la única ruta compatible.

Desconecta el cliente. Elimina los datos del espacio de trabajo.

Elimina la entrada del servidor para dejar de usarlo en Claude Code. Elimina los datos que se guardan para ti por separado, luego revoca cualquier autorización de conector que ya no necesites.

Elimina el servidor

claude mcp remove clientell -s user

Qué elimina esto la entrada clientell en la configuración de usuario de Claude Code

Esto elimina la configuración del cliente, no tus datos del espacio de trabajo. El historial del shell y los registros del cliente pueden contener aún el token pegado durante la configuración. -s toma el alcance correspondiente: user, project o local.

Elimina tus datos

Antes de eliminar el servidor, pide a tu cliente que llame a clientell_delete_my_data para eliminar los datos que se guardan para ti. Eliminar una configuración de cliente no elimina sus datos subyacentes del espacio de trabajo.

Revoca también las conexiones

Eliminar datos no revoca una autorización OAuth. Revoca cada conector desde tu espacio de trabajo, o desde la configuración de aplicaciones conectadas del propio sistema de origen, si también quieres que la autorización desaparezca.

Respuestas rápidas antes de conectarte.

Encuentra los detalles clave sobre datos de registros, permisos del gráfico, implementación, conectores y clientes compatibles.

¿Clientell almacena nuestros datos de registros de Salesforce?

No. El gráfico indexa nombres, identificadores, metadatos y relaciones, nunca el contenido de los registros. Cuando pides registros en vivo, el servicio de autenticación de Clientell ejecuta una consulta de solo lectura en tu propia conexión de Salesforce, con tus permisos, y pasa las filas directamente a tu cliente. Nunca se escriben en el gráfico.

¿El gráfico aplica los permisos de Salesforce de cada persona?

El aislamiento del espacio de trabajo evita el acceso entre espacios de trabajo. Dentro de un espacio de trabajo, todos ven el mismo mapa de la organización: las consultas al gráfico no aplican los permisos individuales a nivel de registro o de campo de Salesforce de cada persona. Eso hace que la membresía del espacio de trabajo sea tu punto de control, así que tú decides quién está en el espacio de trabajo.

¿Puede Clientell implementar un cambio en Salesforce?

Sí, después de que lo apruebes. Clientell parchea y audita el cambio. Cuando Clientell prepara una implementación, deploy_guard la verifica y rechaza cargas útiles inseguras de tipo reemplazar-no-combinar para perfiles, conjuntos de permisos y reglas de uso compartido. Luego tu cliente de IA ejecuta la implementación a través de tu propia sesión autenticada de sf. Clientell nunca ve esa sesión. Para registros duplicados, merge_duplicate_records verifica cada ID de registro contra la organización y redacta un plan de combinación que puede demostrar que es seguro, por lo que la combinación se verifica antes de eliminar cualquier cosa. La combinación luego se ejecuta a través de tu propia sesión de sf.

¿Quién decide si una acción de Slack me pregunta primero?

Tú decides. Las acciones de Slack, como las acciones de Jira y GitHub, se ejecutan a través de los controles de aprobación de herramientas de tu propio cliente de IA, por lo que tú estableces la política de confirmación allí. Configúrala para que pregunte antes de cada escritura si eso es lo que tu equipo quiere.

¿Qué tan actualizado está el gráfico?

Siempre lo sabes. Cada respuesta del gráfico lleva su marca de tiempo de last_graph_build, y una llamada reconstruye el gráfico cuando quieras. Las respuestas de Flow, Apex y reglas de validación vienen con una verificación en vivo lista para ejecutar, para que puedas confirmar contra la organización en vivo con un comando antes de actuar. Los conectores leen en el momento de la pregunta, por lo que sus respuestas están actualizadas por diseño.

¿Qué conectores funcionan hoy?

Doce, todos leen en vivo cuando preguntas: Salesforce, Slack, Jira, GitHub, Gmail, Google Calendar, Google Drive, Notion, Microsoft Teams, SharePoint, Outlook Mail y Outlook Calendar. Slack, Jira y GitHub también pueden realizar acciones, como publicar un mensaje o un comentario.

¿Contra qué clientes MCP está verificado esto?

Clientell está construido y verificado de extremo a extremo en Claude Code. Funciona con cualquier cliente MCP Streamable HTTP, incluidos Cursor, VS Code, ChatGPT y Gemini, y la guía de configuración tiene fragmentos de configuración para los más comunes.

¿Los conectores están disponibles directamente a través de MCP, o solo dentro de tu agente?

Directamente a través de MCP. Tu cliente llama a los doce conectores como herramientas MCP ordinarias. No hay una superficie separada solo para agentes por la que tengas que pasar.

¿Qué recuerda el servidor entre conversaciones?

Solo lo que tú o el modelo escriben explícitamente. Las entradas se pueden corregir, cada escritura se guarda como una versión en lugar de sobrescribir la anterior, y las entradas tienen una caducidad basada en el tiempo. Nada se infiere de tu actividad y se almacena por su cuenta.

¿Cómo se protegen las credenciales almacenadas?

Las credenciales almacenadas se cifran con AES-256-GCM, con un nonce nuevo para cada escritura de almacenamiento.

¿Cuánto cuesta Clientell MCP?

Clientell MCP cuesta $249/mes para 10 personas en una organización de producción de Salesforce, luego $25/mes por persona adicional, con sandboxes ilimitadas. El plan Platform cuesta $500/mes para 3 personas con implementaciones y auditorías semanales de la organización. Todos los planes incluyen una prueba gratuita de 14 días sin necesidad de tarjeta de crédito. Consulta Pricing.

¿Cómo lo elimino y borro mis datos?

Elimina la entrada del servidor de tu cliente, luego llama a clientell_delete_my_data para eliminar los datos que se guardan para ti. Estas son acciones separadas. Revoca las conexiones OAuth por separado. El historial del shell o los registros del cliente pueden contener aún el token pegado durante la configuración. Consulta Uninstall and data deletion.

Cambios en este documento.

Cambios materiales en lo que afirma esta página. Las correcciones de redacción y tipografía no se enumeran.

• 26 Sep 2026 Enumera los doce conectores en vivo con sus niveles de acceso verificados. HubSpot ya no aparece. Explica la frescura del gráfico a través de last_graph_build y las verificaciones en vivo que vienen con las respuestas de Flow, Apex y reglas de validación.
• 25 Sep 2026 Aclara el flujo de trabajo de implementación de Salesforce aprobado, la protección de implementación y el límite de combinación de duplicados. La configuración incluye el requisito previo del paquete administrado y la ruta de recuperación de external_app_not_installed.
• Publicado por primera vez con pasos de configuración, estado de conectores, seguridad del gráfico, resolución de identidad y guía de memoria.

El estado de los conectores refleja lo que está disponible hoy. Los doce conectores enumerados están en vivo.