Conexões
Conecte servidores ao agente do Reveals ou permita que clientes de IA acessem seus workspaces via MCP.
Duas direções de conexão
Em Conexões MCP, ‘Conectar servidores’ traz ferramentas externas para o agente da Home. ‘Dar acesso a clientes’ emite uma credencial para um cliente MCP, como Claude ou ChatGPT, acessar o Reveals. São fluxos independentes.
Conecte um servidor
Abra Conexões MCP no workspace e escolha Conectar servidores. O catálogo inclui destinos pré-configurados, como Sophyworks, PostHog, Typeform e Notion, além de um servidor personalizado. Depois de autenticar, descubra as ferramentas e autorize explicitamente as que o agente da Home pode usar.
Serviços com OAuth abrem o consentimento no próprio provedor. O endereço local .localhost só é acessível por processos que rodam no seu computador; um serviço externo precisa alcançar uma implantação pública do Reveals para completar o retorno OAuth.
- 01Escolha o workspace e o destino.
- 02Conclua o token ou a autorização OAuth exigida pelo servidor.
- 03Descubra as ferramentas e selecione as permitidas.
- 04Salve as autorizações e teste na Home.
Conecte um cliente MCP
Abra Conexões MCP, escolha ‘Dar acesso a clientes’ e emita uma credencial. O tipo Workspace dedicado acessa somente o workspace selecionado. O tipo Usuário acompanha todos os workspaces aos quais a conta tem acesso; o cliente usa listar_workspaces e informa workspace_id em cada ferramenta. Copie o token no momento da emissão, configure-o como Bearer e use o endereço /mcp do seu ambiente Reveals. Leitura e escrita seguem as permissões atuais da conta em cada chamada.
- 01Escolha entre Workspace dedicado e Usuário.
- 02Emita a credencial e guarde o token com segurança.
- 03Adicione o servidor MCP no cliente de IA.
- 04Para o tipo Usuário, liste os workspaces e escolha o ID em cada operação.
- 05Revogue a credencial quando não for mais necessária.
No Docker local, o endereço do servidor é https://app.reveals.localhost:8443/mcp. Uma URL .localhost não é acessível por um serviço de IA hospedado fora do seu computador. Para esse cliente, use uma implantação com endereço público e HTTPS.
MCP e eventos cumprem papéis diferentes
MCP permite que o cliente de IA consulte ou execute ferramentas autorizadas. A API de eventos recebe fatos do seu site ou backend e atualiza formulários e pipelines. Credenciais MCP não funcionam como chaves da API de eventos.