Conector MCP: use a Clav pelo Claude ou pelo ChatGPT
Como conectar o Claude ou o ChatGPT à sua organização na Clav, o que o assistente consegue fazer e como o acesso é controlado.
O que é o conector MCP?
O MCP (Model Context Protocol) é o padrão que o Claude e o ChatGPT usam para falar com outros sistemas. Com o conector da Clav, você pergunta ao seu assistente de IA sobre a conformidade da sua organização e ele responde com os dados da plataforma: quanto já foi feito, o que está pendente, o que falta em cada evidência e quem é responsável. Pelo chat, ele também preenche o que não depende de arquivo.
Sem token
Você entra com a sua conta Clav, com 2FA e SSO quando a organização exige.
Uma organização por conexão
Na autorização, você escolhe qual organização o app pode acessar.
Revogável
Desconecte o app quando quiser. O acesso termina na chamada seguinte.
Para quem é este guia
Para qualquer membro de uma organização que queira usar a Clav pelo Claude (claude.ai, Claude Desktop ou Claude Code) ou pelo ChatGPT.
Antes de começar
- O conector de IA precisa estar ativado para a sua organização. Quem ativa é a equipe da Clav, então fale com o suporte.
- Se a sua organização exige 2FA, ative o segundo fator na sua conta antes de conectar. O guia de 2FA mostra como.
- Você precisa de uma conta no Claude ou no ChatGPT em um plano que aceite conectores personalizados.
Onde encontrar a URL do servidor
Na plataforma, abra Integrações no menu lateral, na seção Outros, e escolha Claude e ChatGPT. A página tem a URL do servidor, com um botão de copiar, e os passos de cada app. A URL é:
https://api.clav.tech/mcpConectando
Claude (claude.ai e Claude Desktop)
Abra Configurações e depois Conectores. Clique em Adicionar conector personalizado, dê o nome Clav, cole a URL do servidor e clique em Conectar.
Nos planos Team e Enterprise, um proprietário do workspace do Claude adiciona o conector primeiro. Depois, cada pessoa conecta a própria conta Clav.
ChatGPT
Abra Configurações e depois Apps e Conectores. Em Configurações avançadas, ative o modo de desenvolvedor. Clique em Criar, dê o nome Clav, cole a URL do servidor e escolha OAuth como autenticação.
Claude Code
Rode no terminal:
claude mcp add --transport http clav https://api.clav.tech/mcpDepois, no Claude Code, rode /mcp, selecione clav e faça login.
Entre e autorize
O app abre a tela de login da Clav, e você entra como sempre. Se participa de mais de uma organização com o conector ativado, escolha qual delas o app vai acessar. Por último, autorize o acesso na tela de consentimento.
Para usar outra organização, conecte de novo e escolha a outra.
O que o assistente consegue fazer
O assistente lê o mesmo que você vê na plataforma, com as permissões do seu papel na organização:
- Progresso da organização, de cada framework e de cada controle, com os mesmos percentuais da tela.
- Frameworks, controles, requisitos e evidências, com status, prazos, responsáveis e atividade recente.
- Detalhes de uma evidência: o que o framework espera, a norma que a exige, o checklist, os campos de informação e o último arquivo enviado.
- O link para abrir uma evidência na plataforma.
- Um link temporário para baixar um arquivo de evidência.
Ele também consegue preencher os campos de informação de uma evidência, anexar um link externo (Google Drive, SharePoint) como evidência e duplicar uma evidência do tipo lista de anotações.
Antes de mudar qualquer coisa, o assistente diz o que vai mudar e espera a sua confirmação. O Claude e o ChatGPT também pedem a sua aprovação antes de executar uma alteração.
Arquivos
Para enviar um documento, peça ao assistente o link da evidência, abra a página na Clav e faça o upload pela tela. Depois avise o assistente, que confere se a nova versão entrou.
Para baixar, peça o arquivo ao assistente. Ele devolve um link que expira em poucos minutos e que serve só para você clicar: o assistente não lê o conteúdo do arquivo. Cada link gerado entra no histórico de downloads da organização, do mesmo jeito que um download feito pela tela.
Arquivos com criptografia de ponta a ponta
Se a sua organização usa criptografia de ponta a ponta, os arquivos só são descriptografados no seu navegador. O conector não gera link de download para eles. Nesse caso, o assistente passa o link da evidência e você baixa pela plataforma.
Segurança e controle
- A Clav recebe só as chamadas que o assistente faz. A conversa e as suas perguntas ficam no Claude ou no ChatGPT.
- O que o assistente lê é processado pelo fornecedor do app, na sua conta com ele.
- Cada chamada confere de novo a sua conexão, o seu vínculo com a organização e se o conector continua ativado. Se você sair da organização ou se o conector for desativado, o acesso termina na chamada seguinte.
- Os administradores veem as chamadas dos últimos 90 dias em Organização, Configurações, no quadro Atividade do conector de IA.
Desconectando
Em Configurações, abra Apps conectados e desconecte o app. O acesso termina na hora.
Perguntas frequentes
Minha organização não aparece na hora de escolher
A organização só aparece quando o conector de IA está ativado para ela e, se ela exige 2FA, quando você já ativou o segundo fator. Confira as duas coisas e conecte de novo.
O assistente pode criar ou apagar evidências?
Não. Evidências, controles e requisitos são criados e removidos pela plataforma.
Os auditores da certificadora podem usar o conector?
Não. Usuários de certificadora usam o portal próprio da certificação.
Gerar uma chave de API para sua certificadora
Um guia passo a passo para emitir um token de API com escopo, para que uma certificadora externa acesse seus arquivos de evidência com segurança.
Configurar o login único (SSO)
Conecte seu provedor de identidade para que a equipe entre na Clav com as credenciais corporativas e, se quiser, torne esse o único caminho de acesso.