Agendan automatisointi

Automatisoimalla Agendaa voit luoda tehokkaita työnkulkuja. Sen voi tehdä sekä korkealla tasolla esimerkiksi Siri-pikakomennoilla tai Pikakomennot-apilla että matalalla tasolla esimerkiksi x-callback-url-tuen avulla. Mahdollisuudet ovat rajattomat!

Apin pikakomennot

Agenda 15:stä alkaen apin pikakomennoilla voit hoitaa nopeasti yhden tai useamman tehtävän Agendassa Pikakomennot-apin kautta. Yhdistelemällä useita Agendan pikakomentoja, halutessasi myös muiden appien pikakomentoihin, voit luoda ja automatisoida työnkulkujasi. Mahdollisuudet ulottuvat tietyn muistiinpanon avaamisesta iPadin Koti-valikosta ja uuden muistiinpanon luomisesta puhelimen takakannen kaksoisnapautuksella monimutkaisiin työnkulkuihin, jotka keräävät kaikki tämän päivän tehtäväsi eri apeista ja luovat uuden projektin yhdellä napautuksella.

iOS:n Agenda tukee myös Siri-pikakomentoja yleisiin toimintoihin, kuten tietyn muistiinpanon, projektin tai yleiskatsauksen avaamiseen.

Muistiinpanojen haku Pikakomennoissa

Pikakomennot-apin Etsi muistiinpanoja -toiminnolla voit etsiä muistiinpanoja, jotka täyttävät tietyt ehdot. Tämä on käytettävissä myös x-callback-url-osoitteen kautta. Hakukyselyt tukevat toimintosyntaksia, kuten \color, \done, \pinned ja muita, joten automaatioissasi on käytössä sama teho kuin apin sisäisessä haussa.

Siri

Voit hakea muistiinpanojasi ja käyttää Agendaa Sirin avulla. Pyydä esimerkiksi Siriä hakemaan jotain Agendasta, niin voit esikatsella tuloksia suoraan. Siri tukee myös monipuolisempaa tietojen vaihtoa Agendan ja muiden appien välillä.

Ohjauskeskus

iOS:ssä Agenda tarjoaa Ohjauskeskuksen painikkeita, joilla voit siirtyä nopeasti Tänään- tai Agendalla-yleiskatsaukseen avaamatta ensin appia. Voit lisätä nämä painikkeet laitteesi Ohjauskeskuksen asetuksissa.

x-callback-url-tuki

Agenda tukee myös x-callback-url-osoitteita. Niiden avulla voit liittää yhteen eri appien työnkulkuja ja/tai automatisoida tiettyjä toimintoja Agendassa. Myös Applen Pikakomennot-appi tukee niitä.

Lyhyt johdatus x-callback-url-osoitteisiin:

• URL-skeema on agenda tai agenda-notes
• Komentoja ovat tällä hetkellä esimerkiksi on-the-agenda, today, open-project jne.
• Komennoissa ”open-project” ja ”open-note” voit määrittää kohteen title-parametrilla.
• Tavalliseen tapaan voit antaa takaisinkutsu-URL-osoitteet valinnaisilla x-success- ja x-error-parametreilla.

Jos haluat esimerkiksi avata Agendassa muistiinpanon nimeltä ”Meeting With Peta”, voit käyttää tätä URL-osoitetta: agenda://x-callback-url/open-note?title=Meeting%20With%20Peta

Uutta Agenda 23:ssa: move-note-toiminnolla voit siirtää muistiinpanon projektista toiseen toisesta apista tai pikakomennosta: agenda://x-callback-url/move-note?title=Meeting%20With%20Peta&project-title=Archive

MCP-integraatio (Model Context Protocol)

macOS:n Agendassa on sisäänrakennettu MCP-palvelin, jonka avulla tekoälyavustajat voivat käsitellä muistiinpanojasi, projektejasi ja kategorioitasi. MCP on avoin protokolla, jota esimerkiksi Claude Code, Claude Desktop, Cursor ja Codex käyttävät viestiessään appien kanssa.

MCP-palvelimen ottaminen käyttöön

MCP-palvelin on oletuksena pois päältä. Ota se käyttöön valitsemalla Agenda-valikosta Integraatiot > Ota MCP käyttöön. Palvelin toimii paikallisesti Macissasi osoitteessa http://127.0.0.1:16106/mcp, ja siihen pääsee vain omalta koneeltasi.

