Cinode

Forneça aos agentes uma visão de pessoas, projetos, habilidades e atribuições.

Ver em cinode.com

Documentação

O servidor Cinode MCP (Model Context Protocol) conecta com segurança clientes de IA e agentes compatíveis com MCP ao seu ambiente Cinode, permitindo que eles acessem os dados ao vivo da sua organização. Isso dá aos agentes a mesma visão contextual de pessoas, projetos, habilidades e atribuições que sua equipe tem, instantaneamente, para que possam auxiliar, analisar, atualizar e automatizar com confiança.

Pense nisso como dar ao seu assistente de IA um conhecimento prático da sua configuração Cinode, sem expor dados que você não quer compartilhar.

Por que usar o servidor MCP da Cinode?

  • Suporte de IA mais inteligente – Os agentes agem com contexto real dos seus dados Cinode
  • Fluxos de trabalho mais rápidos – Reduza o tempo gasto com atualizações e consultas manuais
  • Sempre sincronizado – Os agentes trabalham com informações ao vivo e atualizadas
  • Seguro por design – Controle de acesso granular sobre o que os agentes podem ver e alterar

Primeiros Passos

Você pode acessar nosso servidor MCP com Streamable HTTP em https://mcp.cinode.com/_mcp

Você precisa estar em um plano pago usando a Cinode para ter acesso à nossa API e ao nosso servidor MCP.

Métodos de Autenticação

Nosso servidor MCP suporta três métodos de autenticação. OAuth é a abordagem recomendada – não requer manipulação manual de tokens e é a opção mais segura. Bearer Token e Credenciais Básicas também são suportados para clientes que ainda não suportam OAuth:

  1. OAuth (recomendado): Login baseado em navegador. Sem manipulação manual de tokens. O cliente se identifica com um Documento de Metadados de ID de Cliente (CIMD), ou com Registro Dinâmico de Cliente (DCR) se ainda não suportar CIMD.
  2. Bearer Token: Autenticação por token de API estático
  3. Credenciais Básicas: Autenticação por Client ID e Client Secret

Tokens Bearer e credenciais básicas são informações sensíveis.

Nunca compartilhe ou armazene-os de forma insegura (por exemplo: em capturas de tela, documentos públicos/compartilhados, anexos de tickets, ferramentas de chat como Teams/Slack, e-mails, notas adesivas ou sites). Sempre use armazenamento seguro e transmita credenciais apenas por conexões criptografadas (HTTPS/TLS).

Como o OAuth funciona

Com OAuth, você não cria ou cola nenhum token. Clientes MCP suportados conectam-se à URL do servidor e lidam com a autenticação para você:

  1. Aponte o cliente para https://mcp.cinode.com/_mcp e escolha OAuth (ou simplesmente conecte, se o cliente detectar automaticamente).
  2. O cliente se identifica para a Cinode e inicia um fluxo de autorização OAuth 2.1. Um cliente que suporta Documentos de Metadados de ID de Cliente (CIMD) usa uma URL HTTPS como seu client ID, e a Cinode busca e verifica o documento de metadados nessa URL. Um cliente que não suporta CIMD registra-se automaticamente com Registro Dinâmico de Cliente (DCR, RFC 7591).
  3. Uma janela do navegador abre pedindo que você faça login na Cinode e aprove o acesso.
  4. Após a aprovação, o cliente recebe um token de acesso e conecta. O acesso é limitado aos seus próprios papéis e permissões na Cinode, exatamente como nos outros métodos.

Use CIMD onde seu cliente suportar. A especificação MCP afirma que clientes MCP e servidores de autorização devem suportar CIMD. A especificação marca DCR como obsoleto e o mantém apenas para compatibilidade reversa, portanto DCR não é recomendado. A Cinode suporta ambos os métodos, então conexões existentes continuam funcionando. Clientes que suportam CIMD o selecionam automaticamente ao conectar à Cinode, então você não precisa configurar nada.

Como funcionam as Credenciais Básicas

A autenticação básica usa seu Client ID e Client Secret:

  1. Junte-os com dois pontos: CLIENT_ID:CLIENT_SECRET
  2. Codifique a string completa em Base64.

Quando você gera uma Conta de API Pessoal na Cinode, mostramos uma string codificada e pronta para uso que você pode usar imediatamente no cabeçalho Authorization. Leia mais aqui.

Exemplos de Configuração

Os exemplos abaixo são modelos genéricos. Sempre consulte a documentação oficial do seu provedor para obter instruções de configuração mais atualizadas, pois os detalhes podem variar entre versões e provedores.

Para autenticação por Bearer token:

{
   "mcpServers": {
      "cinode": {       
         "command": "npx",       
         "args": [         
            "mcp-remote",
            "https://mcp.cinode.com/_mcp",         
            "--header",         
            "Authorization: ${AUTH_HEADER}"       
         ],
         "env": {         
            "AUTH_HEADER": "Bearer YOUR_CINODE_API_TOKEN"       
         }
      }
   }
}

