Clientell Salesforce MCP

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

Scope

Doze conectores, todos com leitura ao vivo. Salesforce, Slack, Jira, GitHub, Gmail, Google Calendar, Google Drive, Notion, Microsoft Teams, SharePoint, Outlook Mail e Outlook Calendar estão disponíveis hoje. Cada um lê o sistema de origem quando você solicita, por meio da sua própria autorização. Consulte a referência de conectores.

Conecte seu workspace e registre o servidor você mesmo. O guia de configuração usa o Claude Code, onde o Clientell é construído e verificado de ponta a ponta. Qualquer cliente MCP Streamable HTTP também funciona, incluindo Cursor, VS Code, ChatGPT e Gemini, e o guia tem trechos de configuração para os mais comuns.

Conteúdo · 19 seções

Conheça sua organização. Verifique a mudança. Mantenha o controle.

Pergunte ao seu cliente de IA o que depende de um campo, inspecione um registro ao vivo quando necessário e mantenha decisões entre conversas. O servidor MCP hospedado conecta essas três partes. Não há servidor local para instalar.

metadados índice leituras ao vivo, somente leitura na sua própria conexão implantações aprovadas Seu cliente de IA Claude Code, Cursor, VS Code Clientell MCP responde às suas perguntas Context Graph mapa de metadados da sua organização Sua CLI sf executa na sua máquina Organização Salesforce seus registros ficam aqui

Fazendo uma pergunta

1. Seu cliente de IA Claude Code, Cursor, VS Code
2. Clientell MCP responde às suas perguntas
3. Context Graph mapa de metadados da sua organização
4. índice de metadados
5. Organização Salesforce seus registros ficam aqui

Lendo registros ao vivo

1. Seu cliente de IA Claude Code, Cursor, VS Code
2. Clientell MCP somente leitura, nada é armazenado
3. via serviço de autenticação do Clientell, na sua própria conexão
4. Organização Salesforce seus registros ficam aqui

Implantando uma mudança

1. Seu cliente de IA Claude Code, Cursor, VS Code
2. Sua CLI sf executa na sua máquina
3. implantações aprovadas
4. Organização Salesforce seus registros ficam aqui

Seu cliente de IA pergunta ao Clientell. O Clientell responde a partir do Context Graph e lê registros ao vivo na sua própria conexão Salesforce. Mudanças aprovadas são implantadas por meio da sua própria CLI sf.

1 · O grafo

Rastreie dependências antes de alterar metadados.

Objetos, campos, fluxos, Apex, regras de validação, perfis e conjuntos de permissões, além das referências entre eles. Pergunte o que referencia um campo antes de alterá-lo. Reconstrua o grafo em uma única chamada sempre que quiser. Ele não contém conteúdos de registros.

2 · A sessão ao vivo

Verifique registros ao vivo com suas próprias permissões.

As consultas são executadas quando você solicita, por meio do serviço de autenticação do Clientell na sua própria conexão Salesforce. Os registros voltam diretamente para o seu cliente e nunca são gravados no grafo.

3 · Memória

Leve adiante o contexto que você escolher salvar.

Você ou o modelo escrevem entradas explicitamente. Correções, versões e expiração baseada em tempo mantêm esse contexto inspecionável. Nada é salvo automaticamente da sua atividade. Consulte Memória.

1 Rascunhe a mudança edite como metadados 2 Verifique o raio de impacto o que ela afeta 3 Sua aprovação você diz sim 4 Implante por meio da sua CLI sf na sua máquina 5 Verifique confirme que foi aplicado deploy_guard quando o Clientell prepara a implantação para Perfis, Conjuntos de Permissões e Regras de Compartilhamento: recusa cargas inseguras de substituir-em-vez-de-mesclar

1. Rascunhe a mudança edite como metadados
2. Verifique o raio de impacto o que ela afeta
3. Sua aprovação você diz sim
4. Implante por meio da sua CLI sf na sua máquina deploy_guard Quando o Clientell prepara uma implantação de Perfil, Conjunto de Permissões ou Regras de Compartilhamento, ele recusa cargas inseguras de substituir-em-vez-de-mesclar.
5. Verifique confirme que foi aplicado

Toda mudança é rascunhada, verificada quanto ao que afeta e implantada somente após sua aprovação. Quando o Clientell prepara uma implantação de Perfil, Conjunto de Permissões ou Regras de Compartilhamento, o deploy_guard recusa cargas que apagariam silenciosamente entradas existentes.

Chame todos os doze conectores diretamente via MCP a partir do seu cliente. Nenhum agente separado do Clientell é necessário.

Contexto profundo da organização, com limites claros.

Veja sobre o que seu cliente pode agir, onde os dados permanecem e quais salvaguardas se aplicam antes que uma mudança chegue ao Salesforce.

Indexado armazenado no Context Graph nomes IDs relacionamentos somente estrutura Leitura ao vivo buscado somente quando você solicita dados de registros sua conexão → sua organização como você, nunca armazenado Nunca armazenado não mantido pelo Clientell conteúdos de registros corpos de mensagens permanece na sua organização

1. Indexado armazenado no Context Graph
   • nomes
     • IDs
     • relacionamentos somente estrutura
2. Leitura ao vivo buscado somente quando você solicita
   • dados de registros por meio da sua própria conexão Salesforce, nunca armazenado
3. Nunca armazenado não mantido pelo Clientell
   • conteúdos de registros
     • corpos de mensagens permanece na sua organização

O grafo contém estrutura. Os dados de registros são lidos ao vivo e nunca armazenados.

O que ele faz

• Mapeia metadados e dependências do Salesforce para que você possa ver o que uma mudança afetaria antes de fazê-la.
• Lê registros ao vivo do Salesforce sob demanda, somente leitura, por meio do serviço de autenticação do Clientell na sua própria conexão e permissões do Salesforce. Os registros passam para o seu cliente e não são armazenados.
• Rascunha mudanças e verifica o raio de impacto delas. Após sua aprovação, seu cliente de IA implanta por meio da sua própria sessão da CLI do Salesforce. Quando o Clientell prepara uma implantação, o deploy_guard a verifica e recusa cargas inseguras de substituir-em-vez-de-mesclar para Perfis, Conjuntos de Permissões e Regras de Compartilhamento.
• Lê doze conectores ao vivo no momento da pergunta, por meio da sua própria autorização, para que as respostas dos conectores sejam atuais por design.
• Carimba cada resposta do grafo com o horário do último last_graph_build e combina respostas de Fluxo, Apex e regras de validação com uma verificação ao vivo pronta para execução.
• Fornece ferramentas para clientes compatíveis com MCP via Streamable HTTP com autenticação por bearer.
• Isola cada workspace de todos os outros. Dentro de um workspace, todos veem o mesmo mapa da organização, porque as consultas ao grafo não aplicam as permissões individuais de nível de registro ou de campo de cada pessoa. Você decide quem está no workspace.
• Mantém contexto de trabalho escrito explicitamente, com correções, versões e expiração.

Escolhas de design deliberadas

