Ferramentas personalizadasBeta

Os comandos integrados cobrem a web, os seus arquivos e o seu próprio histórico. Uma ferramenta personalizada conecta o Glaido a qualquer outra coisa com uma API, como o seu gerenciador de tarefas, as suas notas ou os sistemas internos da sua empresa.

Você fala como de costume, o Glaido chama a ferramenta e a resposta fica pronta para colar no cursor.

Adicione a sua primeira ferramenta

Você não constrói ferramentas à mão e não precisa saber programar. Um agente de código com IA, como o Claude Code, o Cursor ou o Codex, constrói para você. A primeira leva cerca de dois minutos:

1. Abra o seu agente de código.

2. Cole este prompt e deixe rodar:

   I'm setting up custom tools for the Glaido dictation app. Read this guide and
   follow the instructions for coding agents: /docs/beta/tools
    
   Build the hello-world weather example from the guide (current weather for any
   city, using the free Open-Meteo API, no API key needed). It's a fixed demo:
   just run the commands from the guide without planning or questions, then tell
   me the exact folder to pick when I click Import folder on Glaido's Commands page.

3. Importe o resultado. Quando o agente terminar, abra Comandos na barra lateral do Glaido, vá para a aba Personalizado, clique em Importar pasta e selecione a pasta que ele criou. Ative o servidor com o interruptor.

Segure o seu atalho de comandos e pergunte “Qual é o clima em Amsterdã?”

O exemplo não precisa de chave de API nem de conta, então nada pode dar errado com credenciais. O agente instala o que mais precisar no caminho.

Ainda não tem um agente de código?

Instale um primeiro; é um app de desktop comum mais um comando de terminal. O Claude Code é um bom padrão. Quando estiver instalado e você tiver entrado, cole o prompt acima nele.

Crie a sua

Quando o exemplo de clima funcionar, use o mesmo prompt, mas troque o parágrafo do meio pela ferramenta que você quer. Por exemplo:

• “Conecte o Glaido ao meu espaço de trabalho do Notion”
• “Deixe o Glaido enviar mensagens no Slack”
• “Dê ao Glaido acesso à API interna da minha empresa”

O agente decide se já existe um servidor pronto para o seu serviço ou constrói um pequeno sob medida, configura as chaves de API em um arquivo local e entrega uma pasta para importar. Ele diz quais chaves definir e onde consegui-las.

Comece de um servidor vazio

Se você prefere ter a pasta pronta antes de abrir o agente de código, o Glaido pode montar uma para você. Na aba Personalizado, clique em Novo servidor.

1. 1

   Escolha um local

   O Glaido cria uma pasta para o servidor aqui. O padrão é ~/Glaido/servers, que guarda cada servidor que ele monta em um só lugar.

2. 2

   Escolha uma linguagem

   Python roda com uv, e o Glaido instala o FastMCP e trava o projeto. TypeScript roda com Bun, e o Glaido instala e trava o MCP SDK. Escolha a que você preferir ler; o seu agente de código lida com as duas.

3. 3

   Deixe o Glaido conferir a sua configuração

   O Glaido inicia o servidor sozinho, então precisa encontrar uv ou bun na sua máquina. Se não conseguir, mostra o comando que instala e um botão Verificar de novo. Se você tiver várias cópias instaladas, escolhe qual ele deve usar.

4. 4

   Dê um nome ao servidor

   É o que você vai ver na tela Comandos. Se já existir uma pasta com esse nome, o Glaido diz o nome que vai usar no lugar.

   Este é o último passo. Clicar em Criar grava a pasta. Antes disso, você pode voltar e mudar qualquer coisa.

5. 5

   Leve ao seu agente

   O servidor é criado vazio. O Glaido entrega um prompt para copiar no Claude Code, no Codex ou em outro agente de código, e um botão que revela a pasta no Finder ou no Explorer.

O Glaido observa essa pasta, então as ferramentas aparecem na tela Comandos conforme o seu agente salva. Você não precisa importar depois.

