Eigen toolsBèta

Ingebouwde opdrachten dekken het web, je bestanden en je eigen geschiedenis. Een eigen tool koppelt Glaido aan al het andere met een API, zoals je takenlijst, je notities of de interne systemen van je bedrijf.

Je spreekt zoals altijd, Glaido roept de tool aan, en het antwoord staat klaar om te plakken bij je cursor.

Voeg je eerste tool toe

Je bouwt tools niet met de hand, en je hoeft niet te weten hoe je codeert. Een AI-codeeragent zoals Claude Code, Cursor of Codex bouwt ze voor je. Je eerste duurt ongeveer twee minuten:

1. Open je codeeragent.

2. Plak deze prompt en laat hem lopen:

   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. Importeer het resultaat. Als de agent klaar is, open je Opdrachten in de zijbalk van Glaido, ga je naar het tabblad Eigen, klik je op Map importeren en selecteer je de map die hij heeft gemaakt. Schakel de server in met zijn schakelaar.

Houd je sneltoets voor opdrachten ingedrukt en vraag "Wat is het weer in Amsterdam?"

Het voorbeeld heeft geen API-sleutel en geen account nodig, dus er kan niets misgaan met inloggegevens. De agent installeert onderweg al het andere dat hij nodig heeft.

Nog geen codeeragent?

Installeer er eerst een. Het is een gewone desktopapp plus een terminalopdracht. Claude Code is een goede standaard. Zodra die is geïnstalleerd en je bent ingelogd, plak je de prompt hierboven erin.

Bouw je eigen

Als het weervoorbeeld werkt, gebruik je dezelfde prompt, maar vervang je de middelste alinea door de tool die je wilt. Bijvoorbeeld:

• "Koppel Glaido aan mijn Notion-werkruimte"
• "Maak dat Glaido Slack-berichten kan sturen"
• "Geef Glaido toegang tot de interne API van mijn bedrijf"

De agent beslist of er al een kant-en-klare server voor je dienst bestaat of bouwt een kleine eigen, zet eventuele API-sleutels in een lokaal bestand en geeft je een map om te importeren. Hij zegt welke sleutels je moet instellen en waar je die vandaan haalt.

Begin in plaats daarvan met een lege server

Heb je de map liever klaar voordat je je codeeragent opent, dan kan Glaido er een voor je neerzetten. Klik op het tabblad Eigen op Nieuwe server.

1. 1

   Kies een locatie

   Glaido maakt hier een map voor de server. De standaard is ~/Glaido/servers, zodat elke server die het neerzet op één plek staat.

2. 2

   Kies een taal

   Python draait met uv, en Glaido installeert FastMCP en vergrendelt het project. TypeScript draait met Bun, en Glaido installeert en vergrendelt de MCP SDK. Kies wat je liever leest. Je codeeragent kan beide aan.

3. 3

   Laat Glaido je omgeving controleren

   Glaido start de server zelf, dus het moet uv of bun op je computer vinden. Lukt dat niet, dan toont het de ene opdracht die hem installeert en een knop Opnieuw controleren. Heb je meerdere exemplaren geïnstalleerd, dan kies je welke het moet gebruiken.

4. 4

   Geef je server een naam

   Dit is wat je op het scherm Opdrachten ziet. Bestaat er al een map met die naam, dan zegt Glaido welke naam het in plaats daarvan gebruikt.

   Dit is de laatste stap. Een klik op Aanmaken schrijft de map. Daarvoor kun je terug en alles wijzigen.

5. 5

   Neem hem mee naar je agent

   De server is aangemaakt en leeg. Glaido geeft je een prompt om te kopiëren naar Claude Code, Codex of een andere codeeragent, en een knop die de map toont in Finder of Verkenner.

Glaido houdt die map in de gaten, dus de tools verschijnen op het scherm Opdrachten terwijl je agent ze opslaat. Je hoeft hem daarna niet te importeren.

Installeer de skill

De prompt hierboven laat je agent de instructies elke keer vers ophalen. Ga je meer tools bouwen, installeer de skill dan uit de repository glaido-skills. Je agent kent daarna de hele werkwijze uit het hoofd en start hem automatisch bij een verzoek als "maak dat Glaido Slack-berichten kan sturen", zonder prompt. Je kunt de agent ook vragen stellen over de skill zelf, om te begrijpen hoe Glaido-tools werken.

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

Deze opdrachten kun je veilig opnieuw uitvoeren: mkdir -p doet niets als de map al bestaat, en kopiëren voegt alleen deze ene skill toe of werkt hem bij, zonder andere skills die je hebt geïnstalleerd aan te raken. Op Windows voer je ze uit in PowerShell.

Waar je tools staan

Er komen twee mappen uit de doos, en het loont om er één te kiezen. Nieuwe server zet neer in ~/Glaido/servers. De prompt voor de codeeragent bovenaan deze pagina zet het weervoorbeeld in ~/Glaido/glaido-mcp-servers. Kies de map waarin je wilt blijven, zeg tegen je agent dat hij daar moet bouwen, en verplaats wat in de andere terechtkwam.

Houd elke nieuwe server in die ene map. Heb je er een paar, maak er dan een git-repository van en push die naar GitHub. Je krijgt versiegeschiedenis voor je tools, en een nieuwe computer instellen wordt klonen en importeren. Je codeeragent kan dit voor je doen. Je kunt servers neerzetten waar je wilt, maar verplaats je er een, importeer hem dan opnieuw vanaf de nieuwe plek.

Bepalen wat zonder vragen loopt

Goedkeuring dekt de servers die je hebt toegevoegd, plus één ingebouwde opdracht. Afbeelding analyseren vraagt voordat het een afbeelding van je klembord gebruikt. Zie Een klembordafbeelding goedkeuren.