• Mantém conteúdos de registros do Salesforce e corpos de mensagens fora do índice. Os conectores os leem ao vivo quando você solicita.
• Deixa as implantações com você. As mudanças são executadas por meio da sua própria sessão local da CLI sf, que o Clientell nunca vê. As leituras de registros ao vivo são executadas somente como a pessoa que conectou a organização, para que um colega não possa ler por meio da sua conexão.
• Comprova que uma mesclagem de registros duplicados é segura antes que qualquer coisa seja excluída. O merge_duplicate_records verifica cada ID de registro na organização e rascunha o plano de mesclagem; a mesclagem em si é executada por meio da sua própria sessão sf.
• Coloca você no controle da política de confirmação para gravações de conectores. As ações do Slack, Jira e GitHub são executadas por meio dos controles de aprovação de ferramentas do seu próprio cliente de IA.
• Reconstrói o grafo do Salesforce sob demanda, em uma única chamada, sempre que você quiser, e informa o quão recente é cada resposta. Substituir, não mesclar seu deploy · 1 entrada org ativa, após o deploy Perfil Sales_Rep Conta · editar Conta · editar mantido Oportunidade · editar Caso · ler Lead · ler 3 entradas existentes excluídas silenciosamente deploy_guard recusa este payload O caminho seguro 1 Leia a definição ativa Sales_Rep exatamente como está agora 2 Mescle sua alteração Conta · editar junta-se às outras 3 3 Escreva a definição completa todas as 4 entradas, nada perdido deploy_guard deixa passar

Substituir, não mesclar

1. Seu deploy: Perfil Sales_Rep carrega 1 entrada: Conta · editar
2. substitui a definição inteira
3. Org ativa, após o deploy
   • Conta · editar, mantido
     • Oportunidade · editar excluído
     • Caso · ler excluído
     • Lead · ler excluído
4. deploy_guard recusa este payload aplica-se a Perfil, PermissionSet e SharingRules

O caminho seguro

1. 1. Leia a definição ativa Sales_Rep exatamente como está agora
2. 2. Mescle sua alteração Conta · editar junta-se às outras 3
3. 3. Escreva a definição completa todas as 4 entradas, nada perdido
4. deploy_guard deixa passar todas as 4 entradas, nada perdido

Exemplo ilustrativo. Quando o Clientell prepara um deploy, o deploy_guard recusa payloads que apagariam silenciosamente permissões ou regras de compartilhamento existentes.

Veja o raio de impacto antes de fazer uma alteração.

O Context Graph mapeia os componentes da sua org e suas referências. Pergunte o que depende de Account.Custom_Segment__c antes de excluí-lo. Obtenha os fluxos e permissões afetados pelo gráfico, não por uma série de chamadas de API ao vivo.

lê verifica ou exibe executa nele Account.Industry campo de lista de opções Fluxos Set_Account_Tier Classes Apex AccountService.cls Regras de validação Industry_Required Layouts de página Account Layout Relatórios Pipeline by Industry Relatórios Accounts by Industry

• Account.Industry campo de lista de opções

Anel 1: executa nele

• Fluxos Set_Account_Tier
• Classes Apex AccountService.cls

Anel 2: verifica ou exibe

• Regras de validação Industry_Required
• Layouts de página Account Layout

Anel 3: lê

• Relatórios Pipeline by Industry
• Relatórios Accounts by Industry

Exemplo ilustrativo. Antes de alterar um campo, veja tudo o que ele toca.

O índice

Veja as dependências sem copiar registros de clientes.

Pergunte qual fluxo toca um campo ou qual perfil alcança um objeto. O índice contém nomes, identificadores e relacionamentos, não conteúdos de registros Salesforce ou corpos de mensagens. Quando você precisar das palavras reais, os conectores as leem ao vivo do sistema de origem, como você.

O gráfico Salesforce

Consulte um gráfico Salesforce somente leitura.

As consultas usam o caminho de execução somente leitura do banco de dados. Uma consulta de gráfico não pode gravar no índice, então você pode inspecionar dependências sem alterar o mapa em que confia.

Sua org

Faça deploy com suas próprias credenciais Salesforce.

O Clientell aplica patches e audita uma alteração proposta. Após sua aprovação, seu cliente de IA executa o deploy por meio da sua própria sessão sf CLI, com suas permissões. O Clientell nunca vê essa sessão.

O que o gráfico indexa

Objetos, campos, fluxos, Apex, regras de validação, perfis e conjuntos de permissões, com suas referências. Pergunte qual fluxo grava em um campo, quais perfis podem editá-lo ou o que uma exclusão quebraria. O gráfico responde a perguntas estruturais sem ler registros de clientes.

pertence a grava referencia verifica lê concede acesso a concede acesso a Campos Account.Industry Objetos padrão + personalizado Fluxos acionados por registro Apex classes, triggers Regras de validação verificações no salvamento Relatórios e painéis Perfis acesso de linha de base Conjuntos de permissões acesso extra

O que se conecta a quê

• Campos pertencem a Objetos
• Fluxos gravam Campos
• Apex referencia Campos
• Regras de validação verificam Campos
• Relatórios leem Campos
• Perfis concedem acesso a Objetos e Campos
• Conjuntos de permissões concedem acesso a Objetos e Campos

O Context Graph mapeia a estrutura da sua org e cada link entre suas partes.

Como as alterações chegam ao Salesforce

O Clientell aplica patches à alteração proposta e audita seu impacto contra o gráfico. Quando o Clientell prepara um deploy, deploy_guard verifica e recusa payloads inseguros de substituir-não-mesclar para Perfis, Conjuntos de permissões e Regras de compartilhamento. Após sua aprovação, seu cliente de IA executa o deploy por meio da sua própria sessão sf, com suas credenciais e permissões. Mesclagens de registros duplicados recebem o mesmo cuidado: merge_duplicate_records verifica cada ID de registro contra a org e elabora um plano de mesclagem que pode provar ser seguro, para que a mesclagem seja verificada antes que qualquer coisa seja excluída. A mesclagem então é executada por meio da sua própria sessão sf.

1 Você pergunta em inglês simples “O que usa Industry?” 2 O Clientell percorre o gráfico segue cada link 3 Resposta com fontes e seu tempo de construção gráfico construído há 2h 4 Verificação ao vivo opcional de uma linha executa via seu sf CLI

1. Você pergunta em português simples “O que usa Industry?”
2. Clientell percorre o grafo segue cada link
3. Resposta com fontes e seu tempo de construção grafo construído há 2h
4. Verificação ao vivo opcional de uma linha executada via seu CLI sf

Exemplo ilustrativo. As respostas vêm do grafo, então são rápidas e mostram exatamente de onde vieram.

Saiba sempre quão recente é uma resposta.

Cada resposta do grafo carrega seu carimbo de data/hora last_graph_build. Reconstrua o grafo do Salesforce quando quiser com uma única chamada e confirme qualquer resposta sobre Flow, Apex ou regra de validação na organização ao vivo com um comando.

Chame clientell_set_active_org sem argumentos para reconstruir o grafo depois de alterar metadados. Respostas sobre Flows, classes Apex, regras de validação e outros componentes vêm com um comando sf pronto para executar que verifica se eles mudaram na organização ao vivo desde a última construção. Conectores leem o sistema de origem no momento da pergunta, então suas respostas são atuais por design. Consultas ao vivo de registros do Salesforce são executadas quando você pergunta, por meio do serviço de autenticação da Clientell na sua própria conexão e permissões do Salesforce. Os registros passam para o seu cliente e não são armazenados.

construído 09:00 Grafo construído a partir dos metadados da sua organização resposta · construído 09:00 Cada resposta carimbada com seu tempo de construção comparado com a organização ao vivo Verificação ao vivo antes de agir um comando, contra sua organização construído 14:30 Reconstrução sob demanda quando você quiser reconstrução: um novo tempo de construção

Saiba sempre quão recente é uma resposta

1. Grafo construído a partir dos metadados da sua organização construído 09:00
2. Cada resposta carimbada com seu tempo de construção resposta · construído 09:00
3. Verificação ao vivo antes de agir um comando, contra sua organização comparado com a organização ao vivo
4. Reconstrução sob demanda quando você quiser construído 14:30 reconstrução: um novo tempo de construção, de volta ao início

