Conecte o Salesforce MCP ao ClickUp para que suas ferramentas de IA possam pesquisar, ler, criar e atualizar registros do Salesforce em linguagem natural.

Este guia cobre a configuração única do Salesforce que um administrador do Salesforce precisa fazer e, depois, como conectar pelo ClickUp usando OAuth 2.0 com PKCE. O processo leva cerca de 20 minutos, com mais 30 minutos para o Salesforce ativar o aplicativo.

O que você vai precisar

• Um Espaço de trabalho no ClickUp
• Uma organização do Salesforce (Enterprise Edition ou superior, ou Developer Edition) com permissões de Administrador do sistema
• A permissão Personalizar aplicativo no Salesforce

Etapas no Salesforce

Antes de concluir o processo dentro do ClickUp, há várias etapas de configuração no Salesforce.

Ao concluir as etapas do Salesforce, você vai levar três informações de volta ao ClickUp:

• A Chave do consumidor do seu aplicativo cliente externo
• Se você está conectando uma organização de produção ou sandbox
• Qual servidor MCP você ativou

Etapa 1: Ativar o serviço MCP

Os servidores MCP hospedados pelo Salesforce só aparecem na página de Configuração do Salesforce depois que o serviço MCP é ativado para a sua organização:

1. Na página de Configuração do Salesforce, digite Servidores MCP na caixa Localização rápida.
2. Se Servidores MCP aparecer em Catálogo de API, o serviço já está ativo. Pule para a Etapa 2: Ativar um servidor.
3. Se não aparecer, digite Interface do usuário na caixa Localização rápida, abra Interface do usuário e ative Habilitar serviço MCP. Depois, salve.

Se você não encontrar Servidores MCP, verifique se a edição da sua organização oferece suporte a servidores MCP hospedados.

Etapa 2: Ativar um servidor

Os servidores MCP ficam desativados por padrão. Um administrador precisa ativar cada um antes que qualquer cliente possa se conectar:

1. Na página de Configuração do Salesforce, digite Servidores MCP na caixa Localização rápida.
2. Clique em Servidores MCP em Catálogo de API.
3. Ative o servidor que sua equipe precisa. O ClickUp oferece suporte a estes:
   • Leituras de SObject (recomendado): pesquisa e recupera registros e relações
   • SObject completo: cria, lê, atualiza e exclui registros
   • Mutações de SObject: cria e atualiza registros, sem exclusões
   • Headless 360 (beta): acesso unificado à plataforma Salesforce mais ampla

Se você pular esta etapa, o ClickUp vai fazer login com sucesso, mas não vai encontrar nenhuma ferramenta. Você vai escolher esse mesmo servidor no ClickUp, então anote qual você ativou.

Pode levar até 2 minutos para um servidor ficar ativo depois de ser ativado.

Para a referência completa, consulte o guia do Salesforce sobre ativação de servidores MCP.

Etapa 3: Criar um aplicativo cliente externo

Você deve usar um aplicativo cliente externo. Aplicativos conectados não têm suporte para MCP e causam falhas de autenticação.

Para criar um aplicativo cliente externo:

1. Na página de Configuração do Salesforce, digite Cliente externo na caixa Localização rápida.
2. Clique em Gerenciador de aplicativos cliente externos.
3. Clique em Novo aplicativo cliente externo.
4. Preencha a seção Informações básicas. Dê ao aplicativo um nome como ClickUp MCP.
5. Expanda API (Habilitar configurações de OAuth) e marque Habilitar OAuth.

Deixe este formulário aberto. As Etapas 4 a 6 vão pedir que você preencha o restante dele.

Se o ClickUp reportar um cliente inválido depois, a Chave do consumidor que você colou não pertence a este aplicativo, ou o aplicativo ainda não terminou de ser propagado (Etapa 8).

Para a referência completa, consulte o guia do Salesforce sobre criação de um aplicativo cliente externo.

Etapa 4: Configurações de segurança do OAuth

No mesmo formulário, em Segurança:

1. Marque estas opções:
   • Exigir extensão PKCE (Proof Key for Code Exchange) para fluxos de autorização com suporte
   • Habilitar rotação de token de atualização
   • Emitir tokens de acesso baseados em JWT (JSON Web Token) para usuários nomeados
   • Limitar o tempo de vida (TTL) do token de atualização ocioso para 30 dias

