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
-
Faça login no Operand.
-
No menu superior, clique no seu avatar e acesse Configurações.
-
No menu lateral, clique em Integrações.
-
Localize o card MCP ("Conecte o Operand a qualquer inteligência artificial").
-
No card, clique em Gerar token. Abre a janela Gerar token para conexão MCP.
-
Dentro da janela, clique em Gerar token.
-
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. -
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.
-
Abra o claude.ai, clique no seu usuário e acesse Personalização.
-
Clique na aba Conectores.
-
Clique em Adicionar e escolha Adicionar conector personalizado.
-
Em Nome, preencha
Operand. Em URL, cole a URL copiada na Parte 1. -
Clique em Continuar.
-
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.
-
Clique em Adicionar.
-
O conector é criado, mas ainda sem conexão ativa. Clique em Vincular.
-
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.
-
Na tela Autorizar acesso, que informa que o Claude quer acessar sua conta do Operand, clique em Autorizar.
-
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.
-
No ChatGPT, abra Configurações, vá em Segurança e login e ative o Modo desenvolvedor.
-
No menu lateral, clique em Plugins.
-
Clique no + ao lado de Pesquisar plugins e escolha Criar aplicativo.
-
Na janela Novo plugin, clique em Criar aplicativo MCP.
-
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. -
Marque Entendi e quero continuar e clique em Criar.
-
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.
-
Na tela Autorizar acesso, que informa que o ChatGPT quer acessar sua conta do Operand, clique em Autorizar.
-
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.