Exemplo ilustrativo com horários de amostra. Cada resposta carrega seu tempo de construção, e um comando verifica isso contra sua organização ao vivo.

O que isso significa na prática

Acabou de adicionar um campo? Verifique o tempo de last_graph_build da resposta. Se o campo for mais novo, reconstrua e pergunte novamente, ou execute a verificação ao vivo que veio com a resposta antes de agir com base nela.

Seu workspace é isolado. Seu CLI continua sendo seu.

Verifique quem pode consultar o grafo, como gravações são aprovadas e quais credenciais a Clientell armazena antes de conectar uma organização de produção.

Seu workspace todos nele veem o mesmo mapa AK JL MR SP um mapa de organização compartilhado Outro workspace seu próprio mapa de organização Outro workspace seu próprio mapa de organização selado

Seu workspace

• AK
• JL
• MR
• SP

todos veem o mesmo mapa

Um mapa de organização compartilhado um mapa para todo o workspace

nada cruza

Outro workspace seu próprio mapa de organização

Outro workspace seu próprio mapa de organização

Cada workspace é selado de todos os outros. Dentro de um, todos compartilham o mesmo mapa de organização, então você decide quem está no workspace.

Escopos do grafo e isolamento

Escopos de grafo privado, de organização e compartilhado usam destinos separados. O isolamento do workspace impede acesso entre workspaces. Dentro de um workspace, todos veem o mesmo mapa de organização, então você decide quem está no workspace. Consultas ao grafo não aplicam as permissões individuais de nível de registro ou de campo do Salesforce de cada pessoa. Adicione as pessoas que devem compartilhar essa visão da organização.

Como ler isso

Um colega pode perguntar sobre a estrutura de um campo no grafo compartilhado mesmo que o Salesforce ocultasse esse campo dele. A associação ao workspace é seu ponto de controle, então conceda-a da mesma forma que concederia acesso aos metadados da organização.

Ações de gravação

Slack, Jira e GitHub podem executar ações: enviar uma mensagem, comentar ou mover um problema. Essas ações passam pelos controles de aprovação de ferramentas do seu próprio cliente de IA, então você define a política de confirmação lá. Implantações do Salesforce seguem um caminho diferente: a Clientell aplica patches e audita a mudança, recusa payloads inseguros de substituir-em-vez-de-mesclar que é solicitada a preparar, e seu cliente de IA usa sua própria sessão sf para implantar após sua aprovação.

Armazenamento de credenciais

Credenciais armazenadas usam criptografia AES-256-GCM com um nonce novo a cada gravação. A conexão do Salesforce que você autoriza é armazenada dessa forma e serve suas leituras ao vivo apenas para você, nunca para um colega. Sua sessão do Salesforce CLI, que executa implantações, permanece na sua máquina e nunca é visível para a Clientell.

Use o cliente MCP em que você trabalha.

A Clientell expõe ferramentas e instruções via Streamable HTTP MCP com autenticação bearer. É construída e verificada de ponta a ponta no Claude Code e funciona com qualquer cliente Streamable HTTP MCP, incluindo Cursor, VS Code, ChatGPT e Gemini.

VerificadoClaude Code

Construído e verificado de ponta a ponta contra este servidor. Siga o guia de configuração para os comandos exatos do Claude Code.

CompatívelChatGPT, Copilot, Cursor, Gemini, VSCode, LibreChat, OpenCode, Windsurf

Esses clientes falam o mesmo Streamable HTTP MCP. Registre o servidor com a sintaxe de adicionar servidor de cada cliente; o guia de configuração tem trechos de configuração para os comuns.

Esta não é uma lista de permissões. Qualquer cliente que suporte Streamable HTTP MCP com autenticação bearer pode registrar o servidor. Claude Code é o cliente contra o qual a Clientell constrói e verifica de ponta a ponta.

Conecte o Salesforce e faça sua primeira pergunta.

Autorize o Salesforce, construa seu primeiro Context Graph e registre a Clientell no seu cliente MCP. Os comandos trabalhados abaixo são para Claude Code.

1 Conecte o Salesforce entre na sua organização 2 Construa o grafo mapeia seus metadados 3 Adicione ao seu cliente de IA Claude Code, Cursor, VS Code 4 Faça sua primeira pergunta “O que usa Industry?”

1. Conecte o Salesforce entre na sua organização
2. Construa o grafo mapeia seus metadados
3. Adicione ao seu cliente de IA Claude Code, Cursor, VS Code
4. Faça sua primeira pergunta “O que usa Industry?”

Da conexão à primeira resposta em quatro etapas.

Antes de começar

Claude Code, instalado e conectado

claude --version

Espere: uma string de versão.

Se ausente: instale-o a partir do quickstart da Anthropic. Não hospedamos nosso próprio instalador.

O Salesforce CLI

sf --version

Espere: uma linha começando com @salesforce/cli/.

Se ausente: instale-o a partir do Salesforce. sf não é necessário para registrar o servidor hospedado ou fazer perguntas ao grafo, e consultas ao vivo de registros passam pela sua conexão Clientell Salesforce. Mantenha-o autenticado para verificações ao vivo e implantações aprovadas do Salesforce, que passam pela sua própria sessão CLI.

Uma organização à qual você está autenticado

sf org list

Espere: pelo menos uma organização, não marcada como (expired).

Se ausente ou expirada: execute sf org login web. Uma sessão expirada ainda aparece na lista e ainda falha no momento da consulta.

Verificação 4

Um workspace Clientell

Onde: a página de configuração do MCP. Entre, autorize o Salesforce, aguarde o primeiro índice e copie o token de acesso para a Etapa 3.

Nota: o token é uma credencial bearer com escopo para seu workspace Clientell. Ele não é uma credencial do Salesforce e não pode ser usado para acessar o Salesforce.

Verificação 5

O pacote gerenciado Clientell AI, instalado na sua organização

Instale: organização de produção ou sandbox. A instalação em si leva cerca de dois minutos.

Quem: Instalar um pacote gerenciado é uma ação de administrador do Salesforce. Se você não for admin na organização que deseja indexar, peça a um para instalá-lo antes da etapa de OAuth. Faça isso cedo se precisar da aprovação de outra equipe. Se ausente: o Salesforce retorna external_app_not_installed durante o OAuth. Instale o pacote na organização à qual você está se conectando e tente novamente. Consulte Solução de problemas.

Não está nesta lista

Node.js é um pré-requisito do Claude Code, não um pré-requisito do servidor Clientell. O servidor MCP é hospedado; nenhum processo de servidor local é necessário.

Etapa 1

Conecte seus sistemas

Entre e autorize os sistemas necessários por meio do OAuth. Comece com o Salesforce: os metadados dele formam o grafo. Cada outro conector que você autorizar adiciona leituras em tempo real do trabalho ao redor dele.

Autorize apenas o que você precisa. Um conector que você não autorizou não expõe ferramentas. Slack, Jira e GitHub também podem executar ações, então verifique as configurações de aprovação de ferramentas do seu cliente, descritas em Segurança e isolamento.

Etapa 2

Deixe o primeiro índice ser criado

A primeira criação indexa a estrutura da sua organização antes que as consultas de grafo estejam disponíveis. Organizações grandes levam mais tempo do que organizações de desenvolvedor. Depois disso, recrie sob demanda sempre que quiser.

Após registrar o servidor, peça clientell_onboarding_status para verificar o progresso da criação. Verifique se um objeto conhecido estiver ausente em uma resposta de grafo.

Etapa 3

Registre o servidor no seu cliente

Substitua <YOUR_TOKEN> pelo token do seu workspace, mantenha a palavra Bearer e o espaço depois dela e cole tudo no seu terminal.

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

