Principal API e Integrações
🧩

API e Integrações

Amanda R. Hass Carol Ledoux
Por Amanda R. Hass and 1 outro
• 3 artigos

Integração Operand + Hype Social: como conectar e enviar anexos para agendamento de posts

A integração permite conectar o sistema Operand à sua conta Hype Social usando um token de conexão. Depois de conectado, você pode selecionar um perfil do Hype Social e enviar um anexo de um job diretamente pelo Operand, para agendamento e publicação nas redes sociais. https://www.youtube.com/watch?v=LibSFZ9OnwY O título do job, os anexos selecionados e as descrições dos anexos chegam automaticamente no Workflow (Kanban) do perfil escolhido, sem precisar baixar e reenviar o arquivo manualmente. O fluxo é só de ida: do Operand para o Hype Social. O que você aprenderá - O que é o Hype Social e para que ele serve - Como conectar o Operand ao Hype Social - Como usar o botão do Hype Social na aba Anexos do Job - Como selecionar o perfil de destino e enviar um anexo - Quais tipos e limites de arquivo são aceitos - Como o anexo chega como card no Workflow do Hype Social, pronto para agendamento - Como desconectar a integração - Como resolver os problemas mais comuns de conexão Antes de começar - O que é o Hype Social: é uma plataforma de gestão de redes sociais, usada por agências e social medias para organizar conteúdo, agendar posts e publicar automaticamente no Instagram, Facebook, LinkedIn, YouTube, Threads, Google Meu Negócio e Tiktok. Cada cliente tem um workspace próprio, com calendário editorial, workflow independente e relatórios completos para acompanhar os resultados das redes sociais. - Quem pode conectar e desconectar: apenas usuários responsáveis pela conta ou perfil de administrador no Operand têm acesso à tela Configurações → Integração. Usuários com outros perfis não veem esse item de menu e não conseguem acessar a tela diretamente. - Onde o token é gerado: o token de integração é gerado exclusivamente no Hype Social, em Avatar → Conectores. O Operand não gera nem exibe esse token, apenas recebe o valor colado pelo usuário. - Prazo para colar o token: depois de gerado no Hype Social, o token precisa ser colado no Operand em até 1 hora. Passado esse prazo, o token expira e é preciso gerar um novo. - Sempre use o último token gerado: cada novo token cancela o anterior. Se você gerar mais de um token, cole sempre o mais recente no Operand. - Pré-requisito: ter uma conta ativa no Hype Social. Clientes Operand têm desconto na contratação. Passo a passo Conectar o Operand ao Hype Social 1. No Hype Social, acesse Avatar → Conectores e gere o token de integração. 2. Copie o token gerado e cole-o no Operand em até 1 hora, antes que ele expire. 3. No Operand, acesse Configurações → Integração. 4. Clique em Conectar. Isso abre a tela Conectar Hype Social, com o campo Token do Hype. 5. Cole o token no campo indicado. O botão Validar Token só fica habilitado depois que o campo é preenchido. 6. Clique em Validar Token. O Operand exibe o status Conectando enquanto confirma o token junto ao Hype Social. 7. Se o token for válido, a tela muda para o status Conectado. Clique em Fechar. Depois de fechar essa tela, o card de integração em Configurações passa a exibir o status Integrado, com o botão Desconectar no lugar de Conectar. Do lado do Hype Social, a conexão também é reconhecida automaticamente, sem precisar manter a janela do Hype Social aberta durante o processo. Atenção: o token só é salvo no Operand depois que a validação é concluída com sucesso. Se a validação falhar, nenhum token é salvo e é preciso tentar novamente. Detalhes adicionais Botão do Hype Social na aba Anexos do Job Depois de acessar a aba Anexos de um job, você encontra um botão fixo com o logotipo do Hype Social, ao lado do campo de upload de arquivo. Esse botão é visível para qualquer usuário com acesso a Jobs, independentemente do perfil. - Se sua conta ainda não está conectada ao Hype Social: o clique abre uma tela com informações sobre o Hype Social e um botão para conhecer o produto no site oficial. Se você tiver perfil de administrador ou for o responsável pelo Operand, essa tela também mostra o botão Conectar, que leva direto à tela Configurações → Integração. - Se sua conta já está conectada: o botão abre a seleção em massa para enviar vários anexos ao mesmo tempo, podendo escolher entre enviar todos agrupados para formar carrossel e stories, ou envio separado, que cada mídia vira um card no workflow do Hype. Selecionar o perfil e enviar um anexo Ao abrir a visualização de um anexo dentro do job, você encontra um botão do Hype Social ao lado do botão Solicitar aprovação. Esse botão aparece independentemente do status da sua conexão com o Hype Social. - Se sua conta não está conectada, o clique abre a mesma tela de conexão descrita acima. - Se sua conta já está conectada, o clique abre a tela Enviar para o Hype Social: 1. O Operand busca automaticamente os perfis ativos do seu workspace no Hype Social e os exibe no campo Perfil do Hype. 2. Selecione o perfil de destino, ou seja, o cliente para o qual o post será agendado. O campo é obrigatório, e o botão Enviar só fica habilitado depois da seleção. 3. Clique em Enviar. O Operand exibe o aviso Enviando... Aguarde! Estamos enviando o seu arquivo., indicando que a solicitação foi iniciada. 4. Para desistir sem enviar, clique em Cancelar. Tipos e limites de arquivo - O Operand pode enviar imagens, vídeos e documentos para o Hype Social. - Limites por envio: até 30 MB por imagem, até 500 MB por vídeo ou PDF, e no máximo 20 arquivos por envio. - É possível escolher, no Operand, se vários anexos de um envio viram um card por anexo ou todos juntos em um único card (útil para montar carrosséis, por exemplo no Instagram). Como o anexo chega no Workflow do Hype Social, pronto para agendamento - No Hype, o card aparece na primeira coluna do Workflow do perfil escolhido (normalmente Fazer), no fim da fila, em tempo real. - Se o perfil ainda não tiver nenhuma coluna configurada, o Hype Social cria automaticamente a coluna padrão e posiciona o card nela. - O título do card é o título do job no Operand, seguido do número do job. Exemplo: Título do Job #345. - O título do job, o anexo e a descrição do anexo já chegam preenchidos no card, mas podem ser editados livremente antes de agendar a publicação. A edição não remove a identificação de origem do card. - Ao abrir o card, há uma tag Operand, que leva diretamente ao job de origem no Operand. - A partir daí, o agendamento e a publicação nas redes sociais são feitos normalmente pelo calendário editorial do Hype Social, no perfil correspondente. Desconectar 1. Na tela Configurações → Integração, com o card no status Integrado, clique em Desconectar. 2. Confirme a ação na tela de confirmação. Ao confirmar, o token salvo no Operand é apagado e o card volta ao status desconectado. Essa opção só fica disponível para usuários root ou admin no Operand. Do lado do Hype Social, a desconexão feita pelo Operand também é reconhecida automaticamente, encerrando a conexão nos dois lados. Também é possível desconectar diretamente pelo Hype Social, na tela de Conectores, mas essa opção só aparece para usuários com perfil Administrador ou Gerente na conta do Hype Social. Se você desconectar, os cards que já foram importados continuam no Workflow, mas você deixa de receber novos anexos até reconectar. Recomendações importantes - Sempre copie o token diretamente da tela de Conectores do Hype Social e cole-o sem alterações no Operand, para evitar erros de validação. - Cole o token no Operand em até 1 hora após gerá-lo no Hype Social. Se o prazo passar, gere um novo token. - Se gerar mais de um token, use sempre o último gerado: cada novo token cancela o anterior, e colar um token antigo não funciona. - Se a validação do token falhar, revise se o valor colado está completo e tente novamente antes de contatar o suporte. - Confira os limites de tamanho e quantidade de arquivos antes do envio para evitar falhas. - Evite reenviar um anexo que já foi importado: a integração ainda não trata o reenvio do mesmo job, e reenviar pode gerar cards duplicados no Workflow. - O fluxo é só de ida, do Operand para o Hype Social. Mover ou concluir um card dentro do Hype Social não altera nada no Operand, e a integração não envia notificação automática quando um anexo vira card. - Clientes Operand têm desconto na contratação do Hype Social. Para contratar, crie uma conta em www.hypesocial.com.br. O time comercial do Hype Social dará seguimento ao atendimento e aplicará o desconto. Se o contrato com o Operand for cancelado, o desconto é retirado. Perguntas frequentes O que é o Hype Social? É uma plataforma de gestão de redes sociais, usada por agências e social medias para organizar conteúdo, agendar posts e publicar automaticamente no Instagram, Facebook, LinkedIn, YouTube, Threads, Google Meu Negócio e Tiktok. Cada cliente tem um workspace próprio, com calendário editorial, workflow independente e relatórios completos para acompanhar os resultados das redes sociais. Se interessou e ainda não assinou o Hype Social? Entre em contato pelo Whatsapp, no número 47 98880-0657 para saber mais informações. Quem consegue conectar o Operand ao Hype Social? Apenas usuários com perfil root ou admin no Operand têm acesso à tela Configurações → Integração, onde a conexão é feita. Onde eu gero o token de conexão? O token é gerado exclusivamente no Hype Social, em Avatar → Conectores. Depois, ele precisa ser colado na tela Configurações → Integração do Operand. Depois de gerar o token, tenho um tempo limite para fazer a conexão? Sim. Depois de gerado no Hype Social, você tem 1 hora para colá-lo no Operand. Se esse prazo passar, o token expira e é preciso gerar um novo. Depois que a conexão é validada com sucesso, ela permanece ativa por tempo indeterminado. Gerei mais de um token. Qual eu devo usar? Sempre o último token gerado. Cada novo token cancela o anterior, e colar um token antigo não funciona. O botão do Hype Social na aba Anexos aparece para qualquer usuário? Sim. Esse botão fica visível para todos os usuários com acesso a Jobs, independentemente do perfil. Já o botão Conectar, exibido quando a conta não está integrada, só aparece para usuários administradores ou para o responsável pelo Operand. Posso escolher para qual perfil do Hype Social um anexo é enviado? Sim. Ao clicar no botão do Hype Social dentro da visualização de um anexo, com a conta já conectada, você seleciona o perfil de destino, correspondente ao cliente e à rede social, antes de confirmar o envio. O que acontece depois que clico em Enviar? O Operand exibe uma mensagem indicando que o arquivo está sendo enviado. Em seguida, o título do job, o anexo e a descrição chegam automaticamente como um card na primeira coluna do Workflow do perfil escolhido no Hype Social, em tempo real, prontos para agendamento. Como sei que um card no Hype Social veio do Operand? Ao abrir o card, há uma tag "Operand" que leva diretamente ao job de origem. Em alguns casos essa tag pode aparecer sem link, mas isso não afeta o funcionamento do card. Posso editar o card depois que ele chega no Hype Social? Sim. O título, o anexo e a descrição já vêm preenchidos, e podem ser editados livremente antes de agendar a publicação. A edição não remove a identificação de que o card veio do Operand. Quantos arquivos posso enviar de uma vez, e existe limite de tamanho? Sim: até 30 MB por imagem, até 500 MB por vídeo ou PDF, e no máximo 20 arquivos por envio. É possível escolher se os anexos viram um card por anexo ou todos juntos em um único card, útil para carrosséis. Se eu mover ou concluir um card no Hype Social, isso muda algo no Operand? Não. O fluxo é só de ida, do Operand para o Hype Social. Ações feitas no card dentro do Hype Social não alteram nada no Operand. O token de conexão vale para a conta inteira ou perfil a perfil? O token vale para a conta inteira. Não há permissão configurada perfil a perfil dentro da integração. Existe um histórico dos envios feitos pela integração? Não. Hoje a integração não exibe um histórico ou log de envios dentro do Hype Social. Se eu desconectar, preciso gerar um novo token para reconectar depois? Sim. Ao desconectar, o token salvo no Operand é apagado. Para reconectar, é necessário repetir o processo de geração e validação do token. Os cards já importados continuam no Workflow do Hype Social. Você só deixa de receber novos anexos até reconectar. Reenviei o mesmo anexo e apareceu duplicado no Hype Social. Isso é normal? Hoje a integração não trata o reenvio do mesmo job, e reenviar pode gerar cards repetidos. O ideal é não reenviar um anexo que já foi importado. Precisa de ajuda? Se a validação do token falhar, verifique primeiro se o token foi colado dentro de 1 hora após a geração no Hype Social e se é o último token gerado. Se a conexão parar de funcionar, gere um novo token e repita o processo de validação. Se você enviou um anexo pelo Operand e ele não apareceu como card no Hype Social, verifique se a conexão está com status Integrado, se o perfil escolhido no envio é o correto e se o arquivo respeita os limites de tamanho e quantidade. Se o problema persistir mesmo após conferir esses pontos, se você notar cards duplicados, ou se encontrar qualquer mensagem de erro inesperada durante a conexão ou o envio, entre em contato com o suporte para que o time possa auxiliar