Instale a skill

O prompt acima faz o seu agente buscar as instruções novas a cada vez. Se você pretende criar mais ferramentas, instale a skill do repositório glaido-skills. O seu agente então conhece o fluxo inteiro de cor e dispara sozinho em qualquer pedido como “deixe o Glaido enviar mensagens no Slack”, sem prompt. Você também pode perguntar ao agente sobre a própria skill para entender como as ferramentas do Glaido funcionam.

git clone https://github.com/daveebbelaar/glaido-skills.git
mkdir -p ~/.claude/skills
cp -r glaido-skills/creating-glaido-mcp-servers ~/.claude/skills/

Estes comandos podem ser executados de novo sem problema: mkdir -p não faz nada se a pasta já existe, e copiar só adiciona ou atualiza esta skill, sem mexer nas outras que você tem instaladas. No Windows, rode no PowerShell.

Onde as suas ferramentas ficam

Duas pastas já vêm prontas, e vale a pena ficar com uma. Novo servidor monta em ~/Glaido/servers. O prompt do agente de código no topo desta página coloca o exemplo de clima em ~/Glaido/glaido-mcp-servers. Escolha a pasta em que você quer viver, diga ao agente para construir lá e mova o que tiver caído na outra.

Mantenha cada servidor novo nessa única pasta. Quando tiver alguns, transforme em um repositório git e envie para o GitHub. Você ganha histórico de versão das suas ferramentas, e configurar uma máquina nova vira clonar e importar. O seu agente de código pode fazer isso por você. Você pode guardar servidores onde quiser, mas, se mover um, importe de novo a partir do novo local.

Decidir o que roda sem perguntar

A aprovação cobre os servidores que você adicionou, mais um comando integrado. Analisar imagem pergunta antes de usar uma imagem da sua área de transferência. Veja Aprovar uma imagem da área de transferência.

Todo outro comando integrado roda sempre que o modelo chama, e o interruptor dele na aba Integrados decide se o modelo o vê. Isso inclui Arquivos e apps, que lê e abre coisas no seu disco sem perguntar antes. Desligue lá se preferir que não faça isso.

Nos seus próprios servidores, cada ferramenta tem uma política de aprovação. Clique no cartão de um servidor na página Comandos e defina por ferramenta:

Ferramentas que só leem dados começam em Automático; todo o resto começa em Perguntar. Quando uma ferramenta definida como Perguntar está prestes a rodar, um cartão de aprovação aparece na janela de comando:

Permitir uma vez roda a ferramenta desta vez, Sempre permitir muda para Automático, e Negar recusa a chamada. Enquanto o cartão está visível, pressionar Enter escolhe Permitir uma vez e nunca cola.

O cartão não espera para sempre. Deixe por 60 segundos e nada roda. O Glaido diz que parou de esperar e pergunta se deve tentar de novo.

Por que ferramentas locais e específicas?

O Glaido usa um modelo rápido para as respostas voltarem em cerca de um segundo, e modelos rápidos funcionam melhor com um conjunto pequeno de ferramentas específicas.

Por isso o Glaido roda ferramentas como servidores pequenos na sua própria máquina, em vez de conectar a grandes servidores MCP na nuvem. Esses em geral expõem dezenas de ferramentas amplas e genéricas, feitas para agentes de longa duração como o Claude Code, e carregar todas deixa um modelo rápido mais lento e menos preciso. Uma ferramenta que faz um trabalho bem (“ver o clima”, “adicionar uma tarefa”, “buscar nas minhas notas”) mantém o Glaido rápido.

Referência

Ferramentas personalizadas são servidores de Model Context Protocol (MCP) que rodam como processos locais na sua máquina. Gerencie-os na aba Personalizado:

• Novo servidor monta um vazio para você, como descrito acima.

• Importar pasta adiciona uma pasta que contém um arquivo mcp.json (ou .mcp.json). É o que o fluxo do agente de código produz.