O que você deve ver Added HTTP MCP server clientell to user config

A entrada foi salva. Verifique a conexão em seguida. O Claude Code não testa a URL ou o token ao salvar esta entrada. Um hostname errado ou token expirado falha na conexão. Verifique se funcionou é onde você descobre.

Linha por linha, passe o cursor ou use a tecla Tab para destacar cada parte acima

claude mcp add-json

O comando próprio do Claude Code para registrar um servidor MCP a partir de um bloco JSON. Nada nosso é executado aqui; você está editando a configuração do Claude Code.

clientell

O nome que você verá em /mcp e nos nomes das ferramentas. A escolha é sua; usamos clientell nesta página, e todos os outros comandos aqui presumem que você fez o mesmo.

'{ … }'

A entrada do servidor, entre aspas simples para que o shell a passe sem alterações. Quatro chaves: as três primeiras são obrigatórias, e timeout tem um padrão, então é recomendada em vez de obrigatória.

"type": "http"

Indica que este é um servidor remoto acessado via HTTP. Se você omitir, o Claude Code lê a entrada como um comando local a ser executado, não encontra nenhum e ignora o servidor silenciosamente; ele não aparecerá em claude mcp list de forma alguma.

"url": ".../mcp"

O único endpoint no qual o servidor responde. O /mcp no final faz parte do endereço, não é decoração. Removê-lo resulta em um erro de "não encontrado" que relata apenas o hostname, o que dificulta identificar a causa.

"headers"

Seu token de acesso, enviado em cada solicitação. O Claude Code não o remove; um espaço ou nova linha acidental ao copiar é enviado como parte do token, e o servidor o rejeita.

"timeout": 180000

Três minutos, em milissegundos, como teto para uma única chamada de ferramenta. O padrão corta uma solicitação após 60 segundos, e uma primeira consulta contra um grafo de organização "frio" pode levar mais tempo. Valores abaixo de 1000 são ignorados por completo.

--scope user

Torna o servidor disponível em todos os projetos. Sem isso, o Claude Code usa o escopo padrão, que vincula o servidor ao diretório em que você está; inicie o Claude em qualquer outro lugar e será informado de que nenhum servidor MCP está configurado. O escopo é fixado ao adicionar o servidor; alterá-lo significa remover e adicionar novamente.

Prefere flags em vez de JSON?

Mesmo servidor, flag por flag. Esta forma é mais fácil de ler, mas não tem flag --timeout, então não é possível definir o timeout; você precisa adicioná-lo depois manualmente.

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

Em seguida, abra ~/.claude.json, encontre a entrada clientell sob o nível superior mcpServers e adicione "timeout": 180000 a ela. Se preferir não editar esse arquivo manualmente, use o formulário JSON acima; é por isso que ele é o caminho principal.

Outros clientes

Registre o mesmo endpoint hospedado na configuração do seu cliente. Qualquer cliente MCP Streamable HTTP funciona; estes trechos cobrem os comuns, e o caminho detalhado do Claude Code acima é o que a Clientell verifica de ponta a ponta. Consulte Clientes suportados e verifique a documentação atual do seu cliente se o formato de configuração mudou.

Claude DesktopCompatível · não verificado por nós

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

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

Reinicie o Claude Desktop após editar. Ele lê este arquivo apenas na inicialização.

Verifique a sintaxe atual do conector personalizado do Claude Desktop se este bloco não carregar.

CodexCompatível · não verificado por nós

Config ~/.codex/config.toml

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

O Codex lê servidores MCP remotos do seu arquivo de configuração TOML. Consulte a própria documentação para os nomes das chaves na sua versão; eles mudaram entre versões.

CursorCompatível · não verificado por nós

Config ~/.cursor/mcp.json

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

Um .cursor/mcp.json local ao projeto também funciona e define o escopo do servidor para esse repositório em vez de toda a sua conta.

VS CodeCompatível · não verificado por nós

Config .vscode/mcp.json

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

Dica: o VS Code usa servers como chave de nível superior, não mcpServers. Se o servidor não aparecer, verifique essa chave primeiro.

Confirme se seu cliente consegue acessar o grafo.

Verifique a conexão antes de perguntar sobre sua organização. Registrar salva a entrada; a primeira conexão testa o endpoint e o token.

A verificação rápida

Verifique apenas o Clientell para um status rápido.

claude mcp get clientell

O que você deve ver Status: ✔ connected Scope: User config (available in all your projects) Type: http URL: https://mcp.clientell.ai/mcp

Se algo estiver errado, versões recentes do Claude Code imprimem uma linha Issue: com o status HTTP e o texto de erro do próprio servidor. Essa linha é a coisa mais útil desta página quando você está travado; leve-a para Solução de problemas.

A verificação completa

Verifique todos os servidores MCP configurados. Isso pode levar de 30 a 60 segundos, ou mais se outro servidor estiver sem resposta.

claude mcp list

O que você deve ver clientell: https://mcp.clientell.ai/mcp (HTTP) - ✔ Connected

E quando não está funcionando, a mesma linha termina de forma diferente: clientell: https://mcp.clientell.ai/mcp (HTTP) - ✘ Failed to connect — <reason>

Cada status que isso pode relatar

✔ Connected

Pronto para uso.

! Connected · tools fetch failed

A conexão foi aberta, mas a lista de ferramentas não retornou. Execute claude mcp get clientell para obter os detalhes.

! Needs authentication

O servidor está acessível e quer uma credencial que não recebeu.

✘ Failed to connect

Nenhuma resposta utilizável. Um motivo geralmente segue após o travessão.

✘ Connection error

A tentativa lançou uma exceção. O Claude Code não acrescenta detalhes a este.

⏸ Pending approval

Um servidor com escopo de projeto aguardando aprovação. Você não verá isso se usou --scope user.

cached · connects on first use

Não é um erro. O Claude Code lembrou a lista de ferramentas de uma sessão anterior e se conectará na primeira vez que você perguntar algo.

Em consoles Windows mais antigos, as marcas são renderizadas como √ e × em vez de ✔ e ✘. Mesmos significados.

Dentro de uma sessão

Inicie o Claude Code e digite /mcp. Você verá clientell listado com suas ferramentas.

Comportamento de reconexão que vale saber

Um erro 5xx ou uma conexão interrompida é repetido automaticamente com backoff, então falhas transitórias geralmente se resolvem sozinhas. Erros de autenticação e de não encontrado nunca são repetidos; eles precisam de uma mudança de configuração, então falham instantaneamente e permanecem com falha.

Comece com um campo que você precisa alterar.

Pergunte ao seu cliente de IA uma pergunta em linguagem natural sobre sua organização. Ele escolhe as ferramentas relevantes e responde com base no grafo.

• O que grava em Opportunity.Amount?Encontre fluxos, Apex, regras de validação e processos que tocam neste campo antes de editá-lo.
• O que quebra se eu excluir Account.Custom_Segment__c?Verifique referências e componentes impactados antes de remover o campo.
• Mostre-me todos os fluxos em Case que disparam após salvar.Compare a automação pós-salvamento em um objeto.
• Quais perfis podem editar Contact.Email?Inspecione o acesso ao campo em perfis e conjuntos de permissões. O que isso realmente fez

Essas perguntas leem nomes de metadados, identificadores e relacionamentos, não registros de clientes. Se você prosseguir com uma alteração, o Clientell aplica patches e audita, e seu cliente de IA executa o deploy aprovado por meio da sua própria sessão sf.