Integraatiot-valikossa on myös vaihtoehtoja, joilla voit kopioida määrityskomennot eri tekoälytyökalujen yhdistämiseen, sekä Claude Desktop -laajennus, jonka voi ladata ja asentaa suoraan.

Käytettävissä olevat työkalut

MCP-palvelin tarjoaa tekoälyavustajien käyttöön seuraavat työkalut:

Etsi ja lue

• search_notes – Hakee muistiinpanojasi tekstin, tunnisteiden, päivämäärien ja muiden ehtojen mukaan
• get_note – Noutaa tietyn muistiinpanon koko sisällön
• get_selection – Hakee muistiinpanon tai projektin, jonka olet valinnut Agendassa, joten voit sanoa ”tämä muistiinpano”
• list_projects – Luettelee kaikki projektit, halutessasi myös arkistoidut
• list_categories – Luettelee kaikki kategoriat
• list_templates – Luettelee muistiinpanopohjasi, jotta muistiinpanon voi luoda pohjasta
• list_overviews – Luettelee tallennetut yleiskatsauksesi
• list_attachments – Luettelee muistiinpanon tiedostot ja piirrokset (uutta Agenda 23.4:ssä)
• get_attachment – Hakee liitteen alkuperäisen tiedoston (uutta Agenda 23.4:ssä)

Näytä Agendassa

• open_note – Avaa tietyn muistiinpanon Agendassa
• open – Tuo Agendan etualalle ja siirtyy Tänään- tai Agendalla-näkymään, hakuun, projektiin tai tallennettuun yleiskatsaukseen

Luo ja muuta

• create_note – Luo projektiin uuden muistiinpanon, valinnaisesti tiedostoliitteineen
• append_to_note – Lisää sisältöä ja/tai tiedostoliitteitä olemassa olevaan muistiinpanoon
• edit_note – Muokkaa olemassa olevan muistiinpanon sisältöä, valinnaisesti tiedostoliitteineen
• move_note – Siirtää olemassa olevan muistiinpanon toiseen projektiin
• trash_note – Siirtää muistiinpanon roskakoriin
• untrash_note – Palauttaa muistiinpanon roskakorista
• create_project – Luo uuden projektin
• update_project – Nimeää projektin uudelleen, siirtää sen toiseen kategoriaan, muuttaa sen lajittelujärjestystä, arkistoi sen tai siirtää sen roskakoriin ja takaisin
• create_category – Luo uuden kategorian
• update_category – Nimeää kategorian uudelleen, muuttaa sen väriä, sijoittaa sen toisen kategorian alle tai siirtää sen takaisin ylimmälle tasolle

Vie

• export_pdf – Tallentaa muistiinpanot tai koko projektin yhdeksi PDF-tiedostoksi

MCP:n kautta mitään ei voi poistaa pysyvästi. Muistiinpano tai projekti, jonka avustaja siirtää roskakoriin, pysyy siellä, kunnes tyhjennät roskakorin, eikä kategorioita voi poistaa lainkaan.

Tekoälytyökalujen yhdistäminen

Yhdistä tekoälytyökalu Agendan MCP-palvelimeen Integraatiot-valikon määrityskomennolla tai tee määritys käsin:

Claude Code:

claude mcp add --transport http agenda http://localhost:16106/mcp

Claude Desktop / Cursor: Käytä MCP-määrityksessäsi komentona npx mcp-remote http://localhost:16106/mcp. Vaihtoehtoisesti voit asentaa Claude Desktop -laajennuksen suoraan Integraatiot-valikosta.

Codex: Lisää seuraava tiedostoon ~/.codex/config.toml:

[mcp_servers.agenda]
url = "http://127.0.0.1:16106/mcp"

Liitteet

Työkalut create_note, append_to_note ja edit_note tukevat tiedostoliitteiden lisäämistä muistiinpanoihin. Liitteet lähetetään base64-koodattuina tietoina, joten tekoälyavustaja voi lukea tiedoston Macistasi, koodata sen ja liittää sen muistiinpanoon yhdellä kertaa. Voit esimerkiksi pyytää tekoälyavustajaa ”liittämään tämän PDF:n Palaverimuistiinpanoihini”, ja se hoitaa loput.

