Conectar o Valinor ao Claude

O Valinor tem um conector MCP (Model Context Protocol) que deixa um assistente de IA, como o Claude, consultar os dados do seu workspace. Você pergunta em linguagem natural e o assistente responde a partir dos números reais da empresa:

“Quantos negócios abertos cada vendedor tem?”
“Quanto faturei em agosto e quanto ainda tenho a receber?”
“Qual foi a taxa de ocupação da pousada em março, por categoria de quarto?”
“Quantas conversas do WhatsApp ficaram sem resposta esta semana?”

O conector é somente leitura: o assistente consulta, mas nunca cria, altera ou apaga nada no Valinor.

Requisitos

Um workspace no Valinor, com os módulos cujos dados você quer consultar.
Um papel com a permissão Criar conexões de IA (MCP). O papel Admin já tem; para outros papéis, peça a quem administra o workspace (veja Workspace e equipe).
Uma conta no Claude (claude.ai, Claude Desktop ou Claude Code) ou em outro cliente compatível com MCP remoto e OAuth.

O assistente só enxerga o que o seu próprio papel já permite ver no Valinor. Quem não vê faturas no app não passa a vê-las pela IA.

Endereço do conector

https://valinorcrm.com/api/mcp

Conectar pelo Claude

claude.ai e Claude Desktop

No Claude, abra Configurações → Conectores.
Procure Valinor no diretório de conectores e clique em Conectar. Se preferir, use Adicionar conector personalizado e informe o endereço acima.
O Claude abre a tela do Valinor. Entre com a sua conta (Google, Apple ou link de acesso por e-mail).
Na tela Conectar uma IA ao workspace, escolha o workspace e as permissões (veja Consentimento) e clique em Autorizar.
De volta ao Claude, o conector aparece como conectado. Ative-o na conversa e faça a sua pergunta.

A conexão feita no claude.ai também vale no Claude Desktop, porque os conectores ficam na sua conta do Claude.

Claude Code

No terminal, adicione o conector:

claude mcp add --transport http valinor https://valinorcrm.com/api/mcp

Depois, dentro do Claude Code, rode /mcp, escolha valinor e siga a autenticação no navegador, como nos passos 3 e 4 acima.

Outros clientes MCP

Qualquer cliente que suporte servidor MCP remoto por Streamable HTTP com autenticação OAuth 2.1 (registro dinâmico de cliente e PKCE) se conecta pelo mesmo endereço. O cliente descobre o servidor de autorização sozinho a partir da resposta do conector.

Consentimento

Na tela de consentimento você decide o que o assistente pode ler, módulo por módulo:

Módulo	Permissão	O que abre
CRM	`crm:read`	Contatos, negócios e tarefas
Financeiro	`finance:read`	Faturas e pagamentos
Hospitalidade	`hospitality:read`	Reservas e ocupação
Atendimento	`omnichannel:read`	Conversas: canal, status, atendente e tempo de resposta
Atendimento	`omnichannel:messages:read`	Conteúdo das mensagens

Só aparecem os módulos que o workspace tem e que o seu papel permite ver. O conteúdo das mensagens vem desmarcado: o assistente só lê o texto das conversas se você marcar essa opção.

Cada conexão vale para um workspace. Para consultar outro workspace, faça outra conexão.

Ver e revogar conexões

Em Configurações → Conexões de IA, no Valinor, ficam:

as conexões ativas, com quem conectou, quando e as permissões concedidas;
o histórico de chamadas: cada consulta que um assistente fez, com a ferramenta usada e quando.

Para cortar o acesso de um assistente, clique em Revogar conexão. A conexão não se renova mais a partir desse momento, e a credencial que o assistente já tinha expira em até 15 minutos. Para voltar a usar, é preciso conectar de novo. Você também pode remover o conector nas configurações do Claude.

Saiba mais

Ferramentas disponíveis — o que o assistente consegue consultar e os limites.
Dados e segurança — o que o conector lê, o que fica registrado e por quanto tempo.

Suporte

Dúvidas ou problemas com o conector: escreva para [email protected].