Uma primeira pergunta contra um grafo "frio" pode levar um tempo. Se passar de cerca de dois minutos, o Claude Code move para uma tarefa em segundo plano e informa você. As respostas são dimensionadas para caber no contexto do seu cliente de IA, e uma resposta dimensionada informa isso e relata a contagem total. Faça uma pergunta mais específica ou navegue pelas páginas para obter mais.

Escolha a organização antes de confiar na resposta.

Trabalhando entre produção e sandboxes? Defina a organização ativa para que as respostas de dependências venham do índice que você pretendia.

Duas verificações mantêm a seleção da organização explícita:

• Se não foi informado em qual organização você está trabalhando, ele diz isso na resposta em vez de escolher uma por você.
• Se a organização selecionada e a organização à qual seu token pertence resolverem para índices diferentes, ele recusa a solicitação em vez de escolher entre elas.

Defina a organização para a sessão com clientell_set_active_org. Isso acontece na conversa, não em um arquivo de configuração; você pede ao cliente para trocar de organização e ele chama a ferramenta. Para ver com o que você está autenticado localmente:

sf org list

Contexto do Salesforce, mais o trabalho ao redor.

O Salesforce fornece o mapa de metadados. Mais onze conectores leem o trabalho ao redor, ao vivo, no momento da pergunta: Slack, Jira, GitHub, Gmail, Google Calendar, Google Drive, Notion, Microsoft Teams, SharePoint, Outlook Mail e Outlook Calendar. Cada um lê como você, por meio da sua própria concessão. Salesforce leitura Slack leitura + escrita Jira leitura + escrita GitHub leitura + escrita Gmail leitura Google Calendar leitura Google Drive leitura Notion leitura Microsoft Teams leitura SharePoint leitura Outlook Mail leitura Outlook Calendar leitura

No centro

Salesforce leitura

Conectados ao redor

• Slack leitura + escrita
• Jira leitura + escrita
• GitHub leitura + escrita
• Gmail leitura
• Google Calendar leitura
• Google Drive leitura
• Notion leitura
• Microsoft Teams leitura
• SharePoint leitura
• Outlook Mail leitura
• Outlook Calendar leitura

Doze conectores, todos lidos ao vivo quando você pergunta.

Conector	Acesso	Status	O que você pode pedir	Observações
Salesforce	Leitura	Ao vivo	O grafo da organização: objetos, campos, fluxos, Apex, regras de validação, perfis e conjuntos de permissões, além das referências entre eles. Leituras ao vivo de registros, Tooling API, describe e limites quando você pede.	O grafo não contém conteúdos de registros. A Clientell aplica correções e audita mudanças, o deploy_guard recusa cargas inseguras de substituir-sem-mesclar nos deploys que prepara, e seu cliente de IA executa o deploy pela sua própria sessão sf após sua aprovação.
Slack	Leitura + escrita	Ao vivo	Histórico de canais, pesquisa de mensagens e listas de canais, lidos ao vivo como você. Envie uma mensagem ou adicione uma reação.	As escritas passam pelos controles de aprovação de ferramentas do seu cliente de IA, então você define a política de confirmação. Veja a nota abaixo da tabela.
Jira	Leitura + escrita	Ao vivo	Consulta e pesquisa de issues, por texto ou JQL, lidas ao vivo. Comente em uma issue ou mova-a para outro estado do fluxo de trabalho.	As escritas passam pelos controles de aprovação de ferramentas do seu cliente de IA.
GitHub	Leitura + escrita	Ao vivo	Pesquise repositórios, issues e PRs, abra um PR ou issue e liste os PRs aguardando você. Comente em um PR ou issue.	Os comentários são publicados pelo Clientell GitHub App, então instale-o na organização do repositório primeiro. As escritas passam pelos controles de aprovação de ferramentas do seu cliente de IA.
Gmail	Leitura	Ao vivo	Pesquise e abra mensagens e rascunhos, lidos ao vivo.
Google Calendar	Leitura	Ao vivo	Sua agenda, pesquisa de eventos e eventos individuais, lidos ao vivo.
Google Drive	Leitura	Ao vivo	Pesquisa de arquivos, metadados de arquivos e texto de arquivos, lidos ao vivo.
Notion	Leitura	Ao vivo	Pesquisa, conteúdo de páginas e linhas de bancos de dados, lidos ao vivo.
Microsoft Teams	Leitura	Ao vivo	Pesquisa de mensagens, histórico de canais e mensagens individuais, lidos ao vivo.
SharePoint	Leitura	Ao vivo	Pesquisa de arquivos, metadados de arquivos e texto de arquivos, lidos ao vivo.
Outlook Mail	Leitura	Ao vivo	Pesquise e abra mensagens e rascunhos, lidos ao vivo.
Outlook Calendar	Leitura	Ao vivo	Sua agenda, pesquisa de eventos e eventos individuais, lidos ao vivo.

Ao vivo

Disponível hoje. Lê o sistema de origem no momento da pergunta, por meio da sua própria concessão, então as respostas são atuais por design.

Leitura

Lê o sistema de origem quando você pergunta. Não expõe nenhuma ação que altere algo lá.

Leitura + escrita

Também executa ações no sistema de origem, como publicar uma mensagem ou um comentário. As configurações de aprovação de ferramentas do seu cliente de IA decidem quando ele pede sua confirmação primeiro.

Você define a política de confirmação para escritas de conectores

Slack, Jira e GitHub podem executar ações: enviar uma mensagem ou reação no Slack, comentar ou transicionar uma issue do Jira, comentar em um PR ou issue do GitHub. Essas ações passam pelos controles de aprovação de ferramentas do seu próprio cliente de IA, então você decide se cada uma pede confirmação primeiro (veja Claude Code, Cursor ou a documentação do seu cliente).

Para deploys do Salesforce, a Clientell aplica correções e audita a mudança. Após sua aprovação, seu cliente de IA executa o deploy pela sua própria sessão sf. Quando a Clientell prepara o deploy, o deploy guard recusa cargas inseguras de substituir-sem-mesclar para Perfis, Conjuntos de Permissões e Regras de Compartilhamento.

Ferramentas de conectores

• list_connector_capabilitiesLista seus provedores conectados, o status deles e as ações e argumentos que use_connector aceita para cada um.
• use_connectorExecuta uma leitura ou ação ao vivo em um provedor conectado pela sua própria conta. Salesforce, quando listado, é somente leitura: consulta, describe e limites.

Chame todos os doze conectores diretamente via MCP pelo seu cliente. Nenhuma superfície de agente separada é necessária.

Encontre dependências, planeje mudanças, verifique impacto.

Estas nove ferramentas respondem perguntas sobre a organização, elaboram mudanças e trazem contexto. O servidor aplica correções e audita mudanças propostas; após a aprovação, seu cliente de IA executa o deploy pela sua própria sessão sf. A ferramenta de mesclagem de registros duplicados prova que uma mesclagem é segura antes que qualquer coisa seja excluída. /mcp também lista as ferramentas de configuração abaixo e as ferramentas de conectores ativas.

Trabalho Salesforce · 9 Configuração · 11 01 Encontrar dependências o que toca o quê, e por quê search_salesforce_metadata search_team_context find_person_in_salesforce_and_work 02 Verificar impacto relatórios de impacto, auditoria e acesso generate_salesforce_org_report 03 Planejar mudanças orientação, rascunhos, planos de mesclagem e relatórios get_salesforce_best_practices search_salesforce_docs build_or_fix_salesforce_flow merge_duplicate_records manage_salesforce_reports_dashboards 04 Conectar e selecionar organizações, integrações, status do índice clientell_onboarding_status clientell_connect_salesforce clientell_set_active_org clientell_add_integration 05 Conta cobrança, plano, seus dados clientell_billing_status clientell_upgrade clientell_delete_my_data 06 Memória e playbooks contexto salvo, vínculos de identidade, playbooks clientell_remember clientell_confirm_person_link clientell_push_work_records run_clientell_playbook

