Harumi no ChatGPT e no Claude
Conecte a Harumi ao ChatGPT ou ao Claude pelo servidor MCP da Harumi e pergunte sobre seus projetos, execuções e dashboards em linguagem natural.
Visão geral
O servidor MCP da Harumi conecta sua conta Harumi a um app de chat — ChatGPT ou Claude — pelo Model Context Protocol. Depois de conectar, você pode perguntar sobre seu trabalho sem sair do chat: quais projetos você tem, se a execução de ontem à noite terminou, por que uma execução falhou, o que o dashboard dela mostra. As respostas vêm direto da Harumi.
Os resultados aparecem no próprio chat como cartões no estilo da Harumi — as mesmas cores de status, os mesmos selos de branch e o mesmo log em fonte monoespaçada que você vê na plataforma —, então uma lista de execuções no chat tem a mesma cara de uma lista de execuções na Harumi, com um link Open in Harumi de volta para a plataforma.
O servidor fica em:
https://mcp.harumi.io/mcpConectar
Adicione a Harumi como conector
Adicione um conector personalizado (um servidor MCP remoto) no seu app de chat e informe a URL acima.
- Claude — adicione um conector personalizado nas configurações de conectores do Claude.
- ChatGPT — adicione um conector personalizado (um app) nas configurações do ChatGPT. Dependendo do seu plano, o ChatGPT pode exigir que o modo desenvolvedor esteja ativado antes.
Não é preciso client ID nem secret: o app de chat se registra no servidor automaticamente.
Entre com seu email da Harumi
O app de chat abre uma página Connect to Harumi. Digite seu Harumi email e clique em Send me a code; depois digite o código de uso único que chegou no seu email e clique em Connect. É o mesmo código por email que você usa para entrar na plataforma e na CLI.
Faça uma pergunta
De volta ao chat, experimente:
- "Liste meus projetos na Harumi."
- "A última execução do Demand Planning terminou?"
- "Mostre as últimas 200 linhas do log daquela execução que falhou."
- "Mostre o dashboard da última execução concluída."
Ainda não tem conta na Harumi?
A página de entrada não cria contas. Se seu email não for reconhecido, crie uma conta na plataforma Harumi primeiro — veja Configuração da conta — e conecte de novo.
O que você pode fazer
O servidor expõe uma ferramenta por área da Harumi, cada uma com algumas ações. A lista completa está na referência de ferramentas.
| Área | Ler | Alterar |
|---|---|---|
| Perfil e organizações | seu perfil, suas organizações, os membros delas | os campos do seu próprio perfil |
| Projetos | listar projetos com o status da última execução, buscar um pelo nome | — |
| Execuções | listar execuções, uma execução completa, o log dela, o dashboard dela | iniciar uma execução, cancelar uma execução |
| Repositório | arquivos, pastas, branches, commits, conteúdo de arquivo, prontidão, download em zip | branches temporárias e os arquivos nelas |
| Arquivos | os arquivos de um projeto e o conteúdo deles | enviar, remover |
| Fontes de dados | listar, detalhes, executar uma consulta de leitura | — |
| Agendamentos | listar, detalhes | adicionar, atualizar, remover |
| Segredos | só os nomes dos segredos | definir, remover |
| Links de compartilhamento | listar, detalhes | adicionar, atualizar, remover, rotacionar, definir ou remover senha |
| Catálogo | kernel specs, templates de projeto | — |
Respostas longas são cortadas, não descartadas
Apps de chat têm espaço limitado, então resultados grandes têm um limite — e sempre avisam quando o atingem:
- O log de uma execução traz as últimas 200 linhas por padrão, com um aviso e um link para o log completo. Peça mais linhas se precisar.
- Conteúdo de arquivo acima de 20.000 caracteres é cortado, com um link para o arquivo na Harumi. Um envio acima desse tamanho é recusado, com um link para concluí-lo na plataforma.
- Uma consulta a uma fonte de dados traz no máximo 100 linhas.
- Um arquivo zip do repositório grande demais volta como link de download.
Segurança
A Harumi não tem escopos de permissão: a conexão age com sua conta completa, do mesmo jeito que você na plataforma. O servidor foi construído em torno disso.
- Mudanças sem volta pedem confirmação. Ferramentas que podem remover ou sobrescrever algo — cancelar uma execução, remover um arquivo, agendamento, segredo ou link de compartilhamento, rotacionar um link de compartilhamento — são marcadas como destrutivas, então seu app de chat pede sua confirmação antes de executá-las.
- Algumas ações nunca estão disponíveis. O servidor não exclui um projeto, uma organização ou uma fonte de dados; não convida nem remove pessoas nem muda papéis; não promove uma branch para live nem escreve na branch live; e não mexe em cobrança.
- Segredos continuam secretos. O servidor lista os nomes dos segredos, mas nunca devolve o valor de um segredo, a senha de uma fonte de dados ou a senha de um link de compartilhamento.
- Seu token da Harumi nunca chega ao app de chat. O servidor guarda suas credenciais da Harumi criptografadas do lado dele e entrega ao app de chat um token próprio.
- Uma mudança que falha diz se aconteceu. Se a Harumi recusou a mudança, a resposta diz isso e dá o motivo. Se o resultado não está claro (por exemplo, um timeout), a resposta diz que não sabe, em vez de sugerir tentar de novo às cegas — assim uma execução não é iniciada duas vezes.
Continuar conectado
Sua conexão dura 30 dias e se renova a cada uso. Se ela expirar, ou se o servidor desconectar todo mundo, seu app de chat pede para você conectar de novo — nada na sua conta Harumi é afetado. Para desconectar, remova o conector da Harumi do seu app de chat.