Elke andere ingebouwde opdracht loopt telkens als het model hem aanroept, en zijn schakelaar op het tabblad Ingebouwd bepaalt of het model hem überhaupt ziet. Dat geldt ook voor Bestanden en apps, dat dingen op je schijf leest en opent zonder eerst te vragen. Zet hem daar uit als je dat liever niet hebt.

Voor je eigen servers heeft elke tool een goedkeuringsbeleid. Klik op een serverkaart op de pagina Opdrachten en stel het per tool in:

Tools die alleen gegevens lezen, staan standaard op Automatisch. Al het andere staat standaard op Vragen. Staat een tool op Vragen en staat hij op het punt te lopen, dan verschijnt er een goedkeuringskaart in het opdrachtvenster:

Eén keer toestaan voert de tool deze ene keer uit, Altijd toestaan zet hem op Automatisch, en Weigeren wijst de aanroep af. Zolang de kaart zichtbaar is, kiest Enter Eén keer toestaan en plakt het nooit.

De kaart wacht niet eindeloos. Laat je hem 60 seconden liggen, dan loopt er niets. Glaido zegt dat het is gestopt met wachten en vraagt of het het opnieuw moet proberen.

Waarom lokale, specifieke tools?

Glaido gebruikt een snel model zodat antwoorden in ongeveer een seconde terugkomen, en snelle modellen werken het best met een kleine set specifieke tools.

Daarom laat Glaido tools lopen als kleine servers op je eigen computer, in plaats van te koppelen aan grote cloud-MCP-servers. Die bieden doorgaans tientallen brede, algemene tools, gemaakt voor langlopende agenten zoals Claude Code, en ze allemaal laden maakt een snel model trager en minder nauwkeurig. Een tool die één ding goed doet ("het weer ophalen", "een taak toevoegen", "mijn notities doorzoeken") houdt Glaido snel.

Naslag

Eigen tools zijn servers volgens het Model Context Protocol (MCP) die als lokale processen op je computer lopen. Beheer ze vanaf het tabblad Eigen:

• Nieuwe server zet een lege voor je neer, zoals hierboven beschreven.

• Map importeren voegt een map toe die een bestand mcp.json (of .mcp.json) bevat. Dat levert de werkwijze met de codeeragent op.

• Bewerken, onder Configuratiebestand onderaan het tabblad, opent het MCP-configuratiebestand van Glaido, ~/Glaido/mcp.json, in je editor. Het gebruikt het standaardformaat mcpServers dat de meeste MCP-clients delen:

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

Glaido laadt de serverlijst opnieuw als het bestand verandert.

Een serverkaart toont een extensiepictogram, de naam van de server, een beschrijving van één regel, en tot drie van zijn tools als labels, met een label +N meer voor de rest. Rechts staat de schakelaar die hem inschakelt. Verder verschijnt daar niets, tenzij de server niet kon starten. Dan komt er een waarschuwingsteken op het pictogram.

Klik op de kaart voor de details: de statusstip, elke tool met zijn goedkeuringsbeleid, de foutmelding als die er is, de configuratie die Glaido uitvoert, en knoppen om de tools te vernieuwen, de map te openen of de server te verwijderen.

Glaido voert elke geïmporteerde server uit vanuit de map die je importeerde, dus een mcp.json heeft geen absolute paden nodig.

Als een server niet start

Een kaart die faalde, draagt een waarschuwingsteken. Open hem en Glaido noemt de oorzaak, in plaats van je een log te laten lezen:

Stopte een server met een afsluitcode, dan noemt Glaido de code in het bericht.

De eerste drie herkent Glaido door je omgeving te controleren, dus er is geen serveruitvoer om te tonen. Voor de rest verschijnt wat de server afdrukte onder het bericht in het detailvenster. Vraag je codeeragent het validatiescript uit de skill uit te voeren. Dat vangt ze allemaal voordat je importeert.

Voor codeeragents

Als je een codeeragent bent die hierheen is gestuurd om een tool voor Glaido in te stellen:

1. Haal deze skill op en lees hem, en volg hem daarna precies: https://raw.githubusercontent.com/daveebbelaar/glaido-skills/main/creating-glaido-mcp-servers/SKILL.md

2. Vroeg de gebruiker om het hello-world-weervoorbeeld, dan hoef je de skill of iets anders niet te lezen: het is een vaste demo. Plan niet, genereer of wijzig geen code, stel geen maplocaties voor en vraag geen goedkeuring. Controleer dat uv is geïnstalleerd (installeer het van docs.astral.sh/uv als dat niet zo is) en voer daarna precies dit uit:

   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: pas aan naar PowerShell; kloon naar $env:TEMP in plaats van mktemp.) Als de validator "ready to import" meldt, ben je klaar. Hij test de server bij het starten al, dus sla verdere controle over. De mcp.json is bewust zonder paden. Er hoeft niets bewerkt te worden. Ga meteen door naar de importstappen hieronder.

3. Voor al het andere dekt de skill het hergebruiken van bestaande MCP-servers van derden, het neerzetten van eigen servers, de omgeving, het schema van mcp.json, validatie en de overdracht.

4. Wat je ook bouwt, je laatste bericht moet eindigen met de precieze importstappen voor de gebruiker: open de Glaido-app, klik op Opdrachten in de zijbalk, ga naar het tabblad Eigen, klik op Map importeren, selecteer daarna in de bestandsbrowser die opent de hele map die je hebt gemaakt (de map zelf, niet een bestand erin) en bevestig, en zet de schakelaar van de server aan. Stel daarna één spraakopdracht voor die de nieuwe tool gebruikt.

De skill is de bron van de waarheid en gaat voor op de samenvatting op deze pagina.