Trabalho Salesforce · 9

01 · Encontrar dependências

• search_salesforce_metadata
• search_team_context
• find_person_in_salesforce_and_work

02 · Verificar impacto

• generate_salesforce_org_report

03 · Planejar mudanças

• get_salesforce_best_practices
• search_salesforce_docs
• build_or_fix_salesforce_flow
• merge_duplicate_records
• manage_salesforce_reports_dashboards

Configuração · 11

04 · Conectar e selecionar

• clientell_onboarding_status
• clientell_connect_salesforce
• clientell_set_active_org
• clientell_add_integration

05 · Conta

• clientell_billing_status
• clientell_upgrade
• clientell_delete_my_data

06 · Memória e playbooks

• clientell_remember
• clientell_confirm_person_link
• clientell_push_work_records
• run_clientell_playbook

As ferramentas do Salesforce e de configuração, agrupadas pela função que executam. As duas ferramentas de conectores estão listadas em Conectores.

• search_salesforce_metadataRastreie objetos, campos, fluxos, regras e permissões. Veja do que um componente depende antes de alterá-lo, com seções de auditoria selecionadas quando necessário.
• get_salesforce_best_practicesObtenha orientação validada antes de criar um Fluxo, escrever uma regra de validação ou carregar dados.
• build_or_fix_salesforce_flowElabore um Fluxo a partir de uma solicitação em linguagem simples ou diagnostique um erro de execução e proponha uma correção. A Clientell aplica patches e audita a alteração; implantações aprovadas são executadas na própria sessão sf do seu cliente de IA.
• search_salesforce_docsEncontre a documentação relevante do Salesforce e cite o guia de origem.
• generate_salesforce_org_reportGere um relatório de impacto, auditoria ou acesso que você possa inspecionar e compartilhar.
• search_team_contextPesquise e-mails, Slack, Jira, reuniões e documentos da sua equipe para encontrar as pessoas e decisões por trás de uma alteração no Salesforce, além do contexto salvo com clientell_remember.
• find_person_in_salesforce_and_workEncontre uma pessoa no Salesforce e no contexto de e-mail, Slack e Jira da sua equipe, e diga com confiança explícita se os registros são da mesma pessoa. Somente uma correspondência exata de e-mail vincula automaticamente; qualquer coisa mais fraca retorna como uma pergunta para você.
• merge_duplicate_recordsEncontre Contas, Contatos ou Leads duplicados, verifique cada ID de registro na organização e elabore um plano de mesclagem que possa comprovar segurança antes de qualquer exclusão. A mesclagem é executada na sua própria sessão sf.
• manage_salesforce_reports_dashboardsCrie, atualize, execute ou exclua Relatórios e Painéis nativos do Salesforce, incluindo relatórios combinados. Ele verifica cada relatório em relação às colunas reais do tipo de relatório e fornece o comando sf exato. Você o executa. Plumbing

Use estas ferramentas /mcp para conectar e selecionar uma organização, adicionar integrações, gerenciar cobrança e memória, confirmar vínculos de identidade, executar playbooks e excluir dados do workspace.

• clientell_onboarding_statusVerifique sistemas conectados e se o índice do seu workspace foi criado.
• clientell_connect_salesforceConecta uma organização Salesforce do seu terminal quando nenhuma está conectada ainda. Retorna um link que você abre no navegador e, em seguida, uma segunda chamada confirma a conexão.
• clientell_set_active_orgDefine em qual organização Salesforce a sessão está trabalhando. Consulte Escolhendo a organização certa.
• clientell_add_integrationConecta Slack, Gmail ou Jira ao seu workspace. Retorna um link de autorização e, em seguida, uma segunda chamada confirma a conexão.
• clientell_billing_statusInforma o estado de cobrança do seu workspace.
• clientell_upgradeInicia uma assinatura MCP ($249/mo) ou Platform ($500/mo) pelo Stripe Checkout, ou abre o portal de cobrança se você já assina. Nada é cobrado até você concluir o checkout.
• clientell_delete_my_dataExclui os dados mantidos para você. Consulte Desinstalação e exclusão de dados.
• clientell_rememberSalve contexto de trabalho explicitamente. Nada é armazenado automaticamente da sua atividade.
• clientell_confirm_person_linkRegistra sua resposta quando find_person_in_salesforce_and_work pergunta se dois registros são a mesma pessoa, para que não seja perguntado novamente. Um vínculo incorreto pode ser desfeito.
• clientell_push_work_recordsPonte de demonstração, não uma sincronização ao vivo: indexa registros de Gmail, Jira ou projetos SFDX locais que seu cliente de IA já leu. Apenas campos de índice são aceitos, nunca corpos de mensagens ou conteúdos de arquivos.
• run_clientell_playbookExecuta um playbook nomeado da Clientell, como standup ou plan_data_load, para clientes que não podem exibir os prompts MCP deste servidor.

Conecte uma pessoa entre sistemas de trabalho.

Vincule um Usuário do Salesforce, um Membro do Slack e uma conta do Jira quando seus identificadores compartilham um sinal. Use essa associação para acompanhar trabalhos relacionados entre sistemas conectados.

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

Dana Reyes uma pessoa

vinculada a

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

A Clientell vincula a mesma pessoa entre as ferramentas que sua equipe usa.

Use associações como contexto, não como controle de acesso

A cobertura depende dos sinais que cada sistema conectado expõe. Identidades sem sinal compartilhado podem permanecer separadas. As associações não são completas nem verificadas quanto à precisão para todas as pessoas em todas as organizações.

Verifique a identidade no sistema de origem antes de tomar uma decisão de acesso. Uma associação é contexto, não prova de identidade.

Mantenha as decisões que valem a pena levar adiante.

Registre por que você fez uma alteração e encontre esse contexto em uma conversa posterior. Você ou o modelo deve chamar explicitamente clientell_remember para salvar uma 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.

A memória mantém o que você escolhe, mantém seu histórico e expira conforme o agendamento.

Você controla o que é salvo

A memória não aprende seu fluxo de trabalho automaticamente nem infere entradas da sua atividade. Cada gravação é explícita. Versões anteriores permanecem inspecionáveis, mas o versionamento não restaura um estado anterior nem reverte uma alteração.

Encontre o erro. Dê o próximo passo.

Comece verificando se o endpoint responde. Em seguida, corresponda o status ou erro abaixo a uma correção específica.

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

Como ler o código de resposta 404 ou 405 o servidor está ativo — endpoints MCP respondem a POST, não HEAD 401 ou 403 o servidor está ativo e quer um token válido sem resposta URL errada, DNS ou algo na sua rede

No Windows PowerShell, use curl.exe, pois curl simples é um alias para outra coisa e aceita argumentos diferentes.

✘ Failed to connect — HTTP 401 O que significa

O token está ausente, expirado ou não é um que este servidor aceita.

Correção

A causa mais comum é invisível: um espaço à esquerda ou à direita no token colado. O Claude Code percebe e avisa Leading or trailing whitespace in: headers.Authorization, mas não o remove, e envia o valor exatamente como escrito. Remova o servidor, copie o token novamente com cuidado e adicione-o novamente.

Caso contrário, obtenha um novo token do seu workspace e adicione novamente. Um token rejeitado é definitivo; o Claude Code relata a conexão como falha em vez de recorrer a um login pelo navegador.

O Claude Code avisa sobre espaços em headers.Authorization