Jokainen liite vaatii kentän filename (tiedostopäätteen kanssa, jotta Agenda tietää tiedostotyypin) ja base64-koodatun tiedostosisällön data. Voit halutessasi määrittää liitteen näyttötavan kentillä displayStyle (inline, thumbnail, thumbnail-with-details tai full-width) ja displaySize (small, medium tai large).

Rajoitukset: enintään 20 liitettä pyyntöä kohden ja tiedostojen yhteiskoko enintään 100 Mt.

Tiedostojen ottaminen muistiinpanosta (uutta Agenda 23.4:ssä)

Avustaja voi myös ottaa tiedoston takaisin muistiinpanosta, esimerkiksi lukeakseen liittämäsi PDF:n tai ladatakseen sen muualle. list_attachments-työkalu luettelee muistiinpanon tiedostot ja piirrokset. get_attachment-työkalu tekee sitten alkuperäisestä tiedostosta vain luku -kopion Agendassa näkyvällä nimellä ja kertoo avustajalle sen sijainnin. Kopio on väliaikainen: Agenda poistaa sen, kun se seuraavan kerran käynnistyy.

Jos tekoälytyökalusi ei pysty lukemaan tiedostoja Agendan kansiosta, se voi sen sijaan pyytää tiedoston sisältöä suoraan (enintään 100 Mt, vain tiedostot). Kansio tai paketti annetaan kansiona, ja piirros annetaan esikatselukuvanaan. Lukittujen muistiinpanojen liitteet eivät ole käytettävissä.

Ohjeresurssit

MCP-palvelin tarjoaa myös ohjeresursseja, jotka kattavat Agendan dokumentaation yleisiä aiheita, joten tekoälyavustajat voivat tarkistaa, miten ominaisuudet toimivat, ja vastata Agendaa koskeviin kysymyksiin paremmin.

Mitä voit pyytää

Kun tekoälytyökalusi on yhdistetty, se voi pyynnöstä lukea ja muokata muistiinpanojasi. Esimerkkejä hyvin toimivista pyynnöistä:

• ”Tee tämän viikon palaverimuistiinpanoistani yhteenveto uudeksi muistiinpanoksi Viikkokatsaukset-projektiin.”
• ”Etsi kaikki, joissa on tunniste #followup ja jotka mainitsevat Annan, ja luettele ne.”
• ”Lisää tämän PDF:n toimenpiteet Projektin käynnistys -muistiinpanoni loppuun.” (tekoäly voi myös liittää tiedostoja)
• ”Siirrä muistiinpano ’Q2-suunnittelu’ Luonnokset-projektista Strategia-projektiin.”
• ”Luo uusi projekti nimeltä Loma ja lisää siihen pakkauslista.”
• ”Ota laskun PDF muistiinpanostani ’Maaliskuun laskutus’ ja kerro loppusumma.”

Koska MCP-palvelin toimii paikallisesti Macissasi, muistiinpanosi eivät koskaan poistu koneeltasi matkalla tekoälytyökaluun – sen kautta lähetetään vain se teksti, jonka avustaja lukee tai kirjoittaa.

Vianmääritys

Jos tekoälytyökalusi ei näe Agendaa:

• Onko MCP käytössä? Tarkista Agenda > Integraatiot > Ota MCP käyttöön. Valikkokohdaksi vaihtuu Poista MCP käytöstä, kun palvelin on käynnissä.
• Onko Agenda käynnissä? Palvelin toimii Agenda-apin sisällä – jos Agenda lopetetaan, myös palvelin pysähtyy.
• Yhdistikö tekoälytyökalu uudelleen MCP:n käyttöönoton jälkeen? Jotkin asiakasohjelmat tallentavat yhteyden välimuistiin käynnistyessään. Käynnistä tekoälytyökalu uudelleen, jos se oli käynnissä ennen kuin otit MCP:n käyttöön.
• Käyttääkö jokin muu porttia 16106? Nopea testi Päätteessä: curl http://127.0.0.1:16106/mcp palauttaa vastauksen (eikä ”connection refused”).

Huomaa: MCP-palvelin on käytettävissä vain macOS:ssä.