Nota: Substitua "npx" acima por "C:\\Progra~1\\nodejs\\npx.cmd" se você estiver usando Windows.

Guias de Configuração para Provedores de LLM

Configurar ChatGPT

Siga estes passos para conectar o ChatGPT à Cinode através do servidor MCP da Cinode. Para detalhes mais recentes, consulte a documentação do modo Desenvolvedor da OpenAI.

Antes de começar

Sua organização precisa de um plano pago da Cinode.

Você precisa de uma conta ChatGPT Plus, Pro, Business, Enterprise ou Edu. Conectores MCP personalizados exigem o modo Desenvolvedor, que não está disponível no plano gratuito.

Configure a conexão no ChatGPT na web (chatgpt.com).

Em contas Business, Enterprise e Edu, um administrador do workspace deve permitir o modo Desenvolvedor primeiro.

  1. Abra o ChatGPT na web e vá para Configurações > Apps > Configurações avançadas.
  2. Ative o Modo Desenvolvedor.
  3. Volte para Configurações > Apps e clique em Criar app.
  4. Digite um nome, por exemplo Cinode, e cole a URL do servidor https://mcp.cinode.com/_mcp.
  5. Selecione OAuth como método de autenticação.
  6. Faça login na Cinode na janela pop-up e aprove o acesso.
  7. Abra o app da Cinode e ative as ferramentas que deseja usar.
  8. Inicie um novo chat, clique em + e selecione Modo Desenvolvedor, depois selecione o app da Cinode.
  9. Faça uma pergunta sobre seus dados da Cinode, por exemplo "Quais consultores estão disponíveis no próximo mês?", para verificar se a conexão funciona.

Segurança e Governança

Usar MCP junto com IA torna possível realizar alterações em larga escala e automatizadas nos seus dados da Cinode. Embora poderoso, isso também aumenta o risco de resultados não intencionais ou irreversíveis se os prompts estiverem incorretos ou forem mal testados.

Quando o acesso de escrita está habilitado, ações orientadas por IA podem modificar ou excluir grandes quantidades de dados em pouco tempo.

Você é responsável por como MCP e ferramentas de IA são usados na sua organização.
Alterações feitas através de MCP podem ser permanentes e nem sempre podem ser desfeitas.
Use os recursos de escrita do MCP por sua conta e risco.

Para reduzir riscos, a Cinode recomenda fortemente que você:

  • Habilite ferramentas de escrita apenas quando necessário e quando estiver confiante tanto na tecnologia quanto nas suas capacidades de prompt.
  • Valide prompts usando acesso somente leitura antes de permitir operações de criar, atualizar ou excluir.
  • Limite o acesso de escrita a usuários experientes que entendam o modelo de dados da Cinode e o impacto nos negócios.
  • Revise e monitore fluxos de trabalho automatizados regularmente.
  • Certifique-se de que as configurações de privacidade do seu provedor estejam de acordo com a política interna.

O servidor MCP da Cinode não envia seus dados para nenhum lugar por conta própria. Ele apenas responde às solicitações específicas feitas pelo cliente de IA que você conecta – e somente dentro das permissões da conta que autenticou.

O que é compartilhado, e com quem

  • Quando você conecta um cliente de IA (por exemplo Claude/Anthropic, ChatGPT/OpenAI ou Microsoft Copilot), esse cliente – não a Cinode – é a parte que processa seus prompts e os dados que recupera.
  • Apenas os dados que um agente realmente consulta são retornados a ele e passados ao seu provedor de IA escolhido. Não há exportação em massa ou sincronização em segundo plano do seu banco de dados da Cinode.
  • Cada solicitação é limitada aos papéis e permissões existentes do usuário conectado na Cinode. Um agente nunca pode ver ou alterar mais do que esse usuário já pode.

Suas responsabilidades

  • Como os dados recuperados são armazenados, retidos ou usados para treinamento de modelos é regido pelos termos e configurações de privacidade do seu provedor de IA escolhido, não pela Cinode. Revise e configure-os de acordo com sua política interna.
  • Qualquer acordo de processamento de dados (DPA) para processamento de IA é entre sua organização e o provedor de IA – não com a Cinode.
  • Habilite ferramentas de escrita apenas quando estiver confiante em seus prompts e permissões (veja Segurança e Governança acima).

Acesso e Permissões de Usuário

Por padrão, os funcionários podem criar contas de API pessoais e usar essas credenciais (por exemplo, tokens Basic) para conectar clientes MCP e ferramentas de IA à Cinode. Isso significa que o acesso MCP não precisa ser provisionado centralmente por um administrador.

Isso não é um risco de segurança por si só:

  • Uma conta de API pessoal não pode ser usada para fazer mais do que o usuário já pode fazer no aplicativo da Cinode.
  • Todas as ações realizadas através de MCP são limitadas pelos papéis e permissões existentes do usuário.
  • O acesso MCP segue os mesmos limites de permissão do uso interativo normal da Cinode.

Para organizações que desejam controle mais rígido, os administradores podem: