Guia de Ferramentas Cherry

O Cherry Studio injeta ferramentas de primeira parte na sua sessão através de quatro servidores MCP (mcp__cherry-tools__*, mcp__agent-memory__*, mcp__skills__*, mcp__mcp-manager__*) e fornece aos agentes gerais com capacidade de shell runtimes empacotados para execução local. As ferramentas MCP agem sobre o aplicativo em execução — as bases de conhecimento do usuário, canais de IM, agendas, CLIs gerenciadas, biblioteca de habilidades e registro de servidores MCP — através de limites que apenas o Cherry possui. Ferramentas de shell e arquivo não conseguem alcançar esses limites do aplicativo corretamente; use os runtimes empacotados apenas para os casos de execução local roteados abaixo.

Este arquivo é um roteador. Ele contém apenas as regras globais e a tabela de intenção → ferramenta → referência. Cada referência contém os pré-requisitos do domínio, sequenciamento, disponibilidade condicional, interpretação de saída, recuperação e exemplos. Leia a referência que a tarefa necessita (e quaisquer que ela referencie cruzadamente) antes de chamar — não trabalhe apenas com esta página.

Os nomes das ferramentas aqui são totalmente qualificados (mcp__server__tool); os nomes exatos expostos na sua sessão são autoritativos se eles diferirem. Este guia nunca reafirma os formatos de argumento — o esquema de ferramenta ativo na sua sessão é a fonte autoritativa para nomes de parâmetros, enums e campos obrigatórios. Leia-o antes de cada chamada.

Regras globais

• Verifique a disponibilidade primeiro. Várias ferramentas são condicionais (cada referência diz quais). Se uma ferramenta não estiver na sua lista de ferramentas ativa, sua capacidade está indisponível nesta sessão — diga isso honestamente e pare; nunca finja que uma chamada foi bem-sucedida ou fabrique um resultado.
• Não contorne os limites de mutação do Cherry. Bases de conhecimento, canais de IM, agendas, CLIs gerenciadas, habilidades e servidores MCP registrados são mutados apenas através destas ferramentas. Não use shell para npm install, git clone, crontab, ou edite manualmente arquivos de conhecimento ou configurações MCP para realizar isso — a ferramenta faz o controle (registro, escopo, aprovação, sincronização) que um comando de shell bruto ignora. O shell é bom para inspeção (por exemplo, command -v para verificar o PATH) — apenas não para realizar a mutação de propriedade.
• Respeite a aprovação. mcp__cherry-tools__kb_manage, mcp__cherry-tools__cli_install, mcp__cherry-tools__session_create, mcp__cherry-tools__session_send, mcp__skills__install_skill e mcp__mcp-manager__install_mcp_server são controlados pelo modo de aprovação da sessão. Chame-os apenas quando a intenção do usuário estiver clara; se a aprovação for recusada, pare e relate — não tente o mesmo efeito por outra rota.
• A intenção ainda controla efeitos auto-aprovados. Gravações de memória, alterações de agenda, notificações e configuração de agente/canal podem ser executadas sem um cartão de aprovação. Não as chame meramente porque estão disponíveis; primeiro, certifique-se de que o usuário solicitou o efeito ou que ele é necessário para completar uma tarefa já aprovada.

Tabela de roteamento

…