Seu token tem um espaço, tabulação ou nova linha em uma das extremidades. Isso vem de copiar de uma página da web e é uma das causas mais comuns de falha nesta instalação.

Remova e adicione o servidor novamente com uma colagem limpa. O Claude Code nomeia o campo, mas nunca ecoa o valor, então você não pode corrigi-lo lendo o aviso.

claude mcp remove clientell -s user

MCP endpoint not found quando você seleciona o servidor em /mcp O que significa

A URL na sua configuração não aponta para o endpoint. A mensagem relata apenas o hostname, nunca o caminho, o que esconde a causa real.

Correção

Verifique se sua URL termina em /mcp. O endereço completo é https://mcp.clientell.ai/mcp. Remover esse sufixo é o motivo usual para esta mensagem.

! Connected · tools fetch failed O que significa

A conexão abriu, mas a solicitação da lista de ferramentas não retornou. O servidor está acessível; algo falhou depois disso.

Correção

Execute claude mcp get clientell e leia a linha Issue:, ela carrega o status HTTP e o texto de erro do servidor. Leia essa saída e remova qualquer coisa sensível antes de compartilhá-la com alguém, aqui ou em qualquer outro lugar.

✘ Failed to connect — HTTP 421, ou cada solicitação falha de forma idênticaNosso problema para corrigir O que significa

O servidor rejeitou a solicitação devido a um problema de configuração de hostname do nosso lado.

Correção

Entre em contato conosco com o código de status e o hostname do endpoint. Corrigiremos a configuração do servidor.

✘ Failed to connect — ConnectionRefused O que significa

Nada está escutando nesse endereço.

Correção

Verifique o hostname na configuração do seu cliente. Se você mesmo hospeda o servidor, verifique se ele está escutando no endereço configurado.

Você adicionou o servidor, mas claude mcp list não o mostra O que significa

A entrada tem um url mas nenhum "type", então o Claude Code a leu como um comando local para executar, não encontrou nenhum e a ignorou sem relatar nada.

Correção

Adicione "type": "http" à entrada, ou remova o servidor e adicione-o novamente com o comando JSON no Estágio 3, que o inclui.

No MCP servers configured em um projeto onde você sabe que o adicionou O que significa

O servidor foi adicionado no escopo padrão, que o vincula ao único diretório em que você estava quando executou o comando.

Correção

Remova-o e adicione-o novamente com --scope user. O escopo é fixado quando o servidor é adicionado; executar add novamente sem remover primeiro falhará.

MCP server clientell already exists in user config, logo após você o remover A remoção não foi aplicada. claude mcp get exibe o escopo como uma frase (“User config (disponível em todos os seus projetos)”), mas remove -s aceita apenas a forma abreviada.

Passe a forma abreviada exatamente:

claude mcp remove clientell -s user

Tudo expira após cerca de 60 segundos O que significa

O limite padrão por solicitação do Claude Code. Uma primeira consulta a um gráfico de organização frio pode excedê-lo.

Correção

Defina um timeout por servidor; o comando JSON na Etapa 3 faz isso por você com "timeout": 180000. Valores abaixo de 1000 são ignorados, então um número pequeno é o mesmo que nenhum número.

A resposta parece curta, ou uma contagem parece baixa demais O que significa

As respostas são dimensionadas para caber no contexto do seu cliente de IA. Quando o servidor dimensiona um resultado, ele informa isso e relata a contagem real de linhas junto com as linhas retornadas. O Claude Code também reduz a saída de ferramentas muito grandes por conta própria, sem um marcador.

Correção

Faça uma pergunta mais específica ou navegue pelas páginas para ver mais. Se o resultado informar que foi reduzido, use a contagem relatada, não o número de linhas que você consegue ver.

Um relatório gerado termina no meio de uma frase O que significa

O documento é maior do que o tamanho que cabe no contexto do seu cliente. O resultado traz uma nota informando quantos caracteres foram omitidos.

Correção

Execute novamente com um escopo mais restrito, como um objeto ou um perfil por vez. Compartilhe o relatório quando ele chegar completo, com sua estrutura de fechamento intacta.

Uma resposta está faltando algo que você sabe que existe na organização O que significa

Na maioria das vezes, o gráfico foi construído pela última vez antes de esse componente ser criado. Toda resposta do gráfico traz o horário de last_graph_build, para que você possa comparar.

Correção

Reconstrua com clientell_set_active_org (sem argumentos) e pergunte novamente, ou execute a verificação ao vivo que veio com a resposta. Verifique clientell_onboarding_status se você não tiver certeza se a primeira construção terminou. Consulte Freshness.

O índice da organização não existe, ou a solicitação é recusada porque duas organizações discordam O que significa

Ou nenhum índice foi construído para essa organização ainda, ou a organização em que você está trabalhando e a organização à qual seu token pertence apontam para índices diferentes. No segundo caso, o servidor recusa em vez de escolher um.

Correção

Ambos os erros informam o que foi procurado. Defina a organização explicitamente com clientell_set_active_org e consulte Picking the right org. Se um índice nunca foi construído para essa organização, envie-nos o texto do erro.

Um conector está autorizado, mas suas ferramentas não retornam nada O que significa

Os conectores leem o sistema de origem ao vivo, como você, então retornam apenas o que sua própria conta nesse sistema pode ver. Duas causas prováveis: uma consulta que não corresponde a nada ou uma concessão que expirou.

Correção

Tente a mesma pesquisa no sistema de origem com sua própria conta. Se encontrar resultados lá, reconecte o conector do seu workspace e pergunte novamente. Consulte Connectors para saber o que cada um lê.

A conexão com o Salesforce falha com external_app_not_installed O que significa

O pacote gerenciado Clientell AI não está instalado na organização que você está conectando. O Salesforce relata isso como OAUTH_EC_APP_NOT_FOUND: o aplicativo que está sendo autorizado não existe nessa organização, então a tela de consentimento não tem nada para conceder.

Correção

Instale o pacote na organização que você está conectando, production ou sandbox e execute a conexão novamente. Leva cerca de dois minutos, e nada do que você fez antes precisa ser refeito.

Instalar um pacote gerenciado é uma ação de administrador, então, se você não for administrador dessa organização, esta é a etapa que precisa de outra pessoa. É o motivo mais comum para uma primeira conexão falhar, por isso é o Check 5 nos pré-requisitos, e não apenas aqui.

Verifique qual organização você está conectando antes de concluir que a instalação falhou. O pacote é instalado por organização, então uma sandbox pode estar sem ele enquanto a produção o tem, e o erro parece idêntico em ambos os casos.

A conexão com o Salesforce falha com oauth_session_mismatch O que significa

Para uma conexão iniciada pelo terminal, a conta Clientell conectada ao seu navegador não corresponde à conta que iniciou a conexão. A conexão não pode continuar com uma conta diferente.

Correção

Entre no Clientell neste navegador com a conta que seu agente de codificação usa. Em seguida, peça ao seu agente de codificação um novo link de conexão e abra-o neste mesmo perfil de navegador.

Entrar sozinho não reativa a tentativa anterior. O registro de conexão é de uso único, então você ainda precisa de um novo link do seu terminal após corrigir a conta.

A conexão com o Salesforce falha com connect_expired O que significa

O link de conexão gerado pelo terminal expirou ou já foi usado. Os links de conexão são de uso único, e uma conexão pendente expira após 30 minutos.

Correção

Volte ao seu terminal e peça ao seu agente de codificação para conectar o Salesforce novamente. Abra o novo link neste mesmo navegador e conclua a etapa do Salesforce sem deixá-lo aberto por muito tempo.

Não reutilize o link antigo nem inicie uma conexão separada no navegador. Uma nova conexão somente pelo navegador não pode concluir o handshake que seu terminal está aguardando.

