Autenticação
Entenda o OAuth, as permissões MCP, a seleção de contas e os erros de autorização da SalesTouch.
A SalesTouch usa OAuth 2.1 com PKCE. Os clientes MCP descobrem automaticamente o servidor de autorização pelos metadados do recurso protegido publicados junto ao endpoint MCP remoto.
Permissões
| Permissão | Finalidade |
|---|---|
openid | Identifica o usuário da SalesTouch que entrou na conta. |
offline_access | Permite que o cliente MCP renove o acesso sem pedir novos logins. |
salestouch:use | Concede acesso ao serviço MCP da SalesTouch. |
linkedin:access | Concede os recursos de leitura e escrita do LinkedIn aprovados durante o consentimento. |
Cada página de ferramenta informa as permissões necessárias. A SalesTouch verifica essas permissões antes da execução e retorna uma nova solicitação OAuth quando alguma está ausente.
Seleção de conta
A maioria das ferramentas aceita um account_id opcional. Quando ele é omitido, a SalesTouch seleciona uma conta conectada qualificada e reutiliza a conta proprietária de um contato quando ela já é conhecida.
Use linkedin_accounts para consultar ou selecionar uma conta explicitamente. Nunca invente um identificador de conta.
Sequência de autenticação
- Adicione
https://www.salestouch.io/api/mcpao cliente MCP. - Inicie o fluxo de login do cliente.
- Entre na SalesTouch pelo navegador.
- Revise e aprove as permissões solicitadas.
- Volte ao cliente e abra uma nova tarefa ou conversa.
- Verifique o acesso com
linkedin_accounts.
Erros de autorização
invalid_token ou autorização necessária
O endpoint MCP existe, mas a sessão OAuth está ausente ou expirou. Inicie novamente o login do cliente e recarregue a lista de ferramentas.
insufficient_scope
O token atual não inclui a permissão exigida pela ferramenta solicitada. Reconecte o MCP e aprove a nova permissão.
paid_plan_required
A autenticação funcionou, mas o workspace não tem acesso ao MCP do LinkedIn no momento. Altere o direito de acesso do workspace da SalesTouch antes de tentar novamente.
Nenhuma conta do LinkedIn retornada
O OAuth está funcionando, mas a SalesTouch não encontrou uma conta do LinkedIn utilizável no workspace. Conecte o LinkedIn na SalesTouch e chame linkedin_accounts novamente.
Continue com os fluxos de trabalho depois que a verificação somente leitura funcionar.