• Editar, em Arquivo de configuração no rodapé da aba, abre o arquivo de configuração MCP do Glaido, ~/Glaido/mcp.json, no seu editor. Ele usa o formato padrão mcpServers compartilhado pela maioria dos clientes MCP:

  {
    "mcpServers": {
      "my-server": {
        "command": "npx",
        "args": ["-y", "@example/mcp-server"],
        "env": { "API_KEY": "your-key" }
      }
    }
  }

O Glaido recarrega a lista de servidores quando o arquivo muda.

Um cartão de servidor mostra um ícone de extensão, o nome do servidor, uma descrição de uma linha e até três das ferramentas dele como selos, com um selo +N a mais para o resto. À direita está o interruptor que o ativa. Nada mais aparece ali, a menos que o servidor tenha falhado ao iniciar, o que adiciona um selo de aviso ao ícone.

Clique no cartão para os detalhes: o ponto de status, cada ferramenta com a política de aprovação, a mensagem de falha se houver, a configuração que o Glaido roda e botões para atualizar as ferramentas, abrir a pasta ou excluir o servidor.

O Glaido roda cada servidor importado a partir da pasta que você importou, então um mcp.json não precisa de caminhos absolutos.

Quando um servidor não inicia

Um cartão que falhou traz um selo de aviso. Abra e o Glaido nomeia a causa, em vez de fazer você ler um log:

Quando um servidor parou com um código de saída, o Glaido nomeia o código na mensagem.

O Glaido detecta os três primeiros conferindo a sua configuração, então não há saída do servidor para mostrar. Para o resto, o que o servidor imprimiu aparece abaixo da mensagem no diálogo de detalhes. Peça ao seu agente de código para rodar o script de validação da skill; ele pega todos eles antes de você importar.

Para agentes de código

Se você é um agente de código enviado aqui para configurar uma ferramenta para o Glaido:

1. Busque e leia esta skill, depois siga exatamente: https://raw.githubusercontent.com/daveebbelaar/glaido-skills/main/creating-glaido-mcp-servers/SKILL.md

2. Se a pessoa pediu o exemplo de clima hello-world, você não precisa ler a skill nem mais nada: é uma demonstração fixa. Não planeje, não gere nem modifique código, não proponha locais de pasta e não peça aprovação. Confira se uv está instalado (instale em docs.astral.sh/uv se não estiver) e rode exatamente:

   TMP=$(mktemp -d)
   git clone --depth 1 https://github.com/daveebbelaar/glaido-skills.git "$TMP/glaido-skills"
   mkdir -p ~/Glaido/glaido-mcp-servers
   cp -r "$TMP/glaido-skills/examples/hello-world-weather" ~/Glaido/glaido-mcp-servers/hello-world-weather
   python3 "$TMP/glaido-skills/creating-glaido-mcp-servers/scripts/validate_glaido_mcp.py" ~/Glaido/glaido-mcp-servers/hello-world-weather

   (Windows: adapte para o PowerShell; clone em $env:TEMP em vez de mktemp.) Quando o validador informar “ready to import”, acabou. Ele já testa a inicialização do servidor, então pule qualquer verificação extra. O mcp.json é de propósito sem caminho; nada precisa de edição. Vá direto para os passos de importação abaixo.

3. Para qualquer outra coisa, a skill cobre reutilizar servidores MCP de terceiros existentes, montar os personalizados, configuração de ambiente, o esquema do mcp.json, validação e os passos de entrega.

4. O que você construir, a sua mensagem final precisa terminar com os passos exatos de importação para a pessoa: abra o app Glaido, clique em Comandos na barra lateral, vá para a aba Personalizado, clique em Importar pasta, depois no navegador de arquivos que abrir selecione a pasta inteira que você criou (a pasta em si, não um arquivo dentro dela) e confirme, e ligue o interruptor do servidor. Depois sugira um comando de voz que use a ferramenta nova.

A skill é a fonte da verdade e tem precedência sobre o resumo desta página.