Última atualização em Oct 07, 2026

Como realizar a integração do Operand com outros sistemas via API Pública?

Como realizar a integração do Operand com outros sistemas via API Pública? A API pública possibilita a integração do Operand com outros sistemas :) Este recurso está disponível para o módulo financeiro, dessa forma, é possível realizar integrações com sistema de emissão de Nota Fiscal, emissão de Boletos, softwares de dashboard e BI e até mesmo sistemas próprios, desde que possuam integração via API. O que é uma API? Primeiro, é importante entender o que é uma API. API, Application Programming Interface, ou traduzido para o português, Interface de Programação de Aplicativos, é um conjunto de rotinas e padrões de programação que permite conectar ou acessar aplicativos e plataformas. Na prática, a API é uma porta criada no Operand, que permite que outras aplicações acessem informações de dentro do sistema. Como funciona a API Operand? Nós disponibilizaremos um token e a documentação da API, para que o próprio cliente desenvolva a integração entre o Operand e a aplicação desejada. ⚠️ Importante: o módulo API Operand não é um módulo gratuito. Ele precisa ser contratado para que a opção de gerar o token fique disponível na conta. Caso o módulo não tenha sido contratado, a opção de gerar token não aparecerá em Avatar > Configurações > Módulos e funções. Para contratar o módulo, entre em contato com o time financeiro ou com o seu Customer Success. Importante: O desenvolvimento da integração será de inteira responsabilidade do cliente e é recomendado que o procedimento seja realizado por um profissional técnico devido a sua complexidade. Como ativar a API Operand e gerar o token? O token gerado no Operand é a chave que permitirá que o sistema, que está recebendo a integração, tenha acesso às informações do Operand. Apenas o responsável da conta (root) e administradores possuem permissão para ativar a API e gerar essa chave. Para isso, basta acessar o seu Avatar > Configurações > Módulos e funções > API Operand > Gerar token, dessa forma, o sistema irá gerar um token que estará pronto para ser utilizado. Cada conta pode ter apenas um token ativo por vez, mas é possível gerar um novo token a qualquer momento clicando em gerar um novo token e depois em Confirmar. Ao gerar um novo token, o anterior será substituído. Caso existam integrações ativas elas serão automaticamente inativadas e será necessário atualizar o código do token nessas integrações para ativá-las novamente. Também é possível desativar o token se necessário, para isso clique em Desativar Token e depois em Confirmar. Fazendo isso, o token será invalidado automaticamente. Se houver integrações ativas elas serão automaticamente inativadas e será necessário gerar um novo token e atualizar o código nessas integrações para ativá-las novamente. Como acessar a documentação da API Pública Operand? Na página da API Operand, onde foi gerado o token, está disponível a documentação. Nesta documentação estão descritos os métodos e as variáveis que permitirão desenvolver a integração com o sistema que desejar, realizando consultas dentro do Operand e enviando essas informações para o sistema integrado. Além da documentação disponível dentro do Operand, a documentação técnica completa do módulo de API também pode ser consultada diretamente neste link: Documentação técnica da API Operand. Quais os passos para realizar a integração? O profissional técnico responsável pela integração deverá criar um ponto intermediário (módulo integrador) para realizar as conexões dos métodos descritos na documentação com os campos de entrada do sistema que será realizada a integração. Nesse momento serão utilizados o token gerado no Operand e a documentação da API. Para realizar a integração será necessário seguir os passos: 1. Possuir conhecimento para realizar o procedimento (é recomendado que esse processo seja realizado por um profissional técnico devido a sua complexidade). 2. Definir em qual sistema será realizada a integração e verificar se essa aplicação oferece integração via API. 3. Ler a documentação da API Pública Operand e da API da aplicação que será realizada a integração. 4. Ativar a função API Operand e gerar o token (é necessário que o módulo de API Operand esteja contratado). 5. Gerar o token na aplicação desejada (esse token é necessário para que o módulo integrador, que será desenvolvido, entregue as informações na aplicação desejada). 6. Desenvolver a integração para conectar o Operand à aplicação desejada. 7. Testar a integração. Se estiver tudo certo, a integração estará pronta para uso! :) Dica: caso queira realizar a integração mas não tenha alguém capacitado no time, é possível contratar uma empresa ou profissional qualificado para realizar o procedimento. Nós indicamos a Connect Think, parceira que já está familiarizada com a integração da API financeira do Operand com o Asaas e pode ajudar nesse processo. Para orçamento e contratação: (11) 4637-5282 | [email protected] Quanto custa o módulo de API Operand? O valor da liberação do módulo de API no sistema é de R$ 50,00 mensais, adicionado à mensalidade do plano contratado. A forma como esse valor é cobrado varia de acordo com o tipo de plano: Plano Mensal O valor da API é somado diretamente ao valor da mensalidade. Exemplo: mensalidade antes da API: R$ 600,00. Mensalidade depois da API: R$ 650,00. Planos Trimestral, Semestral e Anual Nesses planos, a forma de cobrança depende do momento em que o módulo é contratado: - Plano em andamento: o valor da API é multiplicado pelos meses restantes até a renovação do plano e dividido pelas parcelas ainda em aberto. Exemplo: R$ 50,00 x 4 (meses até a renovação) ÷ 2 (parcelas restantes) = R$ 100,00 adicionados em cada parcela. - Plano quitado: o valor da API é multiplicado pelos meses até a próxima renovação do plano e cobrado à vista. Exemplo: R$ 50,00 x 3 (meses até a próxima renovação) = R$ 150,00 à vista. - Renovação de plano: o valor da API é multiplicado pelos meses contratados de acordo com o tipo de plano, e dividido conforme o parcelamento negociado (à vista, 6x, 8x, etc.). Exemplo: R$ 50,00 x 12 meses (plano anual) ÷ 8 parcelas = R$ 75,00 adicionados em cada parcela do plano. API de Projetos e Jobs Além da API financeira, o Operand também disponibiliza a API de Projetos e Jobs. Ao contratar o módulo de API Operand, os endpoints de Projetos e Jobs já ficam disponíveis automaticamente, sem necessidade de liberação adicional. O que a API de Projetos e Jobs permite fazer? De forma geral, essa API permite consultar, criar e atualizar projetos, jobs e as tarefas vinculadas a eles diretamente a partir de um sistema externo integrado ao Operand. Projetos: | Ação | O que permite fazer | | --- | --- | | Buscar | Consultar os dados completos de um projeto específico a partir do seu ID. | | Listar | Listar os projetos cadastrados, com filtros por situação, status, título, privacidade e período de criação. | | Criar | Criar um novo projeto informando cliente, título, briefing e privacidade. | | Atualizar | Atualizar título, briefing, status, orçamento estimado e prazo desejado de um projeto existente. | | Remover | Remover um ou mais projetos a partir de uma lista de IDs. | Jobs: | Ação | O que permite fazer | | --- | --- | | Buscar | Consultar os dados completos de um job específico a partir do seu ID. | | Listar | Listar os jobs cadastrados, com filtros por situação, status, título, responsáveis, clientes, projetos e período de criação. | | Criar | Criar um novo job informando cliente, projeto, título, responsável, status, briefing, data de início e prazo. | | Atualizar | Atualizar título, briefing, responsável, status e prazo de um job existente. | Além dos projetos e jobs, a API também permite consultar, criar, atualizar e remover as tarefas vinculadas a cada job, seguindo o mesmo padrão de autenticação, paginação e filtros dos demais endpoints. A documentação técnica completa dessas rotas, com parâmetros, headers de autenticação e exemplos de requisição e resposta, está disponível no mesmo link da documentação técnica da API Operand: Documentação técnica da API Operand. Importante: a extração de dados de horas trabalhadas (timesheet) ainda não está disponível nessa API. Esse ponto já está mapeado para desenvolvimentos futuros. Webhook de Projetos, Jobs e Tarefas Além da API, a Operand também disponibiliza o Webhook de Projetos, Jobs e Tarefas, um recurso complementar à API. Qual a diferença entre a API e o Webhook? São duas funcionalidades complementares, mas independentes: - API: funciona por consulta. Seu sistema "pergunta" para o Operand sempre que precisa de uma informação, e recebe a resposta na hora. Por exemplo: seu sistema de BI quer montar um relatório de jobs em atraso, faz uma chamada para a API e recebe a lista atualizada naquele momento. - Webhook: funciona de forma automática. Em vez de você precisar consultar, o Operand avisa o seu sistema em tempo real sempre que um evento relevante acontece em um projeto, job ou tarefa — por exemplo, quando um job muda para o status "Concluído", o Operand dispara automaticamente um aviso para a URL configurada por você (podendo alimentar uma automação, um Slack, um CRM, etc.). É possível usar a API sem o Webhook, dependendo do caso de uso. Sem o Webhook, o cliente busca os dados manualmente sempre que quiser. Com o Webhook ativo, a Operand envia os dados automaticamente assim que algo muda. Quais eventos posso monitorar via Webhook? - Projetos: criação, edição/atualização e remoção de projeto. - Jobs: criação, edição/atualização e remoção de job. - Tarefas: criação, edição/atualização e remoção de tarefa. É possível monitorar mais de um tipo de evento no mesmo Webhook: um único endpoint pode receber, simultaneamente, notificações de criação, edição e exclusão de projetos, jobs e tarefas. O que é necessário para configurar o Webhook? 1. Ter o módulo de API Operand contratado e habilitado na conta. 2. Ter perfil de administrador, com acesso às configurações do sistema. 3. Ter uma URL HTTPS pública para receber as notificações. 4. Ter um servidor receptor ativo na internet, capaz de processar os eventos recebidos. Onde configurar o Webhook? A configuração fica disponível em Configurações > Módulos e Funções > API Operand, habilitando a opção de Webhooks e acessando Configurar Webhook — ou diretamente pelo menu lateral de Configurações > Webhook. As duas formas levam à mesma tela de gerenciamento. Dúvidas comuns sobre o Webhook - O módulo Webhooks não aparece no sistema: verifique se o módulo de API Operand está habilitado em Configurações > Módulos e Funções > API Operand. - Erro 401 na autenticação: confirme se a chave (hash) usada no servidor do seu sistema corresponde exatamente à chave gerada no momento do cadastro do Webhook. - Recebimento de eventos duplicados: para evitar o processamento repetido de um mesmo evento, recomendamos implementar idempotência no seu endpoint, usando um identificador único por evento.

