Integre a Lucid com ferramentas de IA usando o servidor MCP da Lucid

Conectar ferramentas de IA à Lucid

Se você estiver em uma conta Equipes da Lucid ou Corporativo, seu administrador da Lucid deve primeiro habilitar o acesso ao MCP. O administrador da sua ferramenta de IA também pode precisar autorizar a integração nas configurações da sua ferramenta de IA.

O servidor MCP da Lucid é compatível com qualquer cliente MCP. Confira as listagens do marketplace e os artigos vinculados abaixo para mais informações sobre como conectar a Lucid a ferramentas comuns de IA.

• Claude 
  • Instale o conector usando esta listagem do Diretório do Claude.
  • Consulte o artigo Conectar a Lucid ao Claude para ver etapas detalhadas de configuração.
• Claude Code

  • Para se conectar ao Claude Code, execute o código abaixo no seu terminal e, em seguida, execute /mcp no Claude Code para autorizar o Lucid:

    claude mcp add --transport http lucid 
    https://mcp.lucid.app/mcp

• Cursor
  • Instale o conector usando esta listagem do Marketplace do Cursor.
  • Consulte nosso artigo sobre como Conectar a Lucid ao Cursor para ver etapas detalhadas de configuração.
• ChatGPT ou Codex
  • Instale o conector usando esta lista de plugins do ChatGPT.
  • Consulte o artigo Conectar a Lucid ao ChatGPT ou Codex para ver etapas detalhadas de configuração.
• GitHub ou VS Code Copilot
  • Instale o conector usando esta listagem do MCP Registry no GitHub.
  • Consulte as etapas detalhadas de configuração em nosso artigo Conectar a Lucid ao VS Code Copilot.
• Slack
  • Instale o conector usando esta listagem do Marketplace do Slack.
  • Veja as etapas detalhadas de configuração em nosso artigo Conectar o Lucid ao Slackbot.
• Glean
  • Instale o conector usando esta lista de conectores da Glean.

Outros clientes MCP

O servidor MCP da Lucid pode se conectar a qualquer ferramenta ou gateway compatível com MCP, não apenas aos listados aqui. Exemplos comuns incluem:

• Microsoft Copilot Studio
• GitHub Copilot CLI
• Gemini CLI
• Devin

Gateways corporativos

• Cequence AI Gateway
• Natoma

Se a sua ferramenta de IA não estiver listada acima, use a URL do servidor e a configuração JSON abaixo para configurar a conexão manualmente.

URL do servidor e configuração JSON

URL do servidor

O servidor MCP da Lucid é compatível com qualquer cliente MCP, incluindo os listados abaixo. Embora o processo de configuração varie dependendo do cliente que você usa, a URL do servidor necessária para configurar o Lucid MCP é a mesma:

• https://mcp.lucid.app/mcp
  • Esta URL não se destina a ser acessada no seu navegador. É um parâmetro que você usará para conectar a ferramenta de IA ao servidor MCP da Lucid.

A Lucid oferece diferentes configurações de servidor MCP, dependendo das suas necessidades de segurança e do nível de acesso aos seus dados que você deseja conceder às ferramentas de IA:

• Servidor MCP de repositórios da Lucid: conecte-se a este servidor para referenciar apenas conteúdo em repositórios da Extensão Processos.
  • https://mcp.lucid.app/mcp/repositories
• Servidor MCP somente leitura da Lucid: forneça às ferramentas de IA permissões de pesquisa e somente leitura para seus dados da Lucid.
  • https://mcp.lucid.app/mcp/readonly

Requisitos de configuração do JSON

Algumas ferramentas de IA podem exigir que você edite manualmente um arquivo de configuração JSON para conectá-las a um servidor MCP.

Se a sua ferramenta de IA for compatível com o método de transporte HTTP, use esta configuração JSON:

"Lucid Software": {
"type": "http",
"url": "https://mcp.lucid.app/mcp"
}

Se a sua ferramenta de IA não for compatível com o método de transporte HTTP, você precisa executar um servidor local para encaminhar solicitações HTTP ao servidor MCP da Lucid. Isso pode ser feito com o pacote mcp-remote do Node.js. Verifique se o Node.js está instalado no seu computador e use a seguinte configuração JSON:

"Lucid Software": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.lucid.app/mcp"]
}

Autenticar com uma chave de API

O servidor MCP da Lucid usa OAuth por padrão, o que exige que um usuário aprove o acesso na primeira vez que uma ferramenta de IA se conecta. Para processos autônomos executados sem uma pessoa disponível para conceder essa aprovação, os usuários dos planos Equipe e Corporativo podem se autenticar usando uma chave de API. Para configurar a autenticação com uma chave de API, siga estas etapas:

1. Gere uma chave de API no portal para desenvolvedores da Lucid.
2. Configure seu cliente MCP para usar a chave de API para autenticação.
3. O cliente MCP fará a autenticação automaticamente usando as permissões concedidas a essa chave, sem necessidade de login ou solicitação de aprovação em tempo de execução.

Para administradores: ative ou desative o uso do servidor MCP na sua conta

Os administradores das contas Equipe e Corporativo podem controlar se concederão acesso ao servidor MCP da Lucid para os usuários das contas.

Para habilitar ou desabilitar o acesso ao MCP para sua conta, siga estas etapas:

Ações disponíveis com o servidor MCP da Lucid

Depois que o servidor MCP da Lucid estiver configurado, você poderá usá-lo para realizar várias ações na Lucid inserindo um prompt na sua ferramenta de IA. À medida que adicionamos mais casos de uso ao servidor MCP da Lucid, talvez você precise se autenticar novamente com sua ferramenta de IA para que a nova funcionalidade funcione.

