Servidor MCP · Manual do Haru

O Haru traz um servidor MCP (Model Context Protocol) embutido: o padrão que assistentes como o Claude e o ChatGPT usam para falar com outras ferramentas. Conectado, o assistente lê o seu dia e, se você deixar, cria, planeja e conclui tarefas, registra horas, responde convites e mais. O servidor faz parte de todos os planos.

https://app.harutodo.app/mcp

Conectar o seu assistente#

Claude (claude.ai, Claude Desktop e celular)#

Abra Configurações → Conectores

No Claude, em Adicionar conector personalizado.
Cole o endereço

https://app.harutodo.app/mcp, com o nome que quiser (por exemplo, "Haru").
Autorize no Haru

O Claude abre a tela de consentimento do Haru. Entre, se ainda não estiver, e clique em Permitir. Veja a tela de consentimento.

ChatGPT#

Ative o modo desenvolvedor

Em Configurações → Apps e conectores.
Crie um conector

Com a URL https://app.harutodo.app/mcp e autenticação OAuth.
Autorize no Haru

Na tela de consentimento, clique em Permitir.

Claude Code#

No terminal:

claude mcp add --transport http haru https://app.harutodo.app/mcp

Depois, dentro do Claude Code, rode /mcp para autenticar: o navegador abre na tela de consentimento.

Outros clientes MCP#

Qualquer cliente que fale MCP por HTTP (Streamable HTTP) com OAuth 2.1 funciona: o Haru aceita o registro dinâmico do cliente e PKCE, então basta informar a URL.

A tela de consentimento#

Ao conectar, o Haru mostra "<App> quer acessar seu Haru", com:

Vai voltar paraendereços

Para onde o app volta depois da autorização. Se aparecerem vários endereços, o Haru avisa: "Este app pode voltar para qualquer um desses endereços. Só permita se reconhecer todos."

Workspacelista

Só para quem tem mais de um. "O app vai trabalhar só neste workspace. Para usar outro, conecte de novo."

Ver seus projetos, tarefas, agenda e registros de tempoleiturasempre

A permissão de leitura (compasso:read).

Criar, alterar e apagar dadosescritaopcional

A permissão de escrita (compasso:write). Desmarcada, o assistente só lê: as ferramentas de escrita nem aparecem para ele.

Manter o acesso conectado (renovação automática)opcional

Deixa o app renovar o acesso sozinho, sem pedir para você entrar de novo.

Clique em Permitir ou Negar. Você pode revogar quando quiser em Configurações → Apps conectados.

O que o assistente pode (e não pode)#

Ele trabalha num workspace só, o que você escolheu ao conectar.
Ele enxerga o mesmo que você: o seu papel no workspace e o seu nível em cada projeto (Ver, Editar, Gerenciar) valem para ele também. Projetos privados em que você não entrou não existem para ele.
Ele não dá acesso a projetos, não envia convites para o workspace e não conecta contas de Google, Microsoft, Jira e afins: isso só pelo app.
As ferramentas que alteram ou apagam o que já existe (update_*, complete_task, delete_*, disconnect_connection…) são marcadas como destrutivas, e o seu cliente pede confirmação antes de usá-las. As que só leem rodam direto, e as que só criam (create_*, log_time, add_task_comment…) seguem a regra de permissão do seu cliente.
As ferramentas de pull requests e de objetivos seguem o plano do workspace: no Pessoal, elas respondem que o recurso é do Pro.
O Haru orienta o assistente a tratar o texto das tarefas, comentários e compromissos como dado, e não como instrução: um pedido escrito dentro de uma tarefa deve ser confirmado com você antes de ser seguido.

Exemplos de pedidos#

"O que tenho para hoje? Encaixa as tarefas sem horário antes do almoço."
"Cria uma tarefa P1 no projeto Gless para revisar o contrato, com prazo sexta."
"Quanto tempo gastei no projeto Netsuite esta semana?"
"Planeja minha quinta: a proposta de manhã e a tarde livre para o sprint."
"Aceita o convite da daily de amanhã e recusa o da reunião de sexta."
"Lê a descrição e o guia da tarefa HCM-142 e me diz o que falta."

Revogar#

Em Configurações → Apps conectados, clique em Revogar no app. O acesso cai em até 30 segundos. Para usar outro workspace com o mesmo assistente, revogue e conecte de novo, escolhendo o outro workspace.

A lista completa do que o assistente pode fazer está em Ferramentas MCP.