• Deixe estas opções desmarcadas:
  • Exigir segredo para o fluxo do servidor web
  • Exigir segredo para o fluxo de token de atualização
  • Impor lista de permissões de IP do token de atualização

O ClickUp usa PKCE como cliente público e, por isso, não precisa do segredo do consumidor. Se você exigir um segredo aqui, a conexão vai falhar.

Etapa 5: Adicionar a URL de retorno de chamada

No campo URL de retorno de chamada, insira a URL de retorno de chamada do ClickUp:

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

A URL de retorno de chamada deve corresponder exatamente, sem barra no final. O ClickUp exibe o mesmo valor na configuração guiada para você comparar.

Etapa 6: Adicionar escopos de OAuth

Para adicionar escopos de OAuth:

1. Em Escopos de OAuth selecionados, adicione:
   • mcp_api: acessar servidores MCP hospedados pelo Salesforce
   • refresh_token, offline_access: realizar solicitações a qualquer momento
2. Clique em Criar.

Se você configurou isso durante o beta do Salesforce MCP, os escopos antigos (api, sfap_api, einstein_gpt_api) não funcionam mais. Use mcp_api e refresh_token. Consulte o guia de transição de beta para disponibilidade geral do Salesforce.

Etapa 7: Atribuir um conjunto de permissões

Por padrão, qualquer pessoa na sua organização pode se conectar ao aplicativo. Para limitar o acesso a pessoas específicas, use um conjunto de permissões. Esta etapa é opcional.

O conjunto de permissões controla apenas quem pode se conectar. As permissões existentes de cada pessoa no Salesforce para objetos, campos e compartilhamento continuam valendo para cada chamada de ferramenta.

Para atribuir um conjunto de permissões:

1. Crie um conjunto de permissões para usuários do ClickUp MCP, como Usuário do ClickUp MCP. Ele não precisa de permissões extras.
2. Atribua-o a todas as pessoas que vão se conectar pelo ClickUp.
3. Em Gerenciador de aplicativos cliente externos, abra seu aplicativo e clique em Políticas.
4. Em Políticas de OAuth, defina Usuários permitidos como Usuários aprovados pelo administrador estão pré-autorizados.

5. Em Políticas do aplicativo, mova seu conjunto de permissões para Conjuntos de permissões selecionados. Deixe Perfis selecionados vazio.

6. Clique em Salvar.

Se você selecionar Usuários aprovados pelo administrador estão pré-autorizados e não escolher um conjunto de permissões, ninguém vai conseguir se conectar.

Deixe Escopos personalizados de OAuth vazio. O ClickUp precisa apenas dos escopos da Etapa 6.

Etapa 8: Aguardar a propagação do aplicativo

Um novo aplicativo cliente externo pode levar até 30 minutos para ficar disponível, de forma semelhante à propagação de DNS. Se o ClickUp falhar logo após a configuração, aguarde e tente novamente.

Enquanto aguarda, copie sua chave do consumidor:

1. Em Gerenciador de aplicativos cliente externos, abra o aplicativo que você criou.
2. Clique em Configurações.
3. Clique em Chave e segredo do consumidor em Configurações de OAuth.
4. Copie a Chave do consumidor. Ela começa com 3MVG9.

Conectar no ClickUp

O OAuth do Salesforce usa a sessão ativa do seu navegador. Antes de começar, prepare o navegador:

1. Saia de todas as outras organizações do Salesforce no seu navegador padrão.
2. Faça login na organização que tem seu aplicativo cliente externo e mantenha o navegador aberto.

Isso evita que o login caia na organização errada. Consulte o guia do Salesforce sobre como fazer login na sua organização.

Com o navegador pronto, você pode se conectar no ClickUp:

