Conectar o Claude ou o ChatGPT

O Claude e o ChatGPT podem acessar o servidor MCP em https://api.salesbud.com.br/mcp fazendo você entrar no Salesbud. Não há client ID nem secret para copiar: você entra, escolhe o workspace e autoriza, e o assistente lê o que você vê no Salesbud, nada além.

O que é uma conexão

Autorizar cria para você uma credencial de usuário, listada na tela de credenciais da API com o nome do app como origem. Este guia a chama de conexão. Ela é igual a uma credencial de usuário nestes pontos:

Escopos. Ela recebe os escopos que você pode usar no Salesbud, e nenhum outro.
Aprovação. Se você mesmo não aprova credenciais de API, ela aguarda um administrador.
Visibilidade de dados. Ela lê só o que você vê no Salesbud.
Limites. Ela conta no limite de 3 credenciais de usuário ativas (uma desabilitada ainda conta) e 1 pendente, por usuário em cada empresa. O limite vale ao criar a conexão; reconectar não conta.

Ela é diferente nestes pontos:

Sem validade fixa. Ela não expira numa data. Dura até ser revogada, até o dono perder o acesso ou até o assistente parar de renová-la.
Sem secret. Não há client secret para copiar, então uma conexão não pode ser rotacionada: o pedido é recusado com OAUTH_CLIENT_NOT_ROTATABLE.
Dono inativo. Quando você sai da empresa ou perde o login, a renovação falha com invalid_grant, e não com invalid_client.
Escopos vazios. Se nenhum dos seus escopos estiver disponível, o pedido de token é recusado com invalid_scope.

Antes de começar

A sua empresa tem acesso à API habilitado.
Você consegue entrar no Salesbud.
O assistente é um dos que o Salesbud aceita: Claude ou ChatGPT. Outros apps são recusados ao tentar iniciar a autorização. Para usar o Claude Code, configure o servidor MCP com uma credencial, como no Começo rápido.

Conectar

Claude

O Salesbud está no diretório de conectores do Claude, o mesmo catálogo do claude.ai, do Claude Desktop, do Claude no celular e do Claude Code.

Team e Enterprise: um Owner da organização adiciona o conector uma vez, em Organization settings → Connectors → Browse connectors: busque Salesbud e adicione ao time. Depois, cada membro abre Customize → Connectors, encontra o Salesbud e clica em Connect. No plano Team, o membro que não pode adicionar conectores vê Request no lugar, e os Owners são avisados.
Pro e Max: abra Customize → Connectors, busque Salesbud no diretório e clique em Connect.

Um conector personalizado adicionado antes continua funcionando. Para passar para o conector do diretório, remova o personalizado e adicione o Salesbud pelo diretório.

Se o conector do diretório não estiver disponível para você, adicione o Salesbud como conector personalizado.

Nos planos Team e Enterprise, um Owner da organização adiciona o conector uma vez, em Organization settings → Connectors → Add → Custom:

URL: https://api.salesbud.com.br/mcp.
Authentication: Sign in now, para que cada membro entre com a própria conta do Salesbud.
OAuth client: Use Claude’s published identity.
Sem request headers: um client ID ou secret nos headers faria todos os membros lerem com a mesma credencial.

Depois, cada membro abre Customize → Connectors, encontra o conector e clica em Connect. Nos planos Pro e Max, você mesmo adiciona o conector personalizado em Customize → Connectors, com a mesma URL e a mesma autenticação.

O Claude não deixa mudar a autenticação de um conector depois de criado. Se a sua organização já tem um conector do Salesbud configurado de outro jeito, o Owner o remove e adiciona de novo como acima.

ChatGPT

Abra Configurações → Plugins e clique em Explorar catálogo, no canto superior direito.
Na página do catálogo, clique em Adicionar → Adicionar servidor MCP personalizado, no canto superior direito.
Dê um nome, como Salesbud MCP, informe a URL https://api.salesbud.com.br/mcp e escolha a autenticação OAuth. Os demais campos são opcionais. Marque Entendo e quero continuar.
Depois de conectar, o plugin aparece no catálogo. Abra-o e clique em Testar no chat, ou só pergunte num chat novo pelos seus dados do Salesbud: o ChatGPT chama o plugin sozinho.

Não é preciso modo desenvolvedor.

Autorizar

Nos dois, o navegador mostra então a tela de consentimento do Salesbud: entre se precisar, escolha o workspace quando fizer parte de mais de um, confira o app e os escopos e autorize.

Aguardando aprovação

Se você mesmo não aprova credenciais de API, a conexão nasce aguardando aprovação do administrador, na mesma fila de uma credencial de usuário solicitada. O assistente conecta, mas toda tool responde que a conexão aguarda um administrador, com a mensagem da API “The API client is waiting for administrator approval.”. Quem aprova credenciais é avisado. Quando alguém aprova na tela de credenciais da API, a mesma conexão passa a ler, sem nada para refazer.

Administradores, e quem pode aprovar credenciais de API, conectam direto, sem pendência.

Conectar de novo

Conectar o mesmo app de novo na mesma empresa reaproveita a conexão em vez de criar outra. Isso atualiza os escopos para os que você pode usar agora e encerra as renovações anteriores, então um refresh token que o app tinha antes deixa de funcionar. Um access token já emitido continua válido até expirar, ou seja, expires_in segundos depois de emitido, hoje 1 hora.

Se um administrador desabilitou a conexão, reabilite-a na tela de credenciais da API antes de reconectar; até lá a autorização é recusada.

Desconectar

Desconectar na tela de credenciais da API revoga a conexão. A próxima requisição do assistente já é recusada, e ele não consegue mais renovar o acesso. No servidor MCP, as tools respondem com um erro pedindo para reconectar, e não com HTTP 401. Conectar de novo depois de revogar cria uma conexão nova, e um novo pedido de aprovação se você mesmo não aprova credenciais.

Como o assistente mantém o acesso

O assistente recebe um access token, válido por expires_in segundos (hoje 1 hora), e um refresh token válido por 90 dias. Cada refresh token funciona uma vez: renovar devolve um par novo. Um refresh token apresentado duas vezes é tratado como roubado. A cadeia de renovações a que ele pertence é revogada, e o assistente precisa conectar de novo. Se o assistente passar 90 dias sem renovar, você conecta de novo.

Suporte

Para ajuda ao conectar o Claude ou o ChatGPT, ou com uma conexão que parou de funcionar, escreva para eng@salesbud.com.br. Diga qual assistente você usa, a sua empresa no Salesbud, mais ou menos quando aconteceu e a mensagem que apareceu. Nunca envie token, senha nem client secret.