No momento, há suporte para os seguintes casos de uso:

Resolução de problemas do servidor MCP da Lucid

A Lucid não aparece na lista de conectores da minha ferramenta de IA. 
Em contas da Lucid dos planos Equipe e Corporativo, um administrador deve primeiro habilitar o acesso ao MCP. Se a sua ferramenta de IA estiver em um plano para toda a organização, um administrador da ferramenta também poderá precisar aprovar a conexão.

Conectei minha ferramenta de IA à Lucid, mas ela não consegue encontrar meus documentos. 
O servidor MCP da Lucid só consegue acessar documentos que você já tem permissão para abrir e não pode ver documentos pertencentes a usuários fora da sua conta da Lucid. Confirme se você consegue abrir o documento na Lucid primeiro.

Um novo recurso do servidor MCP da Lucid foi anunciado, mas minha ferramenta de IA não consegue executá-lo. 
Novos recursos exigem uma nova autorização. Desconecte o conector da Lucid na sua ferramenta de IA e reconecte-o.

Minha conexão parou de funcionar. 
Seu administrador da Lucid pode ter desativado o acesso ao MCP, ou sua autorização pode ter expirado. Reconecte o conector Lucid na sua ferramenta de IA. Se falhar novamente, consulte seu administrador da Lucid.

Perguntas frequentes

Como funciona o servidor MCP da Lucid?
O servidor MCP da Lucid é um serviço remoto disponível em https://mcp.lucid.app/mcp. Ele usa o protocolo de transporte HTTP com streaming, o Documento de Metadados de ID do Cliente (CIMD) e o Registro Dinâmico de Cliente (DCR) para gerenciar com segurança o acesso de clientes. A autenticação é realizada via OAuth 2.0, permitindo que usuários da Lucid autorizem o servidor MCP a se integrar às suas ferramentas de IA. Durante a configuração, os usuários concluem duas etapas distintas de autorização:

• Autenticação do servidor: verifica e registra o servidor MCP da Lucid como um serviço confiável.
• Aprovação de escopo de permissão: concede ao servidor MCP acesso a documentos, dados e operações de conta do usuário nos produtos da Lucid.

Tanto a autenticação quanto a aprovação de escopo são necessárias antes que o servidor MCP da Lucid possa interagir com a conta ou os dados de um usuário.

O servidor MCP da Lucid pode buscar informações em repositórios da Extensão Processos?

O servidor MCP da Lucid pode acessar informações em repositórios da Extensão Processos, mas não se limita aos documentos do repositório.  No entanto, o servidor MCP de repositórios da Lucid limita as ferramentas de pesquisa a pesquisar apenas repositórios e buscar documentos do repositório.

Os administradores do plano Corporativo podem restringir o acesso a clientes de IA específicos?
Conceder acesso ao servidor MCP da Lucid permite que os usuários se conectem a qualquer cliente de IA. Se uma conta precisar restringir o acesso a ferramentas de IA específicas, você precisará desativar o MCP no nível da conta.

Quais informações o servidor MCP da Lucid pode acessar?
O servidor MCP da Lucid pode acessar qualquer documento da Lucid que você tenha permissão para acessar em sua conta, incluindo títulos, conteúdo, comentários e metadados. Ele não pode acessar documentos pertencentes ou criados por usuários fora da sua conta.

Como meus dados são usados pelo servidor MCP da Lucid?
O servidor MCP da Lucid atua como um pass-through e não retém conteúdo de documentos, prompts de usuários ou consultas. Suas credenciais nunca são compartilhadas fora da sua conta da Lucid. O uso do servidor MCP da Lucid está sujeito ao contrato de serviços negociado entre as partes ou aos Termos de Serviço padrão da Lucid, disponíveis em https://lucid.co/tos.

Quais tipos de diagramas o servidor MCP da Lucid pode criar?
O servidor MCP da Lucid pode gerar qualquer tipo de diagrama compatível com a Lucid, como fluxogramas, organogramas, diagramas de sequência e diagramas de entidade-relacionamento. 

Embora o servidor possa criar automaticamente um diagrama a partir dos seus dados (por exemplo, transformando uma lista de funcionários em um organograma), ele cria apenas uma versão estática. Ele não consegue criar diagramas vinculados a dados que sejam atualizados automaticamente quando os dados de origem forem alterados. 

Como o servidor MCP da Lucid difere das conexões padrão de texto para IA?
O servidor MCP usa um formato de processamento de documentos para traduzir diagramas e textos complexos em uma estrutura projetada para LLMs. Isso garante que, ao pedir um resumo, a IA entenda a hierarquia e as relações do seu documento melhor do que as conexões padrão de texto para IA.

Há uma maneira de acompanhar quando os usuários da minha conta se conectam ao servidor MCP da Lucid? 
Sim, se sua conta tiver a extensão Enterprise Shield. Sempre que um usuário autoriza ou reautoriza uma ferramenta de IA pelo servidor MCP da Lucid, a Lucid registra um evento de auditoria que captura o nome do cliente e os detalhes da conexão. Para mais informações, confira o artigo de visão geral da extensão Enterprise Shield.

Recursos

Para saber mais sobre esta funcionalidade, consulte os recursos adicionais abaixo. Os recursos estão disponíveis apenas em inglês.

Publicações da comunidade

Apresentamos o servidor Model Context Protocol (MCP) da Lucid

Recursos externos

Para saber mais sobre servidores MCP, confira esta documentação externa:

• O que é o Model Context Protocol (MCP)?

Dar feedback sobre este artigo