1. Abra o App Center.
2. Pesquise e selecione Salesforce.
3. Selecione uma aba para escolher o tipo de conexão:
   • Conexão pessoal: somente você pode usar as ferramentas do Salesforce no ClickUp. Sua identidade e permissões do Salesforce são usadas em cada chamada de ferramenta.
   • Conexão do Espaço de trabalho: qualquer membro do Espaço de trabalho pode usar as ferramentas do Salesforce, mas cada pessoa faz login com suas próprias credenciais do Salesforce e, se você restringiu o acesso na Etapa 7, precisa daquele conjunto de permissões. Todos compartilham o mesmo aplicativo cliente externo, mas cada pessoa tem sua própria autorização.
4. Clique em Conectar para abrir a configuração guiada.
5. Em Qual organização você está conectando?, escolha Produção / Developer Edition ou Sandbox / organização Scratch.
6. Em Qual servidor você ativou?, escolha o servidor que você ativou na Etapa 2.
7. Verifique se a URL de retorno de chamada exibida no ClickUp corresponde à do seu aplicativo cliente externo.
8. Cole sua Chave do consumidor da Etapa 8.
9. Clique em Próximo.
10. Aprove o acesso quando o Salesforce solicitar.
11. Aguarde o ClickUp validar a conexão e carregar suas ferramentas.

Limitações

Limitações conhecidas e problemas comuns com o Salesforce MCP:

• Atraso de propagação: um novo aplicativo cliente externo pode levar até 30 minutos para funcionar. Se a primeira tentativa falhar, aguarde e tente novamente.
• Aplicativos conectados não funcionam: você deve usar um aplicativo cliente externo.
• Servidor não ativado: o login funciona, mas nenhuma ferramenta é carregada se o servidor que você escolheu no ClickUp não estiver ativo no Salesforce.
• Acesso restrito: se você limitou o acesso com um conjunto de permissões na Etapa 7, pessoas sem ele não conseguem se conectar. Atribua-o a elas ou altere Usuários permitidos de volta para Todos os usuários podem se autorizar.
• Apenas quatro servidores no ClickUp: a configuração guiada oferece suporte a Leituras de SObject, SObject completo, Mutações de SObject e Headless 360 (beta). Outros servidores MCP do Salesforce, como Exclusões de SObject ou Data Cloud SQL, ainda não estão disponíveis no ClickUp.
• Várias organizações em um navegador: se você estiver conectado em mais de uma organização, o login pode cair na errada. Saia das outras primeiro.
• Limites de API e cobrança: as chamadas de ferramentas MCP contam para os limites de solicitações de API da sua organização, e o Salesforce pode cobrar o uso do MCP por meio de Flex Credits. Verifique Uso de API na página de Configuração do Salesforce.
• Organizações Scratch: não é possível criar aplicativos cliente externos em organizações scratch pela página de Configuração do Salesforce. Crie o aplicativo em uma organização Dev Hub, empacote-o e instale-o na organização scratch.
• Configurações beta: escopos beta antigos e URLs contendo v1-beta.2 não funcionam mais. A configuração guiada do ClickUp usa o formato de URL de disponibilidade geral automaticamente.

Desconectar ou revogar acesso

Para desconectar pelo ClickUp:

1. No App Center, pesquise e selecione o aplicativo.
2. Selecione a aba Pessoal ou Espaço de trabalho.
3. Ao lado de Conectado, clique no ícone de reticências....
4. Selecione Desconectar.
5. Para confirmar, clique em Desconectar.

Para revogar totalmente o acesso pelo Salesforce:

1. Na página de Configuração do Salesforce, abra Gerenciador de aplicativos cliente externos.
2. Abra seu aplicativo ClickUp MCP.
3. Clique em Políticas de OAuth.
4. Revogue o acesso ou exclua o aplicativo cliente externo.

Desconectar no ClickUp revoga seu token OAuth, mas mantém o aplicativo cliente externo no Salesforce, para que você possa se reconectar facilmente.

Proteção de segurança para produção (opcional)

• Restringir por endereço IP: adicione intervalos de IP permitidos em Políticas de OAuth e marque Impor lista de permissões de IP do token de atualização em Segurança. Antes, verifique se os intervalos de IP do seu cliente MCP se encaixam nos limites da lista de permissões do Salesforce.
• Logout único: ative-o em Configurações de sessão para que encerrar uma sessão do Salesforce também encerre a sessão MCP correspondente.
• Privilégio mínimo: prefira Leituras de SObject, a menos que sua equipe precise alterar registros.