A conexão com o Salesforce falha com authorization_expired O que significa

O login no Salesforce demorou demais. O link de conexão foi aberto a tempo, mas a etapa de autorização do Salesforce excedeu sua janela de dez minutos.

Correção

Peça ao seu agente de codificação um novo link de conexão. Tenha sua senha do Salesforce e o dispositivo de MFA prontos primeiro e conclua o login no Salesforce em dez minutos sem pausar.

Recomece a partir do novo link gerado pelo terminal, não de uma conexão separada somente pelo navegador. A tentativa anterior não pode ser retomada após a expiração da janela de autorização.

sf org list mostra sua organização como expirada, ou os comandos sf começam a falhar

Sua sessão do Salesforce expirou. Essa sessão vive na sua máquina e nunca a vemos, então não podemos atualizá-la por você.

sf org login web

claude plugin marketplace add retorna um 404 O que significa

O Clientell se registra como um servidor MCP HTTP, não como um marketplace de plugins do Claude.

Correção

Use a configuração nesta página. É o único caminho suportado.

Desconecte o cliente. Exclua os dados do workspace.

Remova a entrada do servidor para parar de usá-lo no Claude Code. Exclua os dados mantidos para você separadamente e revogue quaisquer autorizações de conector que você não precisar mais.

Remover o servidor

claude mcp remove clientell -s user

O que isso remove a entrada clientell na configuração do usuário do Claude Code

Isso remove a configuração do cliente, não os dados do seu workspace. O histórico do shell e os logs do cliente ainda podem conter o token colado durante a configuração. -s usa o escopo correspondente: user, project ou local.

Excluir seus dados

Antes de remover o servidor, peça ao seu cliente para chamar clientell_delete_my_data para excluir os dados mantidos para você. Remover uma configuração de cliente não exclui os dados subjacentes do workspace.

Revogue também as conexões

Excluir dados não revoga uma autorização OAuth. Revogue cada conector do seu workspace ou das configurações do aplicativo conectado do próprio sistema de origem, se você também quiser que a autorização desapareça.

Respostas rápidas antes de você conectar.

Encontre os principais detalhes sobre dados de registros, permissões de gráfico, implantação, conectores e clientes suportados.

O Clientell armazena nossos dados de registros do Salesforce?

Não. O gráfico indexa nomes, identificadores, metadados e relacionamentos, nunca o conteúdo dos registros. Quando você solicita registros ao vivo, o serviço de autenticação do Clientell executa uma consulta somente leitura na sua própria conexão do Salesforce, com suas permissões, e passa as linhas diretamente para o seu cliente. Elas nunca são gravadas no gráfico.

O gráfico aplica as permissões do Salesforce de cada pessoa?

O isolamento do workspace impede o acesso entre workspaces. Dentro de um workspace, todos veem o mesmo mapa da organização: as consultas ao gráfico não aplicam as permissões individuais de nível de registro ou de campo do Salesforce de cada pessoa. Isso torna a associação ao workspace seu ponto de controle, então você decide quem está no workspace.

O Clientell pode implantar uma alteração no Salesforce?

Sim, após sua aprovação. O Clientell aplica patches e audita a alteração. Quando o Clientell prepara uma implantação, deploy_guard a verifica e recusa cargas úteis inseguras do tipo substituir-em-vez-de-mesclar para Perfis, Conjuntos de Permissões e Regras de Compartilhamento. Seu cliente de IA então executa a implantação por meio da sua própria sessão autenticada do sf. O Clientell nunca vê essa sessão. Para registros duplicados, merge_duplicate_records verifica cada ID de registro na organização e elabora um plano de mesclagem que pode comprovar ser seguro, para que a mesclagem seja verificada antes que qualquer coisa seja excluída. A mesclagem então é executada por meio da sua própria sessão do sf.

Quem decide se uma ação do Slack pergunta primeiro para mim?

Você decide. As ações do Slack, como as ações do Jira e do GitHub, passam pelos controles de aprovação de ferramentas do seu próprio cliente de IA, então você define a política de confirmação lá. Defina-a para perguntar antes de cada gravação, se é isso que sua equipe deseja.

Qual é a atualidade do gráfico?

Você sempre sabe. Toda resposta do gráfico traz seu carimbo de data/hora last_graph_build, e uma chamada reconstrói o gráfico sempre que você quiser. As respostas de Flow, Apex e regras de validação vêm com uma verificação ao vivo pronta para execução, para que você possa confirmar na organização ao vivo em um comando antes de agir. Os conectores leem no momento da pergunta, então suas respostas são atuais por design.

Quais conectores funcionam hoje?

Doze, todos leem ao vivo quando você pergunta: Salesforce, Slack, Jira, GitHub, Gmail, Google Calendar, Google Drive, Notion, Microsoft Teams, SharePoint, Outlook Mail e Outlook Calendar. Slack, Jira e GitHub também podem executar ações, como publicar uma mensagem ou um comentário.

Com quais clientes MCP isso é verificado?

O Clientell é construído e verificado de ponta a ponta no Claude Code. Ele funciona com qualquer cliente MCP HTTP Streamable, incluindo Cursor, VS Code, ChatGPT e Gemini, e o guia de configuração tem trechos de configuração para os mais comuns.

Os conectores estão disponíveis diretamente via MCP ou apenas dentro do seu agente?

Diretamente via MCP. Seu cliente chama todos os doze conectores como ferramentas MCP comuns. Não há uma superfície separada somente para agentes pela qual você precise passar.

O que o servidor lembra entre conversas?

Apenas o que você ou o modelo escrevem explicitamente. As entradas podem ser corrigidas, cada gravação é mantida como uma versão em vez de sobrescrever a anterior, e as entradas têm uma expiração baseada em tempo. Nada é inferido da sua atividade e armazenado por conta própria.

Como as credenciais armazenadas são protegidas?

As credenciais armazenadas são criptografadas usando AES-256-GCM, com um nonce novo para cada gravação de armazenamento.

Quanto custa o Clientell MCP?

O Clientell MCP custa US$ 249/mês para 10 pessoas em uma organização de produção do Salesforce, depois US$ 25/mês por pessoa adicional, com sandboxes ilimitadas. O plano Platform custa US$ 500/mês para 3 pessoas com implantações e auditorias semanais da organização. Todos os planos incluem um teste gratuito de 14 dias sem necessidade de cartão de crédito. Consulte Pricing.

Como faço para removê-lo e excluir meus dados?

Remova a entrada do servidor do seu cliente e chame clientell_delete_my_data para excluir os dados mantidos para você. Essas são ações separadas. Revogue as conexões OAuth separadamente. O histórico do shell ou os logs do cliente ainda podem conter o token colado durante a configuração. Consulte Uninstall e exclusão de dados.

Alterações neste documento.

Alterações materiais no que esta página afirma. Correções de redação e tipografia não são listadas.

• 26 set 2026 Lista todos os doze conectores ao vivo com seus níveis de acesso verificados. O HubSpot não é mais listado. Explica a atualidade do gráfico por meio de last_graph_build e das verificações ao vivo que acompanham as respostas de Flow, Apex e regras de validação.
• 25 set 2026 Esclarece o fluxo de trabalho de implantação aprovado no Salesforce, a proteção de implantação e o limite de mesclagem de duplicados. A configuração inclui o pré-requisito do pacote gerenciado e o caminho de recuperação external_app_not_installed.
• Publicado pela primeira vez com etapas de configuração, status do conector, segurança do gráfico, resolução de identidade e orientação de memória.

O status do conector reflete o que está disponível hoje. Todos os doze conectores listados estão ao vivo.