Última atualização em Oct 22, 2026

Como conectar o Operand ao Claude e ao ChatGPT com o MCP

Resposta rápida O MCP do Operand conecta a sua conta do Operand ao Claude e ao ChatGPT. Depois de conectado, você pede em linguagem natural para a IA consultar, criar e atualizar projetos, jobs e tarefas, sem sair da conversa. Para conectar, gere um token em Configurações > Integrações > MCP no Operand e cadastre o Operand como conector no Claude ou como aplicativo no ChatGPT. A IA só acessa o que o seu usuário já pode ver e fazer no Operand. O que você aprenderá Neste artigo, você vai entender como usar o MCP para trabalhar com o Operand dentro de uma IA. Você verá: - O que é o MCP e o que ele permite fazer hoje - Como gerar o token de conexão no Operand - Como conectar o Operand ao Claude - Como conectar o Operand ao ChatGPT - Quais cuidados de segurança adotar - Exemplos de pedidos que você pode fazer à IA Antes de começar Requisito para usar o MCP O acesso ao MCP depende da API pública do Operand. Antes de começar, confirme que a sua empresa tem a API pública contratada. Sem ela, o MCP não fica disponível para a sua conta. Em caso de dúvida, fale com o time responsável pela sua conta no Operand. O que é o MCP O MCP (Model Context Protocol) é um padrão aberto que permite que assistentes de IA se conectem a sistemas externos. Com o MCP do Operand, o Claude e o ChatGPT acessam a sua conta e usam informações de projetos, jobs e tarefas durante a conversa. Isso reduz o tempo gasto navegando entre telas para consultar ou atualizar registros. Quem pode executar Qualquer usuário que consiga acessar Configurações > Integrações no Operand e tenha uma conta no Claude ou no ChatGPT. Quando utilizar Use o MCP quando quiser consultar, criar ou atualizar projetos, jobs e tarefas conversando com a IA, em vez de abrir cada tela do Operand. Restrições - O MCP respeita as permissões do Operand. Toda ação roda como o usuário dono do token. Se você não vê um job pelo site, a IA também não vê. - O Timesheet ainda não está contemplado. A IA não consegue lançar nem consultar horas. - No ChatGPT, é preciso ativar o Modo desenvolvedor antes de adicionar o Operand. Impactos Gerar um novo token invalida o anterior. As conexões feitas com o token antigo precisam ser refeitas. Passo a passo O processo tem duas etapas: gerar o token no Operand (igual para as duas IAs) e cadastrar o Operand na IA que você usa. Parte 1: gerar o token no Operand 1. Faça login no Operand. 2. No menu superior, clique no seu avatar e acesse Configurações. 3. No menu lateral, clique em Integrações. 4. Localize o card MCP ("Conecte o Operand a qualquer inteligência artificial"). 5. No card, clique em Gerar token. Abre a janela Gerar token para conexão MCP. 6. Dentro da janela, clique em Gerar token. 7. A tela mostra dois campos: URL, o endereço do servidor MCP do Operand (termina em /mcp/operand), e Token, uma chave longa copiada automaticamente para a área de transferência. 8. Copie e guarde a URL e o token em um lugar seguro, como um gerenciador de senhas. Importante: o token funciona como uma senha de acesso à conta do Operand. Não compartilhe com ninguém. Parte 2: conectar o Operand ao Claude Com a URL e o token em mãos, siga os passos no claude.ai. 1. Abra o claude.ai, clique no seu usuário e acesse Personalização. 2. Clique na aba Conectores. 3. Clique em Adicionar e escolha Adicionar conector personalizado. 4. Em Nome, preencha Operand. Em URL, cole a URL copiada na Parte 1. 5. Clique em Continuar. 6. Confirme as opções de autenticação. O Claude detecta a configuração do Operand e já marca as opções recomendadas: Autenticação como "Entrar agora", Cliente OAuth como "Registrar automaticamente" e Cabeçalhos de requisição em branco. Não é preciso alterar nada. 7. Clique em Adicionar. 8. O conector é criado, mas ainda sem conexão ativa. Clique em Vincular. 9. Uma nova aba abre com a tela Conectar ao Operand. Cole o token copiado na Parte 1 no campo Token da API Operand e clique em Continuar. 10. Na tela Autorizar acesso, que informa que o Claude quer acessar sua conta do Operand, clique em Autorizar. 11. De volta à página do conector, ele aparece como vinculado. Revise as Permissões de ferramentas (veja a seção Detalhes adicionais). Parte 3: conectar o Operand ao ChatGPT Com a URL e o token em mãos, siga os passos no ChatGPT. Antes, é preciso ativar o Modo desenvolvedor. Atenção: o Modo desenvolvedor permite conectores não verificados, que podem modificar ou apagar dados. Ative apenas para esta conexão e desative depois, se não precisar mais. 1. No ChatGPT, abra Configurações, vá em Segurança e login e ative o Modo desenvolvedor. 2. No menu lateral, clique em Plugins. 3. Clique no + ao lado de Pesquisar plugins e escolha Criar aplicativo. 4. Na janela Novo plugin, clique em Criar aplicativo MCP. 5. Preencha o formulário: em Nome, Operand; em Conexão, mantenha URL do servidor e cole a URL copiada na Parte 1; em Autenticação, escolha OAuth. 6. Marque Entendi e quero continuar e clique em Criar. 7. Clique em Entrar com Operand. Na primeira conexão, abre a tela Conectar ao Operand. Cole o token no campo Token da API Operand e clique em Continuar. 8. Na tela Autorizar acesso, que informa que o ChatGPT quer acessar sua conta do Operand, clique em Autorizar. 9. Confira a conexão. O Operand aparece em Plugins com a conta conectada. Se a lista Ferramentas aparecer vazia, clique em Atualizar na seção Informação. Detalhes adicionais O que a IA consegue fazer hoje | Módulo | O que a IA consegue fazer | Status | | --- | --- | --- | | Projetos | Listar, consultar, criar e atualizar projetos; adicionar e remover envolvidos | Disponível | | Jobs | Listar e contar jobs (com filtros por responsável, status, situação e outros), consultar, criar, atualizar, mover para outro projeto, gerenciar envolvidos e o fluxo (workflow) do job | Disponível | | Tarefas | Listar, consultar, criar e atualizar tarefas (itens de checklist do job), incluindo concluir; criar e remover dependências entre tarefas | Disponível | | Apoio | Consultar usuários, clientes e status para preencher corretamente campos como responsável e cliente do job | Disponível | | Timesheet | Apontamento e consulta de horas | Disponível | Permissões das ferramentas no Claude Na página do conector, o Claude lista as Permissões de ferramentas em dois grupos: - Ferramentas somente leitura: consultas, como obter um job, listar projetos e listar usuários. - Ferramentas de gravação/exclusão: ações que criam, atualizam ou removem dados, como criar um job, adicionar envolvidos a um projeto e remover dependências de uma tarefa. Para cada ferramenta, você escolhe o nível de permissão: Requer aprovação (padrão, o Claude pede confirmação antes de usar), sempre permitir ou sempre negar. Permissões no ChatGPT No ChatGPT, ajuste as permissões do aplicativo em Permissões, na página do Operand em Plugins. Exemplos de pedidos Depois de conectado, converse com a IA normalmente. Alguns pedidos que funcionam: - Quais são minhas tarefas pendentes para esta semana? - Liste os jobs ativos do projeto Lançamento Verão. - Crie um job "Post Black Friday" para o cliente X, com a pessoa responsável Y. - Marque como concluída a tarefa "Revisar layout" do job 1234. Recomendações importantes - Trate o token como uma senha. Não compartilhe nem cole em lugares públicos. - No Claude, mantenha Requer aprovação nas ferramentas de gravação/exclusão. Assim, você revisa cada ação antes que ela seja executada no Operand. - No ChatGPT, ative o Modo desenvolvedor apenas para esta conexão e desative depois, se não precisar mais. - Para revogar o acesso, no Claude clique em Desvincular na página do conector. No ChatGPT, remova o aplicativo em Plugins. - Também é possível invalidar o acesso gerando um novo token no Operand. O token anterior deixa de funcionar. - Se suspeitar que o token vazou, gere um novo imediatamente em Configurações > Integrações > MCP. Perguntas frequentes Preciso gerar um token diferente para o Claude e para o ChatGPT? Não. A geração do token é a mesma para as duas IAs. Ao gerar um token novo, porém, o anterior é invalidado e as conexões feitas com ele precisam ser refeitas. Gerei um token novo. Como atualizo a conexão? No Claude, desvincule e vincule o conector de novo, informando o novo token. No ChatGPT, a tela Autorizar acesso tem o link "Gerou um token novo no Operand? Conectar com outro token". A IA não encontra um job ou projeto que existe. O que fazer? O MCP respeita as permissões do usuário dono do token. Se essa pessoa não tem acesso ao registro no Operand, a IA também não tem. No ChatGPT, a lista de Ferramentas está vazia. O que fazer? Clique em Atualizar na seção Informação, na página do aplicativo Operand. Posso lançar horas (timesheet) pela IA? Ainda não. O Timesheet está em desenvolvimento. Hoje, o MCP atende projetos, jobs e tarefas. A IA pode apagar ou alterar dados sem eu perceber? No Claude, com Requer aprovação ativo, toda ação de gravação pede confirmação antes de ser executada. No ChatGPT, ajuste as permissões do aplicativo em Permissões. Nos dois casos, a ação só alcança o que o seu usuário já pode fazer no Operand. Precisa de ajuda? Se ainda tiver dúvidas sobre a conexão do MCP, fale com o time de suporte do Operand pelos canais de atendimento.

Última